Element: ariaChecked-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 ariaChecked-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-checked-Attributs wider, das den aktuellen "checked"-Zustand von Checkboxen, Radio-Buttons und anderen Widgets, die einen checked-Zustand haben, anzeigt.
Hinweis:
Verwenden Sie nach Möglichkeit ein HTML-<input>-Element mit type="checkbox", da dieses Element eingebaute Semantik hat und keine ARIA-Attribute benötigt.
Wert
Ein String mit einem der folgenden Werte:
"true"-
Das Element ist aktiviert.
"mixed"-
Gibt einen gemischten Moduswert für ein Drei-Zustands-Checkbox oder ein Menüeintrags-Checkbox an.
"false"-
Das Element unterstützt das Aktiviertsein, ist aber derzeit nicht aktiviert.
"undefined"-
Das Element unterstützt das Aktiviertsein nicht.
Beispiele
In diesem Beispiel wird das aria-checked-Attribut des Elements mit der ID checkBoxInput auf "false" gesetzt, was anzeigt, dass dieses Eingabefeld derzeit nicht aktiviert ist. Mithilfe von ariaChecked aktualisieren wir den Wert auf "true".
<span
role="checkbox"
id="checkBoxInput"
aria-checked="false"
tabindex="0"
aria-labelledby="chk1-label">
</span>
<label id="chk1-label">Remember my preferences</label>
let el = document.getElementById("checkBoxInput");
console.log(el.ariaChecked); // "false"
el.ariaChecked = "true";
console.log(el.ariaChecked); // "true"
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariachecked |
Browser-Kompatibilität
BCD tables only load in the browser