aria-posinset

Das Attribut aria-posinset definiert die Nummer oder Position eines Elements in der aktuellen Menge von Listenelementen (listitems) oder Baumelementen (treeitems), 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 der gesamten Menge von Listenelementen oder Baumelementen, wenn nur eine Teilmenge 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 überflüssig wird. Wenn nur ein Teil einer Menge im DOM ist, fügen Sie aria-posinset hinzu, um Informationen über die Position des Elements innerhalb der Menge bereitzustellen, zusammen mit aria-setsize, um dem Benutzer mitzuteilen, wie viele Elemente sich in der gesamten Menge befinden.

Das folgende Beispiel zeigt eine Listbox mit vier Elementoptionen aus den 118 des Periodensystems der chemischen Elemente.

html
<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 der Menge ist, wenn diese Größe bekannt ist.

Hinweis: Wenn Sie aria-posinset verwenden, müssen Sie auch einen Wert für aria-setsize angeben, die die Größe der gesamten Menge darstellt. Wenn die Größe der gesamten Menge 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 jegliche Trennzeichen.

In einem feed, hat jedes <article>-Element aria-posinset mit einem Wert, der seine Position im Feed repräsentiert, zusammen mit aria-setsize, entweder gesetzt auf die Anzahl der geladenen Artikel oder die Gesamtzahl im Feed, 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 ariaPosInSet Eigenschaft, Teil der Element Schnittstelle, spiegelt den Wert des aria-posinset Attributs wider.

ElementInternals.ariaPosInSet

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

Zugehörige Rollen

Verwendet in Rollen:

Erbt in Rollen:

Spezifikationen

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

Siehe auch