Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources