ARIA : attribut aria-rowindextext - ARIA

Description

Lorsque vous avez un tableau très long ou que vous souhaitez afficher uniquement une section d'un tableau, toutes les lignes ne sont pas forcément présentes dans le DOM. Dans ce cas, on utilise aria-rowcount avec une valeur entière pour définir le nombre de lignes que le tableau (ou la grille) aurait si toutes les lignes étaient présentes, et on ajoute la propriété aria-rowindex sur chaque ligne et cellule étendue pour indiquer l'index de la ligne dans le tableau complet. Lorsque la valeur de aria-rowindex n'est pas parlante ou ne reflète pas l'index affiché, on peut aussi ajouter aria-rowindextext pour fournir une alternative textuelle lisible à la valeur entière de aria-rowindex.

aria-rowindextext doit être utilisé en complément de aria-rowindex, jamais en remplacement. Certaines technologies d'assistance utilisent l'index numérique pour suivre la position de l'utilisateur·ice ou proposer une navigation alternative dans le tableau. aria-rowindextext est utile si la valeur entière n'est pas parlante ou ne reflète pas l'index affiché, comme dans un jeu d'échecs ou de bataille navale.

aria-rowindextext s'ajoute à chaque <tr> ou aux éléments avec le rôle row. Il peut aussi être ajouté aux cellules ou aux éléments enfants de chaque ligne.

Valeurs

<string>: Alternative textuelle lisible par l'humain à la valeur numérique de aria-rowindex.

Interfaces associées

Element.ariaRowIndexText: La propriété ariaRowIndexText, qui fait partie de l'interface Element, reflète la valeur de l'attribut aria-rowindextext.
ElementInternals.ariaRowIndexText: La propriété ariaRowIndexText, qui fait partie de l'interface ElementInternals, reflète la valeur de l'attribut aria-rowindextext.