aria-setsize

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

Beschreibung

Browser berechnen automatisch die Größe des Sets und die Position für jedes Element in einer Gruppe von Elementen, wie die Anzahl der <li>s in einer Liste, Schaltflächen in einer gleichnamigen Gruppe von Radio-Buttons, und <option>s in einem <select>. Unterstützungstechnologien, wie z. B. Bildschirmleser, nutzen dieses Statusmanagement, um Benutzern die Set-Größen mitzuteilen.

Wenn das DOM nicht vollständig ist, kann die Browserberechnung der Anzahl der Elemente in einem Set falsch sein. Wenn nur eine Teilmenge von Elementen, wie Listenpunkte, in das DOM geladen werden, berechnet der Browser die Anzahl der Elemente nur basierend auf den vorhandenen. Das aria-setsize Attribut sollte verwendet werden, um die falsche Zählung des Browsers zu überschreiben. Es definiert die Anzahl der Elemente im aktuellen Set von listitems oder treeitems, wenn das gesamte Set geladen wäre.

Das aria-setsize Attribut wird auf jedes Element gesetzt, anstatt auf ein enthaltendes Element. Der Wert ist für jedes Element derselbe: ein ganzzahliger Wert, der die Anzahl der Elemente im vollständigen Set widerspiegelt, oder -1, wenn die Set-Größe unbekannt ist. Wenn alle Elemente im DOM vorhanden sind, kann der Browser die Set-Größe und die Position jedes Elements berechnen, wodurch sowohl aria-setsize als auch aria-posinset überflüssig werden.

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

Zum Beispiel in einem Kommentarbereich einer Seite: Wenn Kommentare nicht alle im DOM sind, wie bei paginierten Kommentaren, sollten das Niveau, die Gesamtanzahl der Kommentare und die Position jedes Kommentars mit ARIA festgelegt werden. Das hierarchische Niveau der Kommentare kann mit aria-level angegeben werden. Gruppenpositionsinformationen werden mit aria-posinset und aria-setsize angegeben.

Wenn ein Feed eine feste Anzahl von Artikeln hat, kann aria-setsize zu jedem Artikel-Element hinzugefügt werden, wobei der Wert entweder die Gesamtzahl der geladenen Artikel oder die Gesamtanzahl im Feed ist. Der gewählte Wert hängt davon ab, welcher für Benutzer am hilfreichsten ist. Wenn die Anzahl der Artikel extrem groß, unbestimmt oder sich oft ändert, kann aria-setsize="-1" gesetzt werden, um mitzuteilen, dass die Größe des Sets unbekannt ist.

In einem listbox, wenn das vollständige Set an verfügbaren Optionen aufgrund von dynamischem Laden beim Scrollen nicht im DOM vorhanden ist, können sowohl aria-setsize als auch aria-posinset auf jede option gesetzt werden.

In einer Baumansicht, wenn das vollständige Set an verfügbaren Knoten aufgrund von dynamischem Laden, während der Benutzer den Fokus verschiebt oder durch den Baum scrollt, nicht im DOM vorhanden ist, hat jeder Knoten aria-level, aria-setsize und aria-posinset gesetzt.

In einem Menü wird aria-setsize auf alle menuitem, menuitemcheckbox, oder menuitemradio Rollen gesetzt, wobei der Wert die Gesamtanzahl der Elemente im Menü darstellt, exklusive Separatoren.

Beispiel

Das folgende Beispiel zeigt die Elemente 5 bis 8 in einem Set von 16.

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>

Um den Benutzer zu orientieren, würden Unterstützungstechnologien die Bananen oben als "Element 6 von 16" auflisten.

Werte

<integer>

Die Anzahl der Elemente im vollständigen Set oder -1, wenn die Set-Größe unbekannt ist.

Zugehörige Schnittstellen

Element.ariaSetSize

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

ElementInternals.ariaSetSize

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

Zugehörige Rollen

Verwendet in Rollen:

Geerbt in Rollen:

Spezifikationen

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

Siehe auch