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.

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 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 der Element-Schnittstelle, gibt den Wert des aria-posinset-Attributs wieder.

ElementInternals.ariaPosInSet

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

Zugehörige Rollen

Spezifikationen

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

Siehe auch