CKTIS / JavaScript
Controlos de formulário desativados
Os controlos de formulário desativados não podem ser utilizados nem receber o foco do utilizador, e os seus valores não são enviados. Em JavaScript, a propriedade `disabled` altera o estado de desativação próprio do controlo, embora um `fieldset` que o contenha também o possa desativar.
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
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Os controlos de formulário desativados são controlos de formulário que foram desativados. Os utilizadores não os podem editar nem ativar através de um clique; não podem receber o foco e não participam na validação de restrições. Os seus valores são omitidos quando o formulário é enviado. Este é um mecanismo de HTML e do DOM do navegador, não uma funcionalidade de uma edição específica do ECMAScript. A MDN indica que HTMLInputElement.disabled está amplamente disponível nos navegadores desde julho de 2015; a presença do Node 24 não comprova o suporte do DOM.
A propriedade input.disabled é um valor booleano que reflete o atributo disabled próprio do elemento. Atribuir-lhe true adiciona esse atributo, e atribuir-lhe false remove-o. O atributo é booleano: até disabled="false" significa desativado, porque o que importa é a presença do atributo, não o seu valor textual.
Um fieldset desativado também desativa os controlos descendentes, exceto os que se encontram dentro do primeiro elemento legend que é filho direto desse fieldset. O simples facto de um controlo se encontrar no legend de um fieldset aninhado não impede que o fieldset exterior o desative. Por isso, input.disabled pode ser false enquanto um elemento antecessor continua a desativar o controlo; utilize input.matches(':disabled') para verificar o estado efetivo. Atribuir apenas input.disabled = false não anula a desativação imposta por um fieldset.
Não confunda disabled com readonly: os campos só de leitura compatíveis podem continuar a receber o foco e a incluir os seus valores no envio do formulário. readonly aplica-se aos tipos textuais de input e a textarea, mas não, por exemplo, a select ou button. O exemplo demonstra como alternar disabled e a consequente omissão do campo em FormData.
Exemplos
const form = document.createElement('form');
const input = document.createElement('input');
input.name = 'topic';
input.value = 'JavaScript';
form.append(input);
input.disabled = true;
console.log(input.disabled);
console.log(new FormData(form).has('topic'));
input.disabled = false;
console.log(new FormData(form).get('topic'));Resultado
true false JavaScript
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.