CKTIS / JavaScript
HTMLButtonElement.disabled — desativar um botão
HTMLButtonElement.disabled é uma propriedade booleana que reflete a presença do atributo disabled de um botão. Permite desativar um botão ou remover o seu próprio atributo disabled, mas não descreve todos os motivos pelos quais o controlo pode estar desativado.
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
button.disabled; button.disabled = true; button.disabled = false;HTMLButtonElement.disabled é uma propriedade booleana, de leitura e escrita, da interface do botão. Reflete o atributo disabled do próprio botão: atribuir true adiciona o atributo, enquanto false o remove. É uma API do navegador definida pelo HTML Standard, não uma funcionalidade do próprio ECMAScript; ter Node 24 disponível não comprova que esta API seja suportada.
Um botão desativado não responde à ativação normal do utilizador, e o seu par nome-valor não é enviado com o formulário. O atributo é booleano: o que importa é a sua presença, não o valor textual. Assim, button.setAttribute('disabled', 'false') continua a desativar o botão; use button.disabled = false para remover o atributo.
O valor da propriedade não é um teste completo da desativação efetiva. Um botão pode ter disabled === false e, ainda assim, permanecer desativado por um fieldset antecessor com o atributo disabled. Os descendentes do primeiro elemento legend que seja filho desse fieldset estão isentos deste efeito de desativação. Definir apenas button.disabled = false não anula a desativação herdada de um antecessor.
Exemplos
const button = document.createElement('button');
button.type = 'button';
console.log(button.disabled);
button.disabled = true;
console.log(button.disabled, button.hasAttribute('disabled'));
button.disabled = false;
console.log(button.disabled, button.hasAttribute('disabled'));
button.setAttribute('disabled', 'false');
console.log(button.disabled);Resultado
false true true false false true
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.