Element: ariaDisabled-Eigenschaft

Baseline 2023
Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die ariaDisabled-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-disabled-Attributs wider, welches angibt, dass das Element wahrnehmbar, aber deaktiviert ist und daher nicht bearbeitet oder anderweitig bedienbar ist.

Hinweis: Verwenden Sie nach Möglichkeit das <input>-Element mit type="button" oder das <button>-Element — da diese Elemente eingebaute Semantik haben und keine ARIA-Attribute erfordern.

Wert

Ein String mit einem der folgenden Werte:

"true"

Das Element und alle fokussierbaren Nachkommen sind deaktiviert, aber wahrnehmbar, 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 darauf hinweist, dass diese Eingabe momentan deaktiviert ist. Mithilfe von 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

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

Browser-Kompatibilität