aria-checked
Das aria-checked
Attribut zeigt den aktuellen "gecheckten" Zustand von Kontrollkästchen, Optionsfeldern und anderen Widgets an.
Hinweis: Wo möglich, verwenden Sie 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 gecheckt (true
), ungecheckt (false
) oder ob der Status unbestimmt (mixed
) ist, was bedeutet, dass es weder gecheckt noch ungecheckt ist. Der mixed
Wert wird von den dreistufigen Input-Rollen checkbox
und menuitemcheckbox
unterstützt.
Der mixed
Wert wird nicht von radio
, menuitemradio
oder switch
und den von diesen ererbten Elementen unterstützt. Der Wert wird false
sein, wenn mixed
gesetzt ist, wenn dies 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 aktivieren. JavaScript ist erforderlich, um den aria-checked
Zustand zu umschalten. Wenn dieses Kontrollkästchen Teil eines absendbaren Formulars ist, ist mehr JavaScript erforderlich, um einen Namen und einen Wert festzulegen.
Das obige Beispiel könnte so 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 Gechecktsein, ist jedoch momentan nicht gecheckt.
- true
-
Das Element ist gecheckt.
- mixed
-
nur für
checkbox
undmenuitemcheckbox
, entsprichtindeterminate
, was einen gemischten Moduswert von weder gecheckt noch ungecheckt anzeigt. - undefined (Standard)
-
Das Element unterstützt das Gechecktsein nicht.
Zugehörige Rollen
Genutzt in Rollen:
Zugehörige Schnittstellen
Element.ariaChecked
-
Die
ariaChecked
Eigenschaft, Teil derElement
Schnittstelle, spiegelt den Wert desaria-checked
Attributs wider. ElementInternals.ariaChecked
-
Die
ariaChecked
Eigenschaft, Teil derElementInternals
Schnittstelle, spiegelt den Wert desaria-checked
Attributs wider.
myHTMLElement.ariaChecked = true;
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-checked |
Unknown specification |