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

CKTIS / JavaScript

HTMLTextAreaElement.value — texto atual do campo

`HTMLTextAreaElement.value` permite ler ou definir o texto atual de um elemento `textarea`. Atribuir um valor a `value` não altera `defaultValue`, mas alterar `defaultValue` pode mudar o texto devolvido por `value` enquanto a marca interna de valor alterado não estiver ativa.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

textarea.value
textarea.value = text

HTMLTextAreaElement.value é uma propriedade da Web API do tipo cadeia de caracteres, não faz parte do próprio ECMAScript. Lê o texto atual de textarea; uma atribuição substitui esse texto. A leitura normaliza as terminações de linha para LF (\n).

defaultValue representa o texto predefinido. Atribuir um valor a value não o altera e define a marca interna de valor alterado. Repor o formulário restaura o texto predefinido.

Atribuir um valor a value não dispara, por si só, o evento input. O exemplo requer um DOM de navegador; a mera presença do Node 24 não comprova o suporte desta API.

Exemplos

const textarea = document.createElement('textarea');
textarea.defaultValue = 'Start';
textarea.value = 'A\r\nB';
console.log(JSON.stringify(textarea.value));
console.log(textarea.defaultValue);

Resultado

"A\nB"
Start

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