ARIA: aria-checked-Attribut
Das Attribut aria-checked gibt den aktuellen Zustand „aktiviert“ von Kontrollkästchen, Optionsfeldern und anderen Widgets an.
Hinweis:
Verwenden Sie nach Möglichkeit ein HTML-<input>-Element mit type="checkbox" oder type="radio". Diese Elemente verfügen über eine integrierte Semantik und benötigen keine ARIA-Attribute.
Beschreibung
Das Attribut aria-checked gibt an, ob das Element aktiviert (true) oder nicht aktiviert (false) ist oder ob sein Zustand unbestimmt (mixed) ist – es also weder aktiviert noch nicht aktiviert ist. Der Wert mixed wird von den Rollen checkbox und menuitemcheckbox unterstützt, die drei Zustände zulassen.
Der Wert mixed wird von radio, menuitemradio und switch sowie von Elementen, die von diesen Rollen erben, nicht unterstützt. Wird mixed gesetzt, obwohl es nicht unterstützt wird, gilt der Wert als false.
<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 Attribut tabindex ist erforderlich, damit das Element fokussiert werden kann. Um den Zustand von aria-checked umzuschalten, ist JavaScript erforderlich. Wenn dieses Kontrollkästchen Teil eines absendbaren Formulars ist, wird außerdem JavaScript benötigt, um einen Namen und einen Wert festzulegen.
Das obige Beispiel hätte auch so geschrieben werden können:
<input type="checkbox" id="chk15-label" name="Subscribe" />
<label for="chk15-label">Subscribe to the newsletter</label>
Wenn Sie statt ARIA ein <input>-Element mit type="checkbox" verwenden, ist kein JavaScript erforderlich.
Werte
- false
-
Das Element kann aktiviert werden, ist derzeit aber nicht aktiviert.
- true
-
Das Element ist aktiviert.
- mixed
-
Nur für
checkboxundmenuitemcheckbox: Entsprichtindeterminateund gibt einen gemischten Zustand an, der weder aktiviert noch nicht aktiviert ist. - undefined (Standardwert)
-
Das Element kann nicht aktiviert werden.
Zugehörige Schnittstellen
Element.ariaChecked-
Die Eigenschaft
ariaCheckedder SchnittstelleElementspiegelt den Wert des Attributsaria-checkedwider. ElementInternals.ariaChecked-
Die Eigenschaft
ariaCheckedder SchnittstelleElementInternalsspiegelt den Wert des Attributsaria-checkedwider.
myHTMLElement.ariaChecked = true;
Zugehörige Rollen
Wird in folgenden Rollen verwendet:
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-checked> |
| Unknown specification> |