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

CKTIS / JavaScript

`value` e `disabled` nos elementos `input` e `textarea`

Lê e altera o valor de um controlo, quer o utilizador possa interagir com ele ou não. Distingue o atributo `disabled` do próprio elemento do estado efetivo e percebe que valores entram nos dados do formulário.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

control.value          // read a string
control.value = text   // write a string; input.type determines the rules
control.disabled       // read the element's own disabled attribute as a boolean
control.disabled = true
control.disabled = false
control.matches(':disabled') // test whether the control is actually disabled

HTMLInputElement e HTMLTextAreaElement são interfaces do DOM definidas pela norma HTML, não por ECMAScript 2024. Nos campos de texto e em textarea, value lê e escreve a cadeia de caracteres atual. Em textarea, value normaliza as quebras de linha para LF (\n). O valor predefinido (defaultValue) vem do atributo value de input ou do conteúdo textual de textarea. Após uma edição pelo utilizador ou uma atribuição a value, alterar o valor predefinido já não substitui o valor atual. Ao repor o formulário, o valor atual é definido a partir do valor predefinido. Em input, o navegador também aplica o algoritmo de sanitização do valor, se o tipo o definir. Por exemplo, para type="text", a reposição remove as quebras de linha de value, mesmo que estejam presentes em defaultValue.

Em input, type determina como funciona value. No modo de valor, como em text e number, o navegador pode transformar ou esvaziar a cadeia atribuída segundo as regras do tipo; number continua a devolver uma cadeia de caracteres. Em hidden, value reflete o atributo value e devolve '' se estiver ausente. Em checkbox e radio também reflete o atributo, mas devolve 'on' se faltar; usa checked para consultar o estado de seleção. Em file, value não revela o caminho real: usa files. Atribuir '' limpa a seleção; uma cadeia não vazia lança InvalidStateError.

A propriedade booleana disabled reflete apenas o atributo do próprio elemento: true adiciona-o e false remove-o. Em HTML, até disabled="false" desativa o controlo, pois basta o atributo estar presente. Um controlo com disabled === false pode estar desativado por um fieldset ascendente desativado, exceto se estiver dentro do primeiro filho legend desse grupo. Testa o estado efetivo com control.matches(':disabled').

Um controlo desativado não pode receber o foco nem ser editado pelo utilizador. Fica excluído da validação das restrições e é omitido tanto no envio do formulário como em new FormData(form). Os scripts ainda podem ler e escrever value; a atribuição, por si só, não dispara input nem change. Onde houver suporte, usa readOnly para permitir o foco sem permitir a edição; só por si, não exclui o campo do envio. Nenhum destes estados substitui a validação ou a autorização no servidor.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form control value and disabled state</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement('form');
  const group = document.createElement('fieldset');
  const input = document.createElement('input');
  const textarea = document.createElement('textarea');
  input.type = 'text';
  input.name = 'title';
  textarea.name = 'note';
  group.append(input);
  form.append(group, textarea);

  group.disabled = true;
  input.value = 'Draft';
  textarea.value = 'Line 1\r\nLine 2';
  console.log(JSON.stringify([input.value, input.disabled, input.matches(':disabled')]));
  console.log(JSON.stringify([...new FormData(form)]));

  group.disabled = false;
  textarea.disabled = true;
  console.log(JSON.stringify([...new FormData(form)]));
})();
</script>
</body>
</html>

Resultado

["Draft",false,true]
[["note","Line 1\nLine 2"]]
[["title","Draft"]]

Guarda o exemplo como ficheiro HTML, abre-o num navegador e consulta a consola do navegador. A primeira linha mostra que é possível atribuir `Draft` mesmo quando o campo está efetivamente desativado e o seu `disabled` é `false`. As duas linhas seguintes mostram os dados antes e depois da mudança de estado; no JSON, `\n` representa a quebra de linha LF.

Lições relacionadas

  • JavaScript · Lição 4 · Avançado · Versão: 4

Fontes