integer

aria-posinset

Indique la position numérique d'un élément dans un ensemble, lorsque l'ensemble n'est pas entièrement rendu dans le DOM.

Description

aria-posinset indique la position d’un élément dans son ensemble parent (de 1 à N). Il est utilisé avec aria-setsize pour donner le contexte “élément X sur Y” quand tous les éléments ne sont pas présents dans le DOM — par exemple dans une liste virtualisée qui ne rend que les éléments visibles.

Syntaxe

<li role="option" aria-posinset="3" aria-setsize="100">Élément 3</li>

Exemples

Liste virtualisée (scroll infini) :

<ul role="listbox" aria-label="Résultats (100 éléments)">
  <!-- Seuls les 20 éléments visibles sont dans le DOM -->
  <li role="option" aria-posinset="1" aria-setsize="100">Résultat 1</li>
  <li role="option" aria-posinset="2" aria-setsize="100">Résultat 2</li>
  …
  <li role="option" aria-posinset="20" aria-setsize="100">Résultat 20</li>
</ul>

Notes

Toujours combiner avec aria-setsize : aria-posinset seul n’a pas de sens — fournir systématiquement les deux.

Listes entièrement dans le DOM : si tous les éléments sont présents, les lecteurs d’écran calculent automatiquement la position et la taille — les attributs sont alors superflus.

Valeur de aria-setsize inconnue : si le total est inconnu, utiliser -1 pour aria-setsize.

Support navigateurs