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: Rolle listbox

Die Rolle listbox wird für Listen verwendet, aus denen Benutzer eine oder mehrere statische Optionen auswählen können. Anders als HTML-Elemente <select> können solche Listen auch Bilder enthalten.

Beschreibung

Die Rolle listbox kennzeichnet ein Element, das eine Liste erstellt, aus der Benutzer eine oder mehrere statische Optionen auswählen können, ähnlich dem HTML-Element <select>. Anders als <select> kann eine Listbox Bilder enthalten. Listboxen enthalten untergeordnete Elemente mit der Rolle option oder Elemente mit der Rolle group, die ihrerseits untergeordnete Elemente mit der Rolle option enthalten.

Es wird dringend empfohlen, stattdessen das HTML-Element select, bei Einfachauswahl eine Gruppe von Radiobuttons oder bei Mehrfachauswahl eine Gruppe von Kontrollkästchen zu verwenden. Die Tastaturinteraktion und Fokusverwaltung für alle untergeordneten Elemente ist aufwendig; native HTML-Elemente stellen diese Funktionalität bereits bereit.

Elemente mit der Rolle listbox haben implizit den Wert vertical für aria-orientation.

Wenn eine Liste per Tabulatortaste den Fokus erhält, wird die erste Option ausgewählt, sofern nicht bereits eine andere ausgewählt ist. Mit den Pfeiltasten nach oben und unten navigieren Benutzer durch die Liste; mit Umschalttaste und diesen Pfeiltasten verschieben und erweitern sie die Auswahl. Die Eingabe eines oder mehrerer Buchstaben führt zu passenden Listeneinträgen: Die wiederholte Eingabe desselben Buchstabens führt nacheinander zu Einträgen, die damit beginnen; die Eingabe verschiedener Buchstaben führt zum ersten Eintrag, der mit der gesamten eingegebenen Zeichenfolge beginnt. Wenn der aktuelle Eintrag ein Kontextmenü hat, öffnet Umschalttaste+F10 dieses Menü. Bei ankreuzbaren Listeneinträgen können Kontrollkästchen mit der Leertaste umgeschaltet werden. Bei auswählbaren Listeneinträgen schaltet die Leertaste die Auswahl um, Umschalttaste+Leertaste kann zusammenhängende Einträge auswählen, Strg+Pfeiltaste bewegt den Fokus ohne Auswahl, und Strg+Leertaste kann nicht zusammenhängende Einträge auswählen. Es wird empfohlen, ein Kontrollkästchen, einen Link oder eine andere Möglichkeit zum Auswählen aller Einträge bereitzustellen. Strg+A kann dafür als Tastenkürzel dienen.

Wenn einem Element die Rolle listbox hinzugefügt wird oder ein solches Element sichtbar wird, geben Screenreader beim Fokussieren dessen Beschriftung und Rolle aus. Wenn eine Option oder ein Eintrag innerhalb der Liste fokussiert ist, wird dieser als Nächstes ausgegeben, gefolgt von seiner Position in der Liste, sofern der Screenreader dies unterstützt. Während sich der Fokus innerhalb der Liste bewegt, gibt der Screenreader die jeweiligen Einträge aus.

Zugehörige ARIA-Rollen, -Zustände und -Eigenschaften

Zugehörige Rollen

Rolle option

Mindestens eine untergeordnete Option ist erforderlich. Für alle ausgewählten Optionen ist aria-selected auf true gesetzt. Für alle nicht ausgewählten Optionen ist aria-selected auf false gesetzt. Ist eine Option nicht auswählbar, lassen Sie aria-selected weg.

Rolle list

Ein Abschnitt, der listitem-Elemente enthält.

Zustände und Eigenschaften

aria-activedescendant

Enthält den id-Wert des aktuell aktiven Elements innerhalb der Listbox. Handelt es sich dabei um ein option-Element, ist dies die id der Option, mit der zuletzt interagiert wurde – unabhängig davon, ob aria-selected für diese Option den Wert true hat. Die Eigenschaft enthält nur eine einzige id, auch in einer Listbox mit Mehrfachauswahl. Wenn die id nicht auf ein untergeordnetes DOM-Element der Listbox verweist, muss sie unter den IDs im Attribut aria-owns aufgeführt sein.

aria-owns

Eine durch Leerzeichen getrennte Liste von Element-IDs, deren Elemente keine untergeordneten DOM-Elemente der Listbox sind. Hier aufgeführte IDs dürfen nicht zugleich in aria-owns-Attributen anderer Elemente stehen.

aria-multiselectable

Fügen Sie dieses Attribut hinzu und setzen Sie es auf true, wenn Benutzer mehr als eine Option auswählen können. Bei true sollte jede auswählbare Option ein aria-selected-Attribut mit dem Wert true oder false haben. Optionen, die nicht auswählbar sind, sollten kein aria-selected-Attribut haben. Bei false oder wenn das Attribut fehlt, benötigt nur die aktuell ausgewählte Option – sofern eine ausgewählt ist – das Attribut aria-selected; dessen Wert muss true sein.

