Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti