Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

ARIA : attribut aria-colindextext

L'attribut aria-colindextext définit une alternative textuelle lisible par humain·e à la valeur numérique de aria-colindex.

Description

Lorsque vous avez un tableau très large ou que vous souhaitez n'afficher qu'une partie d'un tableau, il se peut que toutes les colonnes ne soient pas présentes dans le DOM. Dans ce cas, on utilise aria-colcount avec une valeur entière pour indiquer combien de colonnes le tableau (ou la grille) comporterait si toutes étaient présentes, et on ajoute la propriété aria-colindex sur chaque colonne pour fournir l'indice de colonne dans le tableau complet.

Dans l'exemple HTML suivant, notre tableau comporte 8 colonnes, mais nous n'en affichons que 4. La colonne « Ville » est la cinquième colonne du tableau complet, comme défini par aria-colindex="5".

html
<table aria-colcount="8">
  <thead>
    <tr>
      <th aria-colindex="1" scope="col">Prénom</th>
      <th aria-colindex="2" scope="col">Nom</th>
      <th aria-colindex="5" scope="col">Ville</th>
      <th aria-colindex="7" scope="col">Code postal</th>
    </tr>
  </thead>
  …
</table>

Ce tableau n'est pas très complexe. S'il s'agissait d'un tableur de plus de 100 colonnes ou d'une grille sans en-têtes de colonnes (comme un échiquier), la valeur fournie ou calculée de aria-colindex pourrait ne pas être parlante ou ne pas refléter l'indice affiché. Dans ce cas, on peut inclure aria-colindextext. Sa valeur est une chaîne de caractères lisible par humain·e, alternative à la valeur numérique de aria-colindex.

html
<table aria-colcount="128">
  <thead>
    <tr>
      <th aria-colindex="1" aria-colindextext="Symbole NYSE" scope="col">
        NYSE
      </th>
      <th aria-colindex="110" aria-colindextext="Valeur début 2021" scope="col">
        01/21
      </th>
      <th aria-colindex="122" aria-colindextext="Valeur début 2022" scope="col">
        01/22
      </th>
      <th aria-colindex="124" scope="col">Recommandation</th>
    </tr>
  </thead>
  …
</table>

Dans l'exemple ci-dessus, le tableau comporte 128 colonnes dont seulement 4 sont affichées. L'attribut aria-colindextext est utilisé sur trois colonnes pour fournir une alternative textuelle lisible. En incluant aria-colindextext="Valeur début 2021", les technologies d'assistance peuvent annoncer « Valeur début 2021 » au lieu de « Colonne 110 ».

N'utilisez aria-colindextext que lorsque la valeur fournie ou calculée de aria-colindex n'est pas parlante ou ne reflète pas l'indice affiché. Lorsque vous ajoutez aria-colindextext, conservez aussi aria-colindex car certaines technologies d'assistance s'appuient sur l'indice numérique pour suivre la position de l'utilisateur·ice et proposer une navigation alternative dans le tableau.

Note : Alors que aria-colindex peut être ajouté à une ligne lorsque toutes les colonnes présentes sont contiguës (car des valeurs séquentielles peuvent être déduites), aria-colindextext n'est PAS une propriété supportée pour row.

Voir aussi aria-rowindextext.

Valeurs

<string>

L'alternative textuelle lisible par humain·e à la valeur numérique de aria-colindex

Interfaces associées

Element.ariaColIndexText

La propriété ariaColIndexText, qui fait partie de l'interface Element, reflète la valeur de l'attribut aria-colindextext.

ElementInternals.ariaColIndexText

La propriété ariaColIndexText, qui fait partie de l'interface ElementInternals, reflète la valeur de l'attribut aria-colindextext.

Rôles associés

Utilisé dans les rôles :

Hérité par les rôles :

Spécifications

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-colindextext

Voir aussi