CKTIS / JavaScript
Normalização dos fins de linha em HTMLTextAreaElement.value
A leitura de `HTMLTextAreaElement.value` devolve texto com fins de linha LF, mesmo que a cadeia atribuída contenha pares CRLF ou caracteres CR isolados.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
textarea.value = text;
const normalized = textarea.value;A propriedade value de uma instância de HTMLTextAreaElement permite ler e escrever o texto atual. A atribuição define o valor bruto do controlo; a leitura devolve o valor normalizado da API. Cada par CRLF (\r\n) e cada CR isolado (\r) passam a ser um único LF (\n). Os LF existentes mantêm-se inalterados.
Esta é uma regra do DOM do HTML, não uma regra geral das cadeias de caracteres do ECMAScript. A atribuição não altera a cadeia original, mas ao ler value já não é possível saber quais os LF que eram pares CRLF ou CR isolados. Guarda o original em separado se essas diferenças forem importantes. defaultValue reflete o texto predefinido do elemento, não o texto atual após a edição.
A quebra visual de linhas não acrescenta caracteres a value. Ao submeter um formulário, wrap="hard" com cols definido pode acrescentar quebras de linha ao valor submetido. A codificação multipart/form-data serializa como CRLF os fins de linha no valor de um campo de texto; isso não altera o que a leitura de value devolve.
Exemplos
<!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>Resultado
"A\r\nB\rC\nD" "A\nB\nC\nD"
Guarda o exemplo como ficheiro `.html`, abre-o num navegador e verifica o resultado na consola do navegador. `JSON.stringify` torna visíveis os fins de linha através de sequências de escape: a primeira linha mostra a cadeia original e a segunda mostra o resultado da leitura de `value`. Não é necessário inserir o elemento no documento.
Lições relacionadas
- JavaScript · Lição 9 · Avançado · Versão: 4