ARIA : attribut aria-colspan
L'attribut aria-colspan
définit le nombre de colonnes occupées par une cellule ou une cellule de grille (gridcell
) dans un tableau (table
), une grille (grid
) ou une grille arborescente (treegrid
).
Description
Destiné aux cell
et gridcell
qui ne sont pas contenus dans un élément HTML natif <table>
, la valeur de la propriété aria-colspan
définit le nombre de colonnes occupées par une cellule individuelle dans un table
, une grid
ou une treegrid
ARIA.
En HTML, les éléments <th>
et <td>
possèdent l'attribut colspan
. Lorsque vous utilisez un <table>
sémantique, utilisez l'attribut natif colspan
comme prévu. Cet attribut ARIA est destiné aux cellules et cellules de grille qui ne sont pas contenues dans un tableau natif, et sera ignoré s'il est utilisé sur une cellule dans un <table>
.
Note :
La première règle d'utilisation d'ARIA est : si vous pouvez utiliser une fonctionnalité native avec la sémantique et le comportement requis déjà intégrés, au lieu de détourner un élément et d'ajouter un rôle, un état ou une propriété ARIA pour le rendre accessible, faites-le. Utilisez les éléments HTML <table>
, y compris <td>
et <th>
avec l'attribut colspan
, plutôt que des éléments non sémantiques avec des rôles et attributs ARIA dès que possible.
La valeur de aria-colspan
doit être un entier positif. La valeur par défaut ou supposée d'une cellule est 1. Assurez-vous que la valeur indiquée n'entraîne pas le chevauchement de la cellule ou de la cellule de grille avec la suivante sur la même ligne et ne fait pas dépasser la cellule du tableau, de la grille ou de la treegrid contenant.
Exemple
Voici un extrait d'un tableau de scores d'une ligue de bowling. Chaque partie comporte 10 frames, et chaque frame regroupe 3 scores : deux lancers et le total courant. Le 10e (et dernier) frame de chaque partie occupe 4 colonnes au cas où quelqu'un ferait uniquement des strikes.
<div role="grid" aria-rowcount="27">
aria-label="Scores de la ligue de bowling"
<div role="rowgroup">
<div role="row" aria-rowindex="1">
<!--
aria-rowspan et aria-colspan fournissent
aux technologies d'assistance les bonnes informations d'en-tête de cellule
lorsque les cellules d'en-tête couvrent plusieurs lignes ou colonnes.
-->
<span role="columnheader" aria-rowspan="2">Équipe</span>
<span role="columnheader" aria-colspan="2">Joueur·euse</span>
<span role="columnheader" aria-colspan="31">Frames partie 1</span>
<span role="columnheader" aria-colspan="31">Frames partie 2</span>
<span role="columnheader" aria-colspan="31">Frames partie 3</span>
<span role="columnheader" aria-rowspan="2">Total</span>
</div>
<div role="row" aria-rowindex="2">
<span role="columnheader">Nom</span>
<span role="columnheader">Prénom</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
</div>
</div>
<div role="rowgroup">
<div role="row" aria-rowindex="10">
<span role="rowheader" aria-rowspan="3">The Mighty Quokkas</span>
<span role="cell">Henderson</span>
<span role="cell">Alice</span>
<span role="cell">7</span>
<span role="cell">/</span>
<span role="cell">20</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">39</span>
<span role="cell">9</span>
<span role="cell">-</span>
<span role="cell">48</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">76</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">96</span>
<span role="cell">8</span>
<span role="cell">/</span>
<span role="cell">113</span>
<span role="cell">7</span>
<span role="cell">-</span>
<span role="cell">120</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">146</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">166</span>
<span role="cell">6</span>
<span role="cell">/</span>
<span role="cell">X</span>
<span role="cell">186</span>
<span role="cell">7</span>
<span role="cell">2</span>
<span role="cell">9</span>
<span role="cell">6</span>
<span role="cell">-</span>
<span role="cell">15</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">35</span>
<span role="cell">7</span>
<span role="cell">/</span>
…
</div>
<div role="row" aria-rowindex="11">
<span role="cell">McPherson</span>
<span role="cell">Leslie</span>
<span role="cell">9</span>
<span role="cell">-</span>
<span role="cell">9</span>
<span role="cell">8</span>
<span role="cell">1</span>
<span role="cell">18</span>
…
</div>
</div>
</div>
Si nous avions utilisé un <table>
et des éléments de tableau sémantiques, notre balisage aurait été moins verbeux et accessible par défaut.
Valeurs
<integer>
-
Un entier supérieur ou égal à la valeur par défaut 1, définissant le nombre de colonnes occupées par la cellule. La valeur doit être inférieure à celle qui ferait chevaucher la cellule sur la suivante de la même ligne.
Interfaces associées
Element.ariaColSpan
-
La propriété
ariaColSpan
, qui fait partie de l'interface de chaque élément, reflète la valeur de l'attributaria-colspan
, qui définit le nombre de colonnes occupées par une cellule ou une cellule de grille dans un tableau, une grille ou une treegrid.
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-colspan> |
Voir aussi
- L'attribut
colspan
de<th>
et<td>
- La propriété
aria-colindex
- La propriété
aria-rowspan
- ARIA : rôle
cell
- ARIA : rôle
columnheader
- ARIA : rôle
rowheader