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 disabledHTMLInputElement 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
- HTML Living Standard — The input element
- HTML Living Standard — The textarea element
- HTML Living Standard — Enabling and disabling form controls: the disabled attribute
- HTML Living Standard — Constructing the entry list
- HTML Living Standard — Common event behaviors
- MDN — FormData: FormData() constructor
- MDN — disabled HTML attribute