integer

aria-setsize

Indique le nombre total d'éléments dans un ensemble, lorsque l'ensemble n'est pas entièrement rendu dans le DOM.

Description

aria-setsize précise la taille totale d’un ensemble d’éléments (liste, arborescence…). Utilisé conjointement avec aria-posinset, il permet aux AT d’annoncer “élément 3 sur 100” même quand seuls certains éléments sont rendus dans le DOM.

Syntaxe

<li role="treeitem" aria-level="1" aria-setsize="5" aria-posinset="2">
  Deuxième nœud
</li>

Exemples

Pagination de résultats chargés dynamiquement :

<ul role="listbox" aria-label="Contacts">
  <li role="option" aria-setsize="250" aria-posinset="1">Alice Martin</li>
  <li role="option" aria-setsize="250" aria-posinset="2">Bob Durand</li>
  <li role="option" aria-setsize="250" aria-posinset="3">Caroline Lefèvre</li>
</ul>

Taille inconnue :

<li role="option" aria-setsize="-1" aria-posinset="5">
  Résultat 5 (total inconnu)
</li>

Notes

Valeur -1 pour taille inconnue : si le nombre total d’éléments n’est pas connu au moment du rendu (chargement progressif), utiliser -1.

Toujours combiner avec aria-posinset : les deux attributs sont conçus pour fonctionner ensemble — ne pas utiliser l’un sans l’autre.

Inutile si DOM complet : les lecteurs d’écran calculent automatiquement setsize et posinset quand tous les enfants sont dans le DOM.

Support navigateurs