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

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.

Fontes