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.