aria-required

Ein boolesches Attribut, das angibt, dass eine Option mit einem nicht leeren Zeichenfolgenwert ausgewählt sein muss.

aria-readonly

Benutzer können nicht ändern, welche Optionen ausgewählt sind; die Listbox bleibt ansonsten bedienbar.

aria-label

Eine für Menschen lesbare Zeichenfolge, die die Listbox bezeichnet. Wenn eine sichtbare Beschriftung vorhanden ist, sollte stattdessen aria-labelledby verwendet werden, um darauf zu verweisen.

aria-labelledby

Verweist über eine durch Leerzeichen getrennte Liste von Element-IDs auf die sichtbaren Elemente, die die Listbox beschriften. Wenn keine sichtbare Beschriftung vorhanden ist, sollte stattdessen aria-label verwendet werden, um eine Beschriftung anzugeben. (Hinweis: Die Schreibweise „labelled“ mit zwei „l“ entspricht den Konventionen der Barrierefreiheits-APIs.)

aria-roledescription

Eine für Menschen lesbare Zeichenfolge, die die Rolle der Listbox genauer beschreibt. Screenreader lesen diesen Wert häufig nach der Beschriftung vor, sofern eine vorhanden ist, anstatt „listbox“ auszugeben.

Tastaturinteraktionen

  • Wenn eine Listbox mit Einfachauswahl den Fokus erhält:

    • War zuvor keine Option ausgewählt, erhält die erste Option den Fokus. Optional kann sie automatisch ausgewählt werden.
    • War zuvor eine Option ausgewählt, wird der Fokus auf diese Option gesetzt.
  • Wenn eine Listbox mit Mehrfachauswahl den Fokus erhält:

    • War zuvor keine Option ausgewählt, wird der Fokus auf die erste Option gesetzt, ohne den Auswahlzustand automatisch zu ändern.
    • Waren zuvor eine oder mehrere Optionen ausgewählt, wird der Fokus auf die erste ausgewählte Option in der Liste gesetzt.
  • Down Arrow

    : Verschiebt den Fokus zur nächsten Option. In einer Listbox mit Einfachauswahl kann optional auch die Auswahl dem Fokus folgen.

  • Up Arrow

    : Verschiebt den Fokus zur vorherigen Option. In einer Listbox mit Einfachauswahl kann optional auch die Auswahl dem Fokus folgen.

  • Home

    (Optional): Verschiebt den Fokus zur ersten Option. In einer Listbox mit Einfachauswahl kann optional auch die Auswahl dem Fokus folgen. Für Listen mit mehr als fünf Optionen wird die Unterstützung dieser Taste dringend empfohlen.

  • End

    (Optional): Verschiebt den Fokus zur letzten Option. In einer Listbox mit Einfachauswahl kann optional auch die Auswahl dem Fokus folgen. Für Listen mit mehr als fünf Optionen wird die Unterstützung dieser Taste dringend empfohlen.

  • Die Suche durch Eingabe von Zeichen wird für alle Listboxen empfohlen, insbesondere für solche mit mehr als sieben Optionen:

    • Eingabe eines Zeichens: Der Fokus wechselt zum nächsten Eintrag, dessen Name mit dem eingegebenen Zeichen beginnt.
    • Eingabe mehrerer Zeichen in schneller Folge: Der Fokus wechselt zum nächsten Eintrag, dessen Name mit der eingegebenen Zeichenfolge beginnt.
  • Mehrfachauswahl: Zur Unterstützung der Mehrfachauswahl können Autoren eines von zwei Interaktionsmodellen implementieren: das empfohlene Modell, bei dem Benutzer während der Navigation durch die Liste keine Modifikatortaste wie Shift oder Control gedrückt halten müssen, oder ein alternatives Modell, bei dem Modifikatortasten gedrückt gehalten werden müssen, damit bestehende Auswahlzustände bei der Navigation erhalten bleiben.

    • Empfohlenes Auswahlmodell – das Gedrückthalten von Modifikatortasten ist nicht erforderlich:
      • Space: Ändert den Auswahlzustand der fokussierten Option.
      • Shift + Down Arrow (optional): Verschiebt den Fokus zur nächsten Option und schaltet deren Auswahlzustand um.
      • Shift + Up Arrow (optional): Verschiebt den Fokus zur vorherigen Option und schaltet deren Auswahlzustand um.
      • Shift + Space (optional): Wählt zusammenhängende Einträge von der zuletzt ausgewählten Option bis zur fokussierten Option aus.
      • Control + Shift + Home (optional): Wählt die fokussierte Option und alle Optionen bis zur ersten Option aus. Optional wird der Fokus zur ersten Option verschoben.
      • Control + Shift + End (optional): Wählt die fokussierte Option und alle Optionen bis zur letzten Option aus. Optional wird der Fokus zur letzten Option verschoben.
      • Control + A (optional): Wählt alle Optionen in der Liste aus. Sind bereits alle Optionen ausgewählt, kann die Tastenkombination optional auch die gesamte Auswahl aufheben.

