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.