Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Normalizacja końców wierszy w HTMLTextAreaElement.value

Odczyt `HTMLTextAreaElement.value` zwraca tekst z końcami wierszy zapisanymi jako LF, nawet jeśli przypisany ciąg zawierał pary CRLF lub samotne znaki CR.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

textarea.value = text;
const normalized = textarea.value;

Właściwość value instancji HTMLTextAreaElement służy do zapisu i odczytu bieżącego tekstu. Przypisanie ustawia surową wartość kontrolki, a odczyt zwraca znormalizowaną wartość API: każda para CRLF (\r\n) i każdy samotny CR (\r) stają się jednym LF (\n). Istniejące LF pozostają bez zmian.

To reguła interfejsu HTML DOM, a nie ogólna cecha ciągów znaków w ECMAScript. Przypisanie nie zmienia oryginalnego ciągu, ale po odczycie value nie da się rozpoznać, które LF były wcześniej parami CRLF lub samotnymi CR. Zachowaj oryginał osobno, jeśli te różnice są istotne. defaultValue odzwierciedla tekst domyślny elementu, a nie bieżący tekst po edycji.

Wizualne zawijanie wierszy nie dodaje znaków do value. Przy wysyłaniu formularza wrap="hard" z ustawionym cols może dodać podziały wierszy do wysyłanej wartości. Kodowanie multipart/form-data zapisuje końce wierszy w tekstowej wartości pola jako CRLF; nie zmienia to wyniku odczytu value.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>Textarea newline normalization</title>
<script>
  const textarea = document.createElement("textarea");
  const original = "A\r\nB\rC\nD";
  textarea.value = original;
  console.log(JSON.stringify(original));
  console.log(JSON.stringify(textarea.value));
</script>

Wynik

"A\r\nB\rC\nD"
"A\nB\nC\nD"

Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź wynik w konsoli. `JSON.stringify` pokazuje końce wierszy jako sekwencje ucieczki: pierwszy wiersz przedstawia oryginał, a drugi wynik odczytu `value`. Nie trzeba wstawiać elementu do dokumentu.

Powiązane lekcje

  • JavaScript · Lekcja 9 · Zaawansowany · Wersja: 4

Źródła