ARIA : attribut aria-setsize

L'attributaria-setsize définit le nombre d'éléments dans l'ensemble courant d'éléments de liste (listitem) ou d'arbre (treeitem) lorsque tous les éléments de l'ensemble ne sont pas présents dans le DOM.

Description

Les navigateurs calculent automatiquement la taille de l'ensemble et la position de chaque élément dans un groupe, comme le nombre de<li> dans une liste, les boutons dans un groupe deboutons radio du même nom, et les<option> dans un<select>. Les technologies d'assistance, comme les lecteurs d'écran, utilisent cette gestion d'état pour annoncer la taille des ensembles à l'utilisateur·ice.

Lorsque le DOM n'est pas complet, le calcul du nombre d'éléments dans un ensemble par le navigateur peut être incorrect. Lorsque seule une partie des éléments, comme des éléments de liste, est chargée dans le DOM, le navigateur calcule le nombre d'éléments uniquement sur ceux présents. L'attributaria-setsize doit être utilisé pour remplacer le comptage erroné du navigateur. Il définit le nombre d'éléments dans l'ensemble courant d'éléments de liste ou d'arbre si l'ensemble complet avait été chargé.

L'attributaria-setsize est défini sur chaque élément, et non sur l'élément conteneur. La valeur est la même pour chaque élément : un entier reflétant le nombre d'éléments dans l'ensemble complet, ou-1 si la taille de l'ensemble est inconnue. Si tous les éléments sont présents dans le DOM, le navigateur peut calculer la taille de l'ensemble et la position de chaque élément, rendantaria-setsize etaria-posinset inutiles.

Les éléments avecaria-setsize incluent généralement aussi l'attributaria-posinset pour indiquer la position de l'élément dans l'ensemble. La valeur dearia-posinset est comprise entre1 et la valeur positive dearia-setsize.

Par exemple, dans la section des commentaires d'une page, lorsque tous les commentaires ne sont pas dans le DOM (pagination), le niveau, le nombre total de commentaires et la position de chaque commentaire doivent être définis avec ARIA. Le niveau hiérarchique des commentaires peut être indiqué avecaria-level. Les informations de position dans le groupe sont indiquées avecaria-posinset etaria-setsize.

Quand un fil d'actualité a un nombre d'articles statique,aria-setsize peut être ajouté à chaque élément article avec la valeur correspondant soit au nombre total d'articles chargés, soit au nombre total dans le fil. La valeur choisie dépend de celle qui est la plus utile pour les utilisateur·ice·s. Si le nombre d'articles est très grand, indéfini ou change souvent, utilisezaria-setsize="-1" pour indiquer que la taille de l'ensemble est inconnue.

Dans unlistbox, lorsque l'ensemble complet des options disponibles n'est pas présent dans le DOM à cause d'un chargement dynamique au défilement,aria-setsize etaria-posinset peuvent être définis sur chaqueoption.

Dans une vue arborescente, si l'ensemble complet des nœuds disponibles n'est pas présent dans le DOM à cause d'un chargement dynamique lors du déplacement du focus ou du défilement, chaque nœud doit avoiraria-level,aria-setsize etaria-posinset.

Dans un menu,aria-setsize est défini sur tous les rôlesmenuitem,menuitemcheckbox oumenuitemradio, avec la valeur correspondant au nombre total d'éléments du menu, hors séparateurs.

Exemple

L'exemple suivant montre les éléments 5 à 8 dans un ensemble de 16.

html

<h2>Fruits disponibles</h2><ul role="listbox" aria-labelledby="label_fruit">  <li role="option" aria-setsize="16" aria-posinset="5">pommes</li>  <li role="option" aria-setsize="16" aria-posinset="6">bananes</li>  <li role="option" aria-setsize="16" aria-posinset="7">melons</li>  <li role="option" aria-setsize="16" aria-posinset="8">dattes</li></ul>

Pour orienter l'utilisateur·ice, les technologies d'assistance annonceraient « élément 6 sur 16 » pour les bananes ci-dessus.

Valeurs

<integer>: Le nombre d'éléments dans l'ensemble complet, ou-1 si la taille de l'ensemble est inconnue.

Interfaces associées

Element.ariaSetSize: La propriétéariaSetSize, qui fait partie de l'interfaceElement, reflète la valeur de l'attributaria-setsize.
ElementInternals.ariaSetSize: La propriétéariaSetSize, qui fait partie de l'interfaceElementInternals, reflète la valeur de l'attributaria-setsize.