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

CKTIS / JavaScript

HTMLInputElement.value — ler e definir o valor de um campo

HTMLInputElement.value permite ler ou definir um valor como cadeia de caracteres. O comportamento depende de type; num campo de texto, o valor atual pode ser diferente do valor predefinido.

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

input.value
input.value = "new value";

HTMLInputElement.value é uma propriedade da Web API, não do próprio ECMAScript. Devolve uma cadeia de caracteres, mesmo com type="number"; para ler um número, utilize valueAsNumber. Requer um ambiente DOM de navegador; o Node.js, por si só, não é suficiente.

Num campo de texto, .value representa o valor atual. defaultValue reflete o atributo HTML value. Atribuir um valor a .value ativa uma indicação interna de valor alterado: as alterações posteriores ao atributo deixam de atualizar o valor atual até essa indicação ser reposta, por exemplo, ao repor o formulário. A atribuição não ativa automaticamente os eventos input ou change.

O navegador aplica regras de limpeza específicas de cada type: um valor numérico inválido pode passar a "". Nas caixas de verificação e nos botões de opção, .value indica o valor enviado, que por predefinição é "on", e não se o controlo está selecionado — para isso, leia checked.

Para type="file", utilize files para aceder aos ficheiros. .value não revela o caminho real; atribuir uma cadeia não vazia lança InvalidStateError, enquanto "" limpa a seleção.

Exemplos

const input = document.createElement("input");
input.type = "text";
input.defaultValue = "Ada";
input.value = "Lin";
console.log(JSON.stringify({
  value: input.value,
  defaultValue: input.defaultValue,
  attribute: input.getAttribute("value")
}));

Resultado

{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}

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