CKTIS / HTML
wrap — ritorno a capo di textarea all’invio
L’attributo wrap di textarea determina se il browser aggiunge interruzioni di riga al valore inviato con un modulo. Distingue il ritorno a capo visibile dai caratteri di nuova riga effettivi.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<textarea wrap="soft">…</textarea>
<textarea wrap="hard" cols="20">…</textarea>wrap è un attributo enumerato di textarea, non un attributo booleano. Le parole chiave sono soft e hard. Se l’attributo è omesso o il suo valore non è valido, viene selezionato lo stato soft.
Con soft, il browser può mandare a capo il testo visivamente senza aggiungere al valore inviato interruzioni di riga dovute a tale visualizzazione. Le interruzioni inserite dall’utente restano parte del testo. Con hard, il browser inserisce caratteri LF (U+000A) nel valore inviato, in modo che le righe non superino la larghezza in caratteri indicata da cols. In questo stato, cols deve essere specificato come intero positivo.
L’algoritmo esatto di a capo dipende dall’implementazione: non dare per scontato che i punti di interruzione siano identici in tutti i browser. Le interruzioni aggiuntive prodotte da hard non vengono inserite nella proprietà .value, che espone il valore dell’API con le interruzioni di riga normalizzate a LF.
L’esempio modifica wrap tramite la relativa proprietà DOM e mostra che .value resta invariata. Non verifica i punti di interruzione nei dati del modulo inviati.
Esempi
<!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>Risultato
{"wrap":"hard","unchanged":true,"value":"alpha beta gamma"}Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.