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

CKTIS / HTML

textarea — campo de texto multilinha

O elemento textarea permite editar texto simples em várias linhas. Saiba em que diferem o valor inicial e o atual, como associar-lhe uma etiqueta e qual o seu papel num formulário.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<textarea id="message" name="message" rows="4" cols="40">Initial text</textarea>

textarea é um controlo para editar texto simples em várias linhas, não um editor HTML. Requer uma etiqueta de fecho. O texto entre as etiquetas fornece o valor predefinido; um atributo value não define esse valor predefinido.

Em JavaScript, a propriedade value lê ou altera o valor atual, enquanto defaultValue corresponde ao texto predefinido. Ao repor o formulário, o valor predefinido é restaurado. O exemplo demonstra esta diferença sem interação do utilizador.

Associe um label ao campo através de valores correspondentes para for e id; placeholder não substitui uma etiqueta. name identifica o campo no envio do formulário. rows e cols especificam as dimensões do controlo, não um limite para o comprimento do texto.

required exige um valor não vazio num controlo editável. readonly impede a edição, mas não exclui o valor do envio; disabled impede a interação e exclui o valor do envio. Ambos excluem o controlo da validação de restrições.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Textarea example</title>
<form id="form">
  <label for="message">Message</label>
  <textarea id="message" name="message" rows="3" cols="30" required>Hello</textarea>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('form');
  const message = document.getElementById('message');
  const lines = [];
  lines.push(message.value);
  message.value = 'Updated';
  lines.push(message.value);
  lines.push(message.defaultValue);
  form.reset();
  lines.push(message.value);
  document.getElementById('result').textContent = lines.join('\n');
</script>
</html>

Resultado

Hello
Updated
Hello
Hello

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