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>

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

BCD tables only load in the browser