ARIA : attribut aria-posinset
L'attribut aria-posinset définit le numéro ou la position d'un élément dans l'ensemble courant des éléments de liste (listitem) ou d'arbre (treeitem) lorsque tous les éléments ne sont pas présents dans le DOM.
Description
Abréviation de « position dans l'ensemble », l'attribut aria-posinset définit la position de l'élément au sein de l'ensemble complet des éléments de liste (listitem) ou d'arbre (treeitem) lorsque seul un sous-ensemble des éléments est présent dans le DOM.
Si tous les éléments d'une liste sont présents dans le DOM, le navigateur peut calculer le total et la position de chacun, rendant aria-posinset inutile. Lorsque seule une partie de l'ensemble est dans le DOM, il faut inclure aria-posinset pour fournir l'information sur la position de l'élément dans l'ensemble, ainsi que aria-setsize pour indiquer à l'utilisateur·ice combien d'éléments composent l'ensemble complet.
L'exemple suivant montre une liste de sélection avec quatre options parmi les 118 éléments du tableau périodique des éléments chimiques.
<h2 id="periodic-table">Tableau périodique des éléments chimiques</h2>
<ul role="listbox" aria-labelledby="periodic-table">
<li role="option" aria-setsize="118" aria-posinset="1">Hydrogène</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>
La valeur de chaque aria-posinset est un entier supérieur ou égal à 1, et inférieur ou égal à la taille de l'ensemble lorsque celle-ci est connue.
Note :
Lorsque vous utilisez aria-posinset, vous devez également inclure une valeur pour aria-setsize, qui correspond à la taille de l'ensemble complet. Si la taille de l'ensemble complet est inconnue, définissez aria-setsize="-1".
Pour menuitem, menuitemcheckbox ou menuitemradio, la valeur de aria-posinset doit être définie par rapport au nombre total d'éléments du menu, en excluant les séparateurs.
Dans un feed, chaque élément <article> possède un aria-posinset dont la valeur représente sa position dans le fil, avec aria-setsize défini soit sur le nombre d'articles chargés, soit sur le nombre total dans le fil, selon la valeur la plus utile pour les utilisateur·ice·s.
Valeurs
<integer>-
Entier supérieur ou égal à 1, et inférieur ou égal à la valeur de
aria-setsize.
Interfaces associées
Element.ariaPosInSet-
La propriété
ariaPosInSet, qui fait partie de l'interfaceElement, reflète la valeur de l'attributaria-posinset. ElementInternals.ariaPosInSet-
La propriété
ariaPosInSet, qui fait partie de l'interfaceElementInternals, reflète la valeur de l'attributaria-posinset.
Rôles associés
Utilisé dans les rôles :
articleassociationlistitemkeyassociationlistitemvaluecommentlistitemmenuitemoptionradiorowtab
Hérité dans les rôles :
Spécifications
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-posinset |
Voir aussi
- L'attribut ARIA
aria-setsize