Element: ariaChecked-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 ariaChecked-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-checked-Attributs wider, welches den aktuellen "checked"-Zustand von Kontrollkästchen, Optionsfeldern und anderen Widgets anzeigt, die einen überprüfbaren Zustand haben.
Hinweis:
Verwenden Sie nach Möglichkeit ein HTML-<input>-Element mit type="checkbox", da dieses Element über integrierte Semantik verfügt und keine ARIA-Attribute benötigt.
Wert
Ein String mit einem der folgenden Werte:
"true"-
Das Element ist ausgewählt.
"mixed"-
Zeigt einen gemischten Moduswert für ein Drei-Zustand-Kontrollkästchen oder ein Menüelement-Kontrollkästchen an.
"false"-
Das Element kann ausgewählt werden, ist aber derzeit nicht ausgewählt.
"undefined"-
Das Element unterstützt kein Auswählen.
Beispiele
In diesem Beispiel wird das aria-checked-Attribut auf dem Element mit der ID checkBoxInput auf "false" gesetzt, was anzeigt, dass dieses Eingabefeld derzeit nicht ausgewählt 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
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariachecked |