Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Element: ariaDisabled-Eigenschaft

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.

Die ariaDisabled-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-disabled-Attributs wider. Dieses Attribut zeigt an, dass das Element erkennbar, aber deaktiviert ist, sodass es nicht bearbeitbar oder anderweitig funktionsfähig ist.

Hinweis: Verwenden Sie, wenn möglich, das <input>-Element mit type="button" oder das <button>-Element — da diese Elemente über integrierte Semantik verfügen und keine ARIA-Attribute erfordern.

Wert

Ein String mit einem der folgenden Werte:

"true"

Das Element und alle fokussierbaren Nachfahren sind deaktiviert, aber erkennbar, und ihre Werte können vom Benutzer nicht geändert werden.

"false"

Das Element ist aktiviert.

Beispiele

In diesem Beispiel wird das aria-disabled-Attribut des Elements mit der ID saveChanges auf "true" gesetzt, was anzeigt, dass diese Eingabe derzeit deaktiviert ist. Mit ariaDisabled aktualisieren wir den Wert auf "false".

html
<div id="saveChanges" tabindex="0" role="button" aria-disabled="true">Save</div>
js
let el = document.getElementById("saveChanges");
console.log(el.ariaDisabled); // "true"
el.ariaDisabled = "false";
console.log(el.ariaDisabled); // "false"

Spezifikationen

Spezifikation
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariadisabled

Browser-Kompatibilität