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-setsize-Attribut

Das Attribut aria-setsize definiert die Anzahl der Elemente in der aktuellen Gruppe von listitems oder treeitems, wenn nicht alle Elemente der Gruppe im DOM vorhanden sind.

Beschreibung

Browser berechnen automatisch die Gruppengröße und die Position jedes Elements innerhalb einer Gruppe, beispielsweise die Anzahl der <li>-Elemente in einer Liste, der Buttons in einer Gruppe gleichnamiger Radio-Buttons oder der <option>-Elemente in einem <select>-Element. Unterstützende Technologien wie Screenreader nutzen diese Informationen, um Nutzern die Gruppengröße mitzuteilen.

Wenn das DOM nicht vollständig ist, kann die vom Browser berechnete Anzahl der Elemente in einer Gruppe falsch sein. Sind nur einige Elemente, etwa Listeneinträge, in das DOM geladen, berücksichtigt der Browser bei seiner Berechnung nur die vorhandenen Elemente. Das Attribut aria-setsize sollte verwendet werden, um diese falsche Anzahl zu korrigieren. Es gibt an, wie viele listitems oder treeitems die aktuelle Gruppe umfasst, wenn alle Elemente geladen wären.

Das Attribut aria-setsize wird für jedes einzelne Element festgelegt, nicht für ein umschließendes Element. Der Wert ist für alle Elemente gleich: eine Ganzzahl, die die Anzahl der Elemente in der vollständigen Gruppe angibt, oder -1, wenn die Gruppengröße unbekannt ist. Sind alle Elemente im DOM vorhanden, kann der Browser die Gruppengröße und die Position jedes Elements selbst berechnen. In diesem Fall sind weder aria-setsize noch aria-posinset erforderlich.

Elemente mit aria-setsize haben in der Regel auch das Attribut aria-posinset, das die Position des Elements innerhalb der Gruppe angibt. Der Wert von aria-posinset liegt zwischen 1 und dem positiven Wert von aria-setsize.

Wenn beispielsweise im Kommentarbereich einer Seite nicht alle Kommentare im DOM vorhanden sind, etwa weil sie auf mehrere Seiten verteilt sind, sollten die Hierarchieebene, die Gesamtzahl der Kommentare und die Position jedes Kommentars mit ARIA angegeben werden. Die Hierarchieebene der Kommentare lässt sich mit aria-level angeben. aria-posinset und aria-setsize geben die Position innerhalb der Gruppe und deren Größe an.

Wenn ein Feed eine feste Anzahl von Artikeln enthält, kann aria-setsize jedem article-Element hinzugefügt werden. Als Wert kann entweder die Anzahl der geladenen Artikel oder die Gesamtzahl der Artikel im Feed verwendet werden. Wählen Sie den Wert, der für Nutzer am hilfreichsten ist. Ist die Anzahl der Artikel sehr groß, unbestimmt oder ändert sie sich häufig, kann aria-setsize="-1" verwendet werden, um anzugeben, dass die Gruppengröße unbekannt ist.

Wenn in einer listbox aufgrund des dynamischen Nachladens beim Scrollen nicht alle verfügbaren Optionen im DOM vorhanden sind, können aria-setsize und aria-posinset für jede option festgelegt werden.

Wenn in einer Baumansicht aufgrund des dynamischen Nachladens beim Verschieben des Fokus oder beim Scrollen nicht alle verfügbaren Knoten im DOM vorhanden sind, werden für jeden Knoten aria-level, aria-setsize und aria-posinset festgelegt.

In einem Menü wird aria-setsize für alle Elemente mit der Rolle menuitem, menuitemcheckbox oder menuitemradio festgelegt. Der Wert entspricht der Gesamtzahl der Menüeinträge ohne Trennlinien.

Werte

<integer>

Die Anzahl der Elemente in der vollständigen Gruppe oder -1, wenn die Gruppengröße unbekannt ist.

Zugehörige Schnittstellen

Element.ariaSetSize

Die Eigenschaft ariaSetSize der Schnittstelle Element spiegelt den Wert des Attributs aria-setsize wider.

ElementInternals.ariaSetSize

Die Eigenschaft ariaSetSize der Schnittstelle ElementInternals spiegelt den Wert des Attributs aria-setsize wider.

Zugehörige Rollen

Wird in folgenden Rollen verwendet:

Wird an folgende Rollen vererbt:

Beispiel

Das folgende Beispiel zeigt die Elemente 5 bis 8 einer Gruppe von 16 Elementen.

html
<h2 id="label_fruit">Available Fruit</h2>
<ul role="listbox" aria-labelledby="label_fruit">
  <li role="option" aria-setsize="16" aria-posinset="5">apples</li>
  <li role="option" aria-setsize="16" aria-posinset="6">bananas</li>
  <li role="option" aria-setsize="16" aria-posinset="7">cantaloupes</li>
  <li role="option" aria-setsize="16" aria-posinset="8">dates</li>
</ul>

Zur Orientierung würden unterstützende Technologien die oben genannten Bananen als „Element 6 von 16“ ansagen.

Spezifikationen

Spezifikation
Accessible Rich Internet Applications (WAI-ARIA)
# aria-setsize

Siehe auch