Element: ariaChecked-Eigenschaft
Baseline
2023
Neu verfügbar
Seit October 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die ariaChecked-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-checked-Attributs wider, das den aktuellen "checked"-Status von Kontrollkästchen, Optionsfeldern und anderen Widgets mit einem überprüfbaren Status angibt.
Hinweis:
Verwenden Sie, wenn möglich, 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 Mischmoduswert für ein Dreiweg-Kontrollkästchen oder Menüelement-Kontrollkästchen an.
"false"-
Das Element unterstützt den überprüften Status, ist jedoch derzeit nicht aktiviert.
"undefined"-
Das Element unterstützt keinen überprüften Status.
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
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariachecked |