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.

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 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 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:

Vererbt in Rollen:

Spezifikationen

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

Siehe auch

aria-setsize