CKTIS / JavaScript
HTMLButtonElement.disabled — eine Schaltfläche deaktivieren
HTMLButtonElement.disabled ist eine boolesche Eigenschaft, die das Vorhandensein des disabled-Attributs einer Schaltfläche widerspiegelt. Damit lässt sich eine Schaltfläche deaktivieren oder ihr eigenes disabled-Attribut entfernen; sie beschreibt jedoch nicht alle Gründe, aus denen das Steuerelement deaktiviert sein kann.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
button.disabled; button.disabled = true; button.disabled = false;HTMLButtonElement.disabled ist eine lesbare und beschreibbare boolesche Eigenschaft der Schaltflächen-Schnittstelle. Sie spiegelt das eigene disabled-Attribut der Schaltfläche wider: Durch Zuweisung von true wird das Attribut hinzugefügt, durch false wird es entfernt. Dies ist eine Browser-API, die im HTML Standard definiert ist, und keine Funktion von ECMAScript selbst; die Verfügbarkeit von Node 24 belegt nicht, dass diese API unterstützt wird.
Eine deaktivierte Schaltfläche wird nicht normal durch Benutzer aktiviert, und ihr Name-Wert-Paar wird nicht mit dem Formular übermittelt. Das Attribut ist boolesch: Entscheidend ist seine Anwesenheit, nicht sein Textwert. Deshalb deaktiviert button.setAttribute('disabled', 'false') die Schaltfläche weiterhin; mit button.disabled = false entfernst du das Attribut.
Der Eigenschaftswert ist kein vollständiger Test dafür, ob die Schaltfläche tatsächlich deaktiviert ist. Eine Schaltfläche kann disabled === false haben und dennoch durch ein übergeordnetes fieldset mit dem Attribut disabled deaktiviert sein. Nachkommen des ersten legend-Elements, das Kind dieses fieldset ist, sind von dieser Deaktivierungswirkung ausgenommen. Allein durch button.disabled = false wird eine von einem übergeordneten Element geerbte Deaktivierung nicht aufgehoben.
Beispiele
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);Ergebnis
false true true false false true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.