Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

wrap — zawijanie tekstu textarea przy wysyłaniu

Atrybut wrap elementu textarea określa, czy przeglądarka dodaje podziały wierszy do wartości wysyłanej z formularzem. Rozróżnia zawijanie widoczne na ekranie od rzeczywistych znaków nowego wiersza.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<textarea wrap="soft">…</textarea>
<textarea wrap="hard" cols="20">…</textarea>

wrap to atrybut wyliczeniowy elementu textarea, a nie atrybut logiczny. Obsługuje słowa kluczowe soft i hard. Brak atrybutu lub nieprawidłowa wartość wybiera stan soft.

Przy soft przeglądarka może wizualnie zawijać tekst, ale nie dodaje z tego powodu podziałów wierszy do wysyłanej wartości. Podziały wpisane przez użytkownika pozostają częścią tekstu. Przy hard przeglądarka dodaje znaki LF (U+000A) do wartości używanej przy wysyłaniu, aby długość wierszy nie przekraczała szerokości znakowej określonej przez cols. W tym stanie trzeba podać cols jako dodatnią liczbę całkowitą.

Dokładny algorytm podziału jest zależny od implementacji: nie zakładaj identycznych miejsc łamania we wszystkich przeglądarkach. Dodatkowe podziały wynikające z hard nie są dopisywane do właściwości .value, która udostępnia wartość API z podziałami wierszy znormalizowanymi do LF.

Przykład zmienia wrap przez właściwość DOM i pokazuje, że .value pozostaje bez zmian. Nie sprawdza miejsc łamania tekstu w danych formularza.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>wrap</title>
<label for="note">Text</label>
<textarea id="note" wrap="soft" cols="5">alpha beta gamma</textarea>
<pre id="result"></pre>
<script>
  const note = document.getElementById("note");
  const result = document.getElementById("result");
  const before = note.value;
  note.wrap = "hard";
  result.textContent = JSON.stringify({
    wrap: note.wrap,
    unchanged: note.value === before,
    value: note.value
  });
</script>

Wynik

{"wrap":"hard","unchanged":true,"value":"alpha beta gamma"}

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła