Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes