WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTML-Formularsteuerelemente mit `disabled` deaktivieren

`disabled` deaktiviert ein HTML-Formularsteuerelement und schließt es von der Validierung und den Formulardaten aus. `.disabled` und `:disabled` prüfen nicht dasselbe.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

<input name="city" disabled>
<script>
  const input = document.querySelector('input[name="city"]');
  input.disabled = true;
  input.disabled = false;
  input.matches(":disabled");
</script>

disabled ist ein boolesches HTML-Attribut: Entscheidend ist, ob es vorhanden ist. Daher deaktiviert auch disabled="false" das Element. Das gilt etwa für input, button, select, textarea und formularassoziierte benutzerdefinierte Elemente. Für option und optgroup gelten eigene Regeln: Ein deaktiviertes optgroup macht seine Optionen nicht auswählbar, ohne das select selbst zu deaktivieren.

Ein deaktiviertes fieldset deaktiviert seine untergeordneten Steuerelemente, außer denen innerhalb seines ersten direkten legend-Kindelements, falls vorhanden. Bei einem input spiegelt .disabled nur dessen eigenes Attribut wider: true fügt es hinzu, false entfernt es. input.matches(":disabled") prüft den tatsächlichen Zustand einschließlich der Wirkung eines fieldset.

Ein deaktiviertes Steuerelement lässt sich weder fokussieren noch regulär bedienen. Ein Skript kann aber beispielsweise weiterhin input.value ändern. Der Browser überspringt ein deaktiviertes Steuerelement bei der Prüfung der Eingabebedingungen und beim Erstellen der Formulardaten, auch mit new FormData(form). Bei Texteingabefeldern, die readonly unterstützen, verhindert dieses Attribut die Bearbeitung und schließt das Feld von der Prüfung der Eingabebedingungen aus. Es verhindert aber für sich genommen weder den Fokus noch die Aufnahme in die Formulardaten.

Das sind Funktionen der Webplattform, nicht von ECMAScript. Die Deaktivierung ist keine Sicherheitsmaßnahme: Daten und Berechtigungen müssen auf dem Server geprüft werden.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Disabled form control</title>
</head>
<body>
  <script>
    const form = document.createElement("form");
    const group = document.createElement("fieldset");
    const input = document.createElement("input");
    input.name = "city";
    input.value = "Oslo";
    group.append(input);
    form.append(group);

    const report = () => console.log(JSON.stringify([
      input.disabled,
      input.matches(":disabled"),
      input.willValidate,
      new FormData(form).has("city")
    ]));

    group.disabled = true;
    report();
    group.disabled = false;
    report();
  </script>
</body>
</html>

Ergebnis

[false,true,false,false]
[false,false,true,true]

Jede Zeile zeigt der Reihe nach `.disabled`, ob `:disabled` zutrifft, `.willValidate` und ob der Eintrag `city` vorhanden ist. Beim Aktivieren des `fieldset` ändern sich die letzten drei Ergebnisse. Das Eingabefeld hat zu keinem Zeitpunkt ein eigenes `disabled`-Attribut.

Zugehörige Lektionen

  • JavaScript · Lektion 20 · Mittlere Stufe · Version: 3
  • JavaScript · Lektion 21 · Mittlere Stufe · Version: 3

Quellen