CKTIS / JavaScript
Normalizzazione delle terminazioni di riga in HTMLTextAreaElement.value
La lettura di `HTMLTextAreaElement.value` restituisce testo con terminazioni di riga LF, anche se la stringa assegnata conteneva coppie CRLF o caratteri CR isolati.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
textarea.value = text;
const normalized = textarea.value;La proprietà value di un’istanza di HTMLTextAreaElement permette di leggere e scrivere il testo corrente. L’assegnazione imposta il valore grezzo del controllo; la lettura restituisce il valore normalizzato dell’API. Ogni coppia CRLF (\r\n) e ogni CR isolato (\r) diventano un singolo LF (\n). Gli LF già presenti rimangono invariati.
È una regola del DOM HTML, non una regola generale delle stringhe ECMAScript. L’assegnazione non modifica la stringa originale, ma leggendo value non puoi sapere quali LF fossero in origine coppie CRLF o CR isolati. Conserva l’originale separatamente se queste differenze contano. defaultValue rispecchia il testo predefinito dell’elemento, non quello corrente dopo la modifica.
Il ritorno a capo visivo non aggiunge caratteri a value. Quando si invia un modulo, wrap="hard" con cols impostato può aggiungere interruzioni di riga al valore inviato. La codifica multipart/form-data serializza come CRLF le terminazioni di riga nel valore di un campo di testo; questo non cambia ciò che si ottiene leggendo value.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>Textarea newline normalization</title>
<script>
const textarea = document.createElement("textarea");
const original = "A\r\nB\rC\nD";
textarea.value = original;
console.log(JSON.stringify(original));
console.log(JSON.stringify(textarea.value));
</script>Risultato
"A\r\nB\rC\nD" "A\nB\nC\nD"
Salva l’esempio come file `.html`, aprilo in un browser e controlla l’output nella console del browser. `JSON.stringify` mostra le terminazioni di riga come sequenze di escape: la prima riga mostra la stringa originale e la seconda il risultato della lettura di `value`. Non serve inserire l’elemento nel documento.
Lezioni correlate
- JavaScript · Lezione 9 · Avanzato · Versione: 4