ARIA: Rolle menuitemcheckbox
Ein menuitemcheckbox ist ein menuitem mit einem ankreuzbaren Zustand, der die Werte true, false oder mixed annehmen kann.
Beschreibung
Die Einträge in Menüs und Menüleisten sind Menüpunkte. Es gibt drei Arten von Menüpunkten: menuitem, menuitemradio und menuitemcheckbox.
Diese drei Arten von Elementen dürfen nur in einem Element mit der Rolle menu oder menubar enthalten sein oder diesem zugeordnet werden. Optional können sie in einem Gruppierungselement mit der Rolle group verschachtelt sein. Durch die Verschachtelung in einem menu oder einer menubar beziehungsweise eine andere Zuordnung dazu (siehe aria-owns) werden die Menüpunkte als zusammengehörige Widgets erkannt.
Menüpunkte, einschließlich menuitemcheckbox-Elementen, können innerhalb von group-Elementen gruppiert oder durch Elemente mit der Rolle separator beziehungsweise einer entsprechenden nativen Rolle wie <fieldset> und <hr> voneinander getrennt werden.
Menüpunkte mit der Rolle menuitemcheckbox müssen das Attribut aria-checked enthalten, um den Zustand der Checkbox für assistive Technologien zugänglich zu machen. Eine Ausnahme ist die Verwendung von <input type="checkbox">; in diesem Fall sollte das Attribut checked verwendet werden.
Ähnlich wie das Attribut checked bei <input>-Elementen vom Typ checkbox gibt das Attribut aria-checked eines menuitemcheckbox an, ob der Menüpunkt ausgewählt (true) oder nicht ausgewählt (false) ist oder ob er ein untergeordnetes Menü mit Menüpunkten repräsentiert, die teils ausgewählt und teils nicht ausgewählt sind (mixed). Der Wert mixed ähnelt dem Zustand indeterminate einer Checkbox: Er stellt einen dritten Zustand dar, der weder ausgewählt noch nicht ausgewählt ist.
Ein zugänglicher Name ist erforderlich. Idealerweise stammt er bei Verwendung von <input type="checkbox"> aus einem zugehörigen <label>-Element oder andernfalls aus sichtbarem Inhalt eines Nachfahrenelements. Wenn die Beschriftung oder der Inhalt der Nachfahrenelemente nicht ausreicht und stattdessen vorzugsweise aria-labelledby mit einem Verweis auf Inhalt außerhalb der Nachfahrenelemente oder aria-label verwendet wird, beachten Sie: Diese beiden ARIA-Eigenschaften verbergen anderen Inhalt von Nachfahrenelementen vor assistiven Technologien.
Wenn nicht alle Elemente der Gruppe im DOM vorhanden sind, geben Sie die Eigenschaften aria-setsize und aria-posinset an. Legen Sie deren Werte bei einem menuitemcheckbox bezogen auf die Gesamtzahl der Menüpunkte fest, ohne Trennelemente mitzuzählen.
Ein menuitemcheckbox-Element darf Textinhalt enthalten, aber keine interaktiven Nachfahrenelemente und keine Nachfahrenelemente mit einem tabindex-Attribut.
Alle Nachfahrenelemente sind rein präsentational
Manche Arten von Benutzeroberflächenkomponenten können in einer Accessibility-API der Plattform nur Text enthalten. Accessibility-APIs können semantische Elemente innerhalb eines menuitemcheckbox nicht darstellen. Um diese Einschränkung zu berücksichtigen, weisen Browser allen Nachfahrenelementen eines menuitemcheckbox-Elements automatisch die Rolle presentation zu, da diese Rolle keine semantischen Kindelemente unterstützt.
Betrachten Sie beispielsweise das folgende menuitemcheckbox-Element, das eine Überschrift enthält.
<div role="menuitemcheckbox"><h6>Name of my checkbox</h6></div>
Da Nachfahrenelemente von menuitemcheckbox rein präsentational sind, ist der folgende Code gleichwertig:
<div role="menuitemcheckbox">
<h6 role="presentation">Name of my checkbox</h6>
</div>
Aus Sicht einer Person, die assistive Technologien verwendet, existiert die Überschrift nicht, da die vorherigen Codebeispiele im Barrierefreiheitsbaum dem Folgenden entsprechen:
<div role="menuitemcheckbox">Name of my checkbox</div>
Zugehörige WAI-ARIA-Rollen, -Zustände und -Eigenschaften
-
Widget, das eine Liste gängiger Aktionen oder Funktionen anbietet, die Benutzer ausführen können.
-
Ähnlich wie
menu, jedoch für eine dauerhaft sichtbare Gruppe häufig verwendeter Befehle, die üblicherweise horizontal angeordnet ist. - Rolle
group -
Container für eine Gruppe von
menuitem-Elementen, einschließlichmenuitemcheckbox-Elementen innerhalb einesmenuoder einermenubar. aria-checked(erforderlich)-
Gibt mit dem Wert
true,falseodermixedden aktuellen Auswahlzustand desmenuitemcheckboxan.
Tastaturinteraktionen
Wenn ein menu geöffnet wird oder eine menubar den Fokus erhält, wird der Tastaturfokus auf den ersten Menüpunkt gesetzt. Alle Menüpunkte in beiden Elementen sind fokussierbar, einschließlich aller menuitemcheckbox-Elemente.
Befindet sich das menuitemcheckbox in einem Untermenü einer menubar oder in einem Menü, das über eine Menüschaltfläche geöffnet wurde, müssen die folgenden Tastaturinteraktionen implementiert werden:
- Enter
-
Wechselt den Zustand von
aria-checkedbeimmenuitemcheckboxund schließt das Menü. - Space
-
Wechselt den Zustand von
aria-checkedbeimmenuitemcheckbox. Das Menü bleibt geöffnet. - Escape
-
Schließt das Menü. Bei einer Menüleiste wird der Fokus auf den übergeordneten Menüpunkt gesetzt.
- Right Arrow
-
Schließt das Untermenü. Bei einer Menüleiste wird der Fokus auf den nächsten Menüpunkt der Menüleiste gesetzt und gegebenenfalls dessen Untermenü geöffnet.
- Left Arrow
-
Schließt das Menü. Bei einer Menüleiste wird der Fokus auf den vorherigen Menüpunkt der Menüleiste gesetzt und gegebenenfalls dessen Untermenü geöffnet.
- Down Arrow
-
Setzt den Fokus auf den nächsten Menüpunkt. Befindet sich der Fokus auf dem letzten Menüpunkt, wird er auf den ersten gesetzt.
- Up Arrow
-
Setzt den Fokus auf den vorherigen Menüpunkt. Befindet sich der Fokus auf dem ersten Menüpunkt, wird er auf den letzten gesetzt.
- Home
-
Setzt den Fokus auf den ersten Menüpunkt.
- End
-
Setzt den Fokus auf den letzten Menüpunkt.
- Character
-
Setzt den Fokus auf den nächsten Menüpunkt, dessen Name mit dem eingegebenen Zeichen beginnt. Trifft dies auf keinen Menüpunkt zu, bleibt der Fokus unverändert.
Erforderliches JavaScript
Erforderliche Ereignisbehandlungsroutinen
onclick-
Verarbeitet Mausklicks sowohl auf die Checkbox als auch auf die zugehörige Beschriftung. Dabei werden der Wert des Attributs
aria-checkedund das Erscheinungsbild der Checkbox geändert, sodass sie für sehende Benutzer ausgewählt oder nicht ausgewählt erscheint. onKeyDown-
Verarbeitet das Drücken der Taste Space. Dabei werden der Wert des Attributs
aria-checkedund das Erscheinungsbild der Checkbox geändert, sodass sie für sehende Benutzer ausgewählt oder nicht ausgewählt erscheint. Verarbeitet außerdem alle oben im Abschnitt zur Tastaturnavigation aufgeführten Tasten.
Bewährte Verfahren
>HTML bevorzugen
Die erste Regel von ARIA lautet: Wenn ein natives HTML-Element oder -Attribut die benötigte Semantik und das benötigte Verhalten bietet, verwenden Sie es, statt ein Element zweckzuentfremden und es durch eine ARIA-Rolle, einen ARIA-Zustand oder eine ARIA-Eigenschaft zugänglich zu machen. Daher empfiehlt es sich, das native HTML-Formularsteuerelement für Checkboxen zu verwenden, statt die Funktionalität einer Checkbox mit JavaScript und ARIA nachzubilden.
Beispiele
<li role="menuitemcheckbox" tabindex="-1" aria-checked="false">Purple</li>
Durch tabindex="-1" ist das menuitemcheckbox fokussierbar, gehört aber nicht zur Tab-Reihenfolge der Seite. Hätten wir aria-checked="true" angegeben, würde dies kennzeichnen, dass das menuitemcheckbox ausgewählt ist. Den ausgewählten Zustand würden wir dann mithilfe des Attributselektors [role='menuitemcheckbox'][aria-checked='true'] visuell als ausgewählt darstellen. Stattdessen signalisiert aria-checked="false" assistiven Technologien, dass das menuitemcheckbox auswählbar, derzeit aber nicht ausgewählt ist. Der zugängliche Name „purple“ stammt aus dem Inhalt.
Das sichtbare Erscheinungsbild des ausgewählten Zustands ist eine ausgewählte Checkbox. Wir können sie mithilfe von generiertem Inhalt erstellen, sichtbar machen und ihr dieselbe Farbe wie dem Inhalt geben, indem wir ihren Zustand über CSS-Attributselektoren mit dem Wert von aria-checked synchronisieren und die Farbe vererben.
[role="menuitemcheckbox"]::before {
display: inline-block;
content: "";
color: transparent;
width: 1em;
text-align: center;
outline: 1px solid;
margin-inline-end: 2px;
font-family: sans-serif;
}
[role="menuitemcheckbox"][aria-checked="true"]::before {
color: inherit;
content: "X";
}
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # menuitemcheckbox> |
| Unknown specification> |