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 des Element-Interfaces spiegelt den Wert des aria-disabled-Attributs wider, welches anzeigt, dass das Element zwar wahrnehmbar, aber deaktiviert ist, und somit nicht bearbeitbar oder anderweitig bedienbar ist.

Hinweis: Wenn möglich, verwenden Sie das <input>-Element mit type="button" oder das <button>-Element — da diese Elemente über eingebaute Semantik verfügen und keine ARIA-Attribute benötigen.

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 ist 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>

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