ARIA: aria-posinset Attribut
Das aria-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.
Beschreibung
Kurz für "Position im Satz", das aria-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, wodurch aria-posinset unnötig wird. Wenn nur ein Teil eines Satzes im DOM ist, fügen Sie aria-posinset hinzu, um Informationen über die Position des Elements innerhalb des Satzes bereitzustellen, zusammen mit aria-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 id="periodic-table">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 jedes aria-posinset ist eine ganze Zahl, die größer oder gleich 1 und kleiner oder gleich der Größe des Satzes ist, wenn diese Größe bekannt ist.
Hinweis:
Wenn Sie aria-posinset verwenden, müssen Sie auch einen Wert für aria-setsize angeben, der die Größe des gesamten Satzes ist. Wenn die Größe des gesamten Satzes unbekannt ist, setzen Sie aria-setsize="-1".
Für menuitem, menuitemcheckbox oder menuitemradio setzen Sie den Wert von aria-posinset in Bezug auf die Gesamtzahl der Elemente im Menü, ohne Trennzeichen.
In einem feed hat jedes <article> Element aria-posinset zu einem Wert, der seine Position im Feed darstellt, zusammen mit aria-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.ariaPosInSet-
Die
ariaPosInSetEigenschaft, Teil derElementSchnittstelle, spiegelt den Wert desaria-posinsetAttributs wider. ElementInternals.ariaPosInSet-
Die
ariaPosInSetEigenschaft, Teil derElementInternalsSchnittstelle, spiegelt den Wert desaria-posinsetAttributs wider.
Zugehörige Rollen
Verwendet in Rollen:
articleassociationlistitemkeyassociationlistitemvaluecommentlistitemmenuitemoptionradiorowtab
Vererbt in Rollen:
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-posinset |