WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen