Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
ARIA: aria-posinset Attribut
Dasaria-posinset Attribut definiert die Nummer oder Position eines Elements in der aktuellen Gruppe von Listenelementen oder Baumelementen, wenn nicht alle Elemente im DOM vorhanden sind.
In diesem Artikel
Beschreibung
Kurz für "Position im Satz", dasaria-posinset Attribut definiert die Position des Elements innerhalb der gesamten Gruppe von Listenelementen oder Baumelementen, wenn nur ein Teil der Elemente im DOM vorhanden ist.
Wenn alle Elemente einer Liste im DOM vorhanden sind, kann der Browser die Gesamtzahl und die Position jedes Elements berechnen, wodurcharia-posinset unnötig wird. Wenn nur ein Teil eines Satzes im DOM ist, fügen Siearia-posinset hinzu, um Informationen über die Position des Elements innerhalb des Satzes bereitzustellen, zusammen mitaria-setsize, um den Benutzern mitzuteilen, wie viele Elemente im gesamten Satz sind.
Das folgende Beispiel zeigt ein Listenfeld mit vier Elementoptionen von den 118 im Periodensystem der chemischen Elemente.
<h2>Periodic table of chemical elements</h2><ul role="listbox" aria-labelledby="periodic-table"> <li role="option" aria-setsize="118" aria-posinset="1">Hydrogen</li> <li role="option" aria-setsize="118" aria-posinset="3">Lithium</li> <li role="option" aria-setsize="118" aria-posinset="11">Sodium</li> <li role="option" aria-setsize="118" aria-posinset="19">Potassium</li></ul>Der Wert jedesaria-posinset ist eine ganze Zahl, die größer oder gleich1 und kleiner oder gleich der Größe des Satzes ist, wenn diese Größe bekannt ist.
Hinweis:Wenn Siearia-posinset verwenden, müssen Sie auch einen Wert füraria-setsize angeben, der die Größe des gesamten Satzes ist. Wenn die Größe des gesamten Satzes unbekannt ist, setzen Siearia-setsize="-1".
Fürmenuitem,menuitemcheckbox odermenuitemradio setzen Sie den Wert vonaria-posinset in Bezug auf die Gesamtzahl der Elemente im Menü, ohne Trennzeichen.
In einemfeed hat jedes<article> Elementaria-posinset zu einem Wert, der seine Position im Feed darstellt, zusammen mitaria-setsize, das entweder auf die Anzahl der geladenen Artikel oder die Gesamtzahl im Feed gesetzt ist, abhängig davon, welcher Wert für die Benutzer am hilfreichsten ist.
Werte
<integer>Ganzzahl größer oder gleich 1 und kleiner oder gleich dem Wert von
aria-setsize.
Zugehörige Schnittstellen
Element.ariaPosInSetDie
ariaPosInSetEigenschaft, Teil derElementSchnittstelle, spiegelt den Wert desaria-posinsetAttributs wider.ElementInternals.ariaPosInSetDie
ariaPosInSetEigenschaft, Teil derElementInternalsSchnittstelle, spiegelt den Wert desaria-posinsetAttributs wider.
Zugehörige Rollen
Verwendet in Rollen:
Vererbt in Rollen:
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-posinset> |