ARIA: aria-checked Attribut
Das aria-checked Attribut gibt den aktuellen "checked"-Zustand von Kontrollkästchen, Optionsfeldern und anderen Widgets an.
Hinweis:
Verwenden Sie nach Möglichkeit ein HTML <input> Element mit type="checkbox" und type="radio", da diese eingebaute Semantik haben und keine ARIA-Attribute erfordern.
Beschreibung
Das aria-checked Attribut gibt an, ob das Element ausgewählt (true), nicht ausgewählt (false) oder ob der ausgewählte Status unbestimmt (mixed) ist, was bedeutet, dass es weder ausgewählt noch nicht ausgewählt ist. Der mixed Wert wird von den drei Zustands-Eingaberollen checkbox und menuitemcheckbox unterstützt.
Der mixed Wert wird nicht von radio, menuitemradio oder switch und Elementen, die davon erben, unterstützt. Der Wert wird false sein, wenn mixed gesetzt ist, wenn es nicht unterstützt wird.
<span
role="checkbox"
id="checkBoxInput"
aria-checked="false"
tabindex="0"
aria-labelledby="chk15-label"></span>
<label id="chk15-label">Subscribe to the newsletter</label>
Das tabindex Attribut ist erforderlich, um den Fokus zu ermöglichen. JavaScript ist erforderlich, um den aria-checked Status umzuschalten. Und, wenn dieses Kontrollkästchen Teil eines einreichbaren Formulars ist, ist weiteres JavaScript erforderlich, um einen Namen und einen Wert festzulegen.
Das Obige könnte wie folgt geschrieben werden:
<input type="checkbox" id="chk15-label" name="Subscribe" />
<label for="chk15-label">Subscribe to the newsletter</label>
Durch die Verwendung des <input> Elements mit type="checkbox" anstelle von ARIA ist kein JavaScript erforderlich.
Werte
- false
-
Das Element unterstützt das Ausgewähltsein, ist aber derzeit nicht ausgewählt.
- true
-
Das Element ist ausgewählt.
- mixed
-
Nur für
checkboxundmenuitemcheckbox, entsprichtindeterminate, was einen gemischten Moduswert angibt, der weder ausgewählt noch nicht ausgewählt ist. - undefined (Standard)
-
Das Element unterstützt das Ausgewähltsein nicht.
Zugehörige Rollen
Verwendet in Rollen:
Zugehörige Schnittstellen
Element.ariaChecked-
Die
ariaCheckedEigenschaft, Teil derElementSchnittstelle, spiegelt den Wert desaria-checkedAttributs wider. ElementInternals.ariaChecked-
Die
ariaCheckedEigenschaft, Teil derElementInternalsSchnittstelle, spiegelt den Wert desaria-checkedAttributs wider.
myHTMLElement.ariaChecked = true;
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-checked |
| Unknown specification |