CKTIS / JavaScript
HTMLButtonElement.disabled — désactiver un bouton
HTMLButtonElement.disabled est une propriété booléenne qui reflète la présence de l’attribut disabled d’un bouton. Elle permet de désactiver un bouton ou de supprimer son propre attribut disabled, mais ne décrit pas toutes les raisons pour lesquelles le contrôle peut être désactivé.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
button.disabled; button.disabled = true; button.disabled = false;HTMLButtonElement.disabled est une propriété booléenne, lisible et modifiable, de l’interface du bouton. Elle reflète l’attribut disabled propre au bouton : lui attribuer true ajoute l’attribut, tandis que false le supprime. Il s’agit d’une API de navigateur définie par le HTML Standard, et non d’une fonctionnalité d’ECMAScript lui-même ; la disponibilité de Node 24 ne prouve pas que cette API est prise en charge.
Un bouton désactivé ne répond pas à l’activation habituelle de l’utilisateur, et sa paire nom-valeur n’est pas envoyée avec le formulaire. L’attribut est booléen : c’est sa présence qui compte, pas sa valeur textuelle. Ainsi, button.setAttribute('disabled', 'false') désactive toujours le bouton ; utilisez button.disabled = false pour supprimer l’attribut.
La valeur de la propriété ne permet pas de déterminer complètement si le bouton est effectivement désactivé. Un bouton peut avoir disabled === false tout en restant désactivé par un fieldset ancêtre portant l’attribut disabled. Les descendants du premier élément legend enfant de ce fieldset échappent à cet effet de désactivation. Définir uniquement button.disabled = false ne neutralise pas la désactivation héritée d’un ancêtre.
Exemples
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);Résultat
false true true false false true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.