Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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.
DieariaChecked-Eigenschaft derElement-Schnittstelle spiegelt den Wert desaria-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 mittype="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 dasaria-checked-Attribut des Elements mit der IDcheckBoxInput auf "false" gesetzt, was anzeigt, dass dieses Eingabefeld derzeit nicht aktiviert ist. Mithilfe vonariaChecked aktualisieren wir den Wert auf "true".
<span role="checkbox" aria-checked="false" tabindex="0" aria-labelledby="chk1-label"></span><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 |