Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

html
<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:

html
<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 checkbox und menuitemcheckbox: Entspricht indeterminate und 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 ariaChecked der Schnittstelle Element spiegelt den Wert des Attributs aria-checked wider.

ElementInternals.ariaChecked

Die Eigenschaft ariaChecked der Schnittstelle ElementInternals spiegelt den Wert des Attributs aria-checked wider.

js
myHTMLElement.ariaChecked = true;

Zugehörige Rollen

Wird in folgenden Rollen verwendet:

Spezifikationen

Spezifikation
Accessible Rich Internet Applications (WAI-ARIA)
# aria-checked
Unknown specification

Siehe auch