aria-posinset
Das Attribut aria-posinset
definiert die Nummer oder Position eines Elements im aktuellen Satz von Listenelementen oder Baumelementen, wenn nicht alle Elemente im DOM vorhanden sind.
Beschreibung
Kurz für "Position im Satz" definiert das Attribut aria-posinset
die Position des Elements innerhalb des gesamten Satzes von Listenelementen oder Baumelementen, wenn nur eine Teilmenge der Elemente im DOM vorhanden ist.
Wenn alle Elemente in einer Liste im DOM vorhanden sind, kann der Browser die Gesamtzahl und die Position jedes Elements berechnen, wodurch aria-posinset
überflüssig wird. Wenn nur ein Teil eines Satzes im DOM ist, verwenden Sie aria-posinset
, um Informationen über die Position des Elements im Satz bereitzustellen, zusammen mit aria-setsize
, um den Benutzer darüber zu informieren, wie viele Elemente im gesamten Satz sind.
Das folgende Beispiel zeigt eine Auswahlbox mit vier Elementoptionen von insgesamt 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 Ganzzahl, 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
einschließen, 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 Gesamtanzahl der Elemente im Menü, ohne Trennzeichen.
In einem feed
hat jedes <article>
-Element aria-posinset
auf einen Wert gesetzt, der seine Position im Feed darstellt, zusammen mit aria-setsize
, das entweder die Anzahl der geladenen Artikel oder die Gesamtzahl im Feed angibt, je nachdem, welcher Wert für die Benutzer am hilfreichsten ist.
Werte
<integer>
-
Eine Ganzzahl, die größer oder gleich 1 und kleiner oder gleich dem Wert von
aria-setsize
ist.
Zugehörige Schnittstellen
Element.ariaPosInSet
-
Die
ariaPosInSet
-Eigenschaft, Teil derElement
-Schnittstelle, gibt den Wert desaria-posinset
-Attributs wieder. ElementInternals.ariaPosInSet
-
Die
ariaPosInSet
-Eigenschaft, Teil derElementInternals
-Schnittstelle, gibt den Wert desaria-posinset
-Attributs wieder.
Zugehörige Rollen
Verwendet in Rollen:
article
associationlistitemkey
associationlistitemvalue
comment
listitem
menuitem
option
radio
row
tab
Erbt in Rollen:
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-posinset |