Erforderliche JavaScript-Funktionalität

Auswählen einer Option in einer Listbox mit Einfachauswahl

Wenn Benutzer eine Option auswählen, muss Folgendes geschehen:

  1. Die zuvor ausgewählte Option wird abgewählt. Dazu wird aria-selected auf false gesetzt oder das Attribut vollständig entfernt. Auch die Darstellung der Option wird so geändert, dass sie nicht mehr ausgewählt erscheint.
  2. Die neue Option wird ausgewählt. Dazu wird aria-selected="true" auf der Option gesetzt und ihre Darstellung so geändert, dass sie ausgewählt erscheint.
  3. Der Wert von aria-activedescendant auf der Listbox wird auf die id der neu ausgewählten Option aktualisiert.
  4. Die Zustände für Fokusverlust, Fokus und Auswahl der Option werden visuell dargestellt.

Umschalten des Zustands einer Option in einer Listbox mit Mehrfachauswahl

Wenn Benutzer auf eine Option klicken, bei fokussierter Option Space drücken oder den Zustand einer Option auf andere Weise umschalten, muss Folgendes geschehen:

  1. Der Wert von aria-selected für die aktuell fokussierte Option wird umgeschaltet: von false auf true beziehungsweise von true auf false.
  2. Die Darstellung der Option wird an ihren Auswahlzustand angepasst.
  3. Der Wert von aria-activedescendant auf der Listbox wird auf die ID der Option aktualisiert, mit der die Benutzer zuletzt interagiert haben – auch wenn sie die Auswahl der Option dabei aufgehoben haben.

Hinweis: Die erste Regel für den Einsatz von ARIA lautet: Wenn Sie eine native Funktion verwenden können, die die benötigte Semantik und das benötigte Verhalten bereits mitbringt, sollten Sie dies tun, statt ein Element zweckzuentfremden und es durch das Hinzufügen einer ARIA-Rolle, eines Zustands oder einer Eigenschaft zugänglich zu machen. Das Element <select> mit untergeordneten <option>-Elementen unterstützt alle erforderlichen Interaktionen von sich aus.

Bewährte Vorgehensweisen

  • Für die Bedienbarkeit per Tastatur sollten Autoren den Fokus aller untergeordneten Elemente verwalten.
  • Es wird empfohlen, die Auswahl anders darzustellen, wenn die Liste nicht fokussiert ist. Beispielsweise wird eine inaktive Auswahl häufig mit einer helleren Hintergrundfarbe angezeigt.
  • Wenn die Listbox nicht Teil eines anderen Widgets ist, sollte die Eigenschaft aria-labelledby gesetzt sein.
  • Wenn ein oder mehrere Einträge keine untergeordneten DOM-Elemente der Listbox sind, müssen zusätzliche aria-*-Eigenschaften gesetzt werden (siehe ARIA Best Practices).
  • Wenn es einen triftigen Grund gibt, die Listbox aufzuklappen, ist möglicherweise die Rolle combobox besser geeignet.

Beispiele

Beispiel 1: Eine Listbox mit Einfachauswahl, die aria-activedescendant verwendet

Der folgende Codeausschnitt zeigt, wie die Rolle listbox mithilfe von aria-activedescendant direkt im HTML-Quellcode verwendet wird.

html
<p id="listbox1label" role="label">Select a color:</p>
<div
  role="listbox"
  tabindex="0"
  id="listbox1"
  aria-labelledby="listbox1label"
  aria-activedescendant="listbox1-1">
  <div role="option" id="listbox1-1" class="selected" aria-selected="true">
    Green
  </div>
  <div role="option" id="listbox1-2">Orange</div>
  <div role="option" id="listbox1-3">Red</div>
  <div role="option" id="listbox1-4">Blue</div>
  <div role="option" id="listbox1-5">Violet</div>
  <div role="option" id="listbox1-6">Periwinkle</div>
</div>
js
const listbox = document.getElementById("listbox1");
listbox.addEventListener("click", listItemClick);
listbox.addEventListener("keydown", listItemKeyEvent);
listbox.addEventListener("keypress", listItemKeyEvent);

Dies hätte sich einfacher mit den nativen HTML-Elementen <select> und <label> umsetzen lassen.

html
<label for="listbox1">Select a color:</label>
<select id="listbox1">
  <option selected>Green</option>
  <option>Orange</option>
  <option>Red</option>
  <option>Blue</option>
  <option>Violet</option>
  <option>Periwinkle</option>
</select>

Weitere Beispiele

Spezifikationen

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

Siehe auch