Element: ariaChecked-Eigenschaft
Baseline 2023Newly 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 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
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariachecked |
Browser-Kompatibilität
BCD tables only load in the browser