CKTIS / HTML
wrap — quebra de linha de textarea no envio
O atributo wrap de textarea determina se o navegador acrescenta quebras de linha ao valor enviado com um formulário. Distingue a quebra de linha visível dos caracteres de nova linha efetivos.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<textarea wrap="soft">…</textarea>
<textarea wrap="hard" cols="20">…</textarea>wrap é um atributo enumerado de textarea, não um atributo booleano. As palavras-chave são soft e hard. Se o atributo for omitido ou tiver um valor inválido, é selecionado o estado soft.
Com soft, o navegador pode apresentar o texto com quebras visuais sem acrescentar quebras de linha ao valor enviado por causa dessa apresentação. As quebras de linha introduzidas pelo utilizador continuam a fazer parte do texto. Com hard, o navegador insere caracteres LF (U+000A) no valor enviado, para que as linhas não excedam a largura em caracteres indicada por cols. Neste estado, cols tem de ser indicado como um número inteiro positivo.
O algoritmo exato de quebra depende da implementação: não pressuponha que os pontos de quebra são iguais em todos os navegadores. As quebras adicionais produzidas por hard não são inseridas na propriedade .value, que expõe o valor da API com as quebras de linha normalizadas para LF.
O exemplo altera wrap através da respetiva propriedade DOM e mostra que .value não se altera. Não testa os pontos de quebra nos dados do formulário enviados.
Exemplos
<!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>Resultado
{"wrap":"hard","unchanged":true,"value":"alpha beta gamma"}O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.