CKTIS / HTML
wrap — zalamování textarea při odeslání
Atribut wrap prvku textarea určuje, zda prohlížeč přidá do hodnoty odesílané s formulářem zalomení řádků. Rozlišuje viditelné zalamování textu od skutečných znaků nového řádku.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<textarea wrap="soft">…</textarea>
<textarea wrap="hard" cols="20">…</textarea>wrap je výčtový atribut prvku textarea, nikoli logický atribut. Jeho klíčová slova jsou soft a hard. Pokud atribut chybí nebo má neplatnou hodnotu, zvolí se stav soft.
Při hodnotě soft může prohlížeč text vizuálně zalamovat, aniž by kvůli tomuto zalamování přidával zalomení řádků do odesílané hodnoty. Zalomení řádků zadaná uživatelem zůstávají součástí textu. Při hodnotě hard prohlížeč vloží do odesílané hodnoty znaky LF (U+000A), aby řádky nepřesahovaly šířku ve znacích určenou atributem cols. V tomto stavu je nutné zadat cols jako kladné celé číslo.
Přesný algoritmus zalamování závisí na implementaci: nepředpokládejte, že místa zalomení jsou ve všech prohlížečích stejná. Další zalomení vytvořená při hard se nevkládají do vlastnosti .value, která zpřístupňuje hodnotu API se zalomeními řádků normalizovanými na LF.
Příklad mění wrap prostřednictvím vlastnosti DOM a ukazuje, že .value zůstává beze změny. Netestuje místa zalomení v odesílaných datech formuláře.
Příklady
<!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>Výsledek
{"wrap":"hard","unchanged":true,"value":"alpha beta gamma"}Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.