CKTIS / JavaScript
Deaktivierte Formularelemente
Deaktivierte Formularelemente können von Nutzern weder bedient noch fokussiert werden; ihre Werte werden nicht übermittelt. In JavaScript schaltet die Eigenschaft `disabled` den eigenen Deaktivierungszustand eines Elements um, während auch ein umgebendes `fieldset` es deaktivieren 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
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Deaktivierte Formularelemente sind Formularelemente, die deaktiviert wurden. Nutzer können sie weder bearbeiten noch durch Klicken aktivieren; sie erhalten keinen Fokus und nehmen nicht an der Einschränkungsvalidierung teil. Ihre Werte werden beim Absenden des Formulars ausgelassen. Dies ist ein Mechanismus von HTML und dem Browser-DOM, keine Funktion einer bestimmten ECMAScript-Version. MDN kennzeichnet HTMLInputElement.disabled seit Juli 2015 als in Browsern breit verfügbar; das Vorhandensein von Node 24 belegt keine DOM-Unterstützung.
Die Eigenschaft input.disabled ist ein boolescher Wert, der das eigene disabled-Attribut des Elements widerspiegelt. Die Zuweisung von true fügt dieses Attribut hinzu, die Zuweisung von false entfernt es. Das Attribut ist boolesch: Auch disabled="false" bedeutet deaktiviert, denn entscheidend ist das Vorhandensein des Attributs, nicht sein Textwert.
Ein deaktiviertes fieldset deaktiviert auch seine untergeordneten Steuerelemente, außer denen innerhalb des ersten legend-Elements, das ein direktes Kind dieses fieldset ist. Dass sich ein Steuerelement im legend eines verschachtelten fieldset befindet, schützt es für sich genommen nicht vor der Deaktivierung durch das äußere fieldset. Daher kann input.disabled false sein, obwohl ein übergeordnetes Element das Steuerelement deaktiviert; prüfe den tatsächlichen Zustand mit input.matches(':disabled'). Die Zuweisung input.disabled = false allein hebt die Deaktivierung durch ein fieldset nicht auf.
Verwechsle disabled nicht mit readonly: Unterstützte schreibgeschützte Felder können weiterhin den Fokus erhalten und ihre Werte beim Absenden des Formulars übermitteln. readonly gilt für Texttypen von input und für textarea, nicht beispielsweise für select oder button. Das Beispiel zeigt das Umschalten von disabled und das dadurch bedingte Auslassen des Feldes in FormData.
Beispiele
const form = document.createElement('form');
const input = document.createElement('input');
input.name = 'topic';
input.value = 'JavaScript';
form.append(input);
input.disabled = true;
console.log(input.disabled);
console.log(new FormData(form).has('topic'));
input.disabled = false;
console.log(new FormData(form).get('topic'));Ergebnis
true false JavaScript
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.