Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
ARIA: aria-setsize-Attribut
Dasaria-setsize-Attribut definiert die Anzahl der Elemente im aktuellen Satz von Listenelementen oder Baumelementen, wenn nicht alle Elemente des Satzes im DOM vorhanden sind.
Beschreibung
Browser berechnen automatisch die Satzgröße und Position für jedes Element in einer Gruppe von Elementen, wie z. B. die Anzahl der<li>s in einer Liste, Schaltflächen in einer gleichnamigen Gruppe vonRadio-Buttons und<option>s in einem<select>. Hilfstechnologien, wie Bildschirmleseprogramme, nutzen diesen Zustandsverwaltungsmechanismus, um dem Benutzer die Größe der Sätze zu melden.
Wenn das DOM nicht vollständig ist, kann die Browserberechnung der Anzahl der Elemente in einem Satz inkorrekt sein. Wenn nur ein Teil der Elemente, wie Listenelemente, ins DOM geladen wird, berechnet der Browser die Anzahl der Elemente nur auf Basis der vorhandenen. Dasaria-setsize-Attribut sollte verwendet werden, um die inkorrekte Zählung des Browsers zu überschreiben. Es definiert die Anzahl der Elemente im aktuellen Satz von Listenelementen oder Baumelementen, wenn der gesamte Satz geladen worden wäre.
Dasaria-setsize-Attribut wird auf jedes Element gesetzt, statt auf ein enthaltendes Element. Der Wert ist für jedes Element gleich: eine ganze Zahl, die die Anzahl der Elemente im vollständigen Satz widerspiegelt, oder-1, wenn die Satzgröße unbekannt ist. Wenn alle Elemente im DOM vorhanden sind, kann der Browser die Satzgröße und die Position jedes Elements berechnen, wodurch sowohlaria-setsize als aucharia-posinset unnötig werden.
Elemente mit demaria-setsize-Attribut haben in der Regel auch dasaria-posinset-Attribut enthalten, um die Position dieses Elements innerhalb des Satzes anzuzeigen. Deraria-posinset-Wert liegt zwischen1 und dem positiven Wert vonaria-setsize.
Zum Beispiel, in einem Kommentarbereich einer Seite, wenn nicht alle Kommentare im DOM sind, wie z.B. bei paginierten Kommentaren, sollten die Ebene, die Gesamtanzahl der Kommentare und die Position jedes Kommentars mit ARIA festgelegt werden. Die hierarchische Ebene von Kommentaren kann mitaria-level angezeigt werden. Die Gruppenpositionsinformation wird mitaria-posinset undaria-setsize angegeben.
Wenn ein Feed eine feste Anzahl von Artikeln hat, kannaria-setsize zu jedem Artikelelelement hinzugefügt werden, wobei der Wert entweder die insgesamt geladenen Artikel oder die Gesamtanzahl der Artikel im Feed sind. Der gewählte Wert hängt davon ab, welcher Wert für Benutzer am hilfreichsten ist. Wenn die Anzahl der Artikel extrem groß, unbestimmt oder oft wechselnd ist, kannaria-setsize="-1" gesetzt werden, um zu signalisieren, dass die Größe des Satzes unbekannt ist.
In einemlistbox, wenn der vollständige Satz der verfügbaren Optionen nicht im DOM vorhanden ist, aufgrund von dynamischem Laden beim Scrollen, können sowohlaria-setsize als aucharia-posinset auf jedemoption gesetzt werden.
In einer Baumansicht (tree view), wenn der vollständige Satz der verfügbaren Knoten nicht im DOM vorhanden ist, aufgrund von dynamischem Laden, während sich der Fokus des Nutzers bewegt oder der Baum gescrollt wird, hat jeder Knotenaria-level,aria-setsize undaria-posinset gesetzt.
In einem Menü wirdaria-setsize auf allemenuitem,menuitemcheckbox odermenuitemradio Rollen gesetzt, wobei der Wert die Gesamtanzahl der Elemente im Menü ohne Separatoren ist.
Beispiel
Das folgende Beispiel zeigt die Elemente 5 bis 8 in einem Satz von insgesamt 16.
<h2>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 Hilfstechnologien die Bananen oben als "Element 6 von 16" auflisten.
Werte
<integer>Die Anzahl der Elemente im vollständigen Satz oder
-1, wenn die Satzgröße unbekannt ist.
Zugehörige Schnittstellen
Element.ariaSetSizeDie
ariaSetSize-Eigenschaft, Teil derElement-Schnittstelle, spiegelt den Wert desaria-setsize-Attributs wider.ElementInternals.ariaSetSizeDie
ariaSetSize-Eigenschaft, Teil derElementInternals-Schnittstelle, spiegelt den Wert desaria-setsize-Attributs wider.
Zugehörige Rollen
Verwendet in Rollen:
Übernimmt in Rollen:
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-setsize |