Scan gratuit

Corriger « Attribut headers mal référencé » en HTML

Pourquoi c'est un problème

Dans un tableau complexe, l'attribut headers d'une cellule liste les id des en-têtes qui la décrivent. Si un id n'existe pas dans le tableau (renommé, faute de frappe, en-tête supprimé), le lecteur d'écran lit la valeur sans son en-tête : « 1 240 » au lieu de « Budget 2026, 1 240 ».

Comment corriger — HTML

Vérifiez que chaque id cité dans headers correspond à une cellule d'en-tête (<th>) du MÊME tableau, et qu'une cellule ne se cite pas elle-même. Pour un tableau simple (une ligne et/ou une colonne d'en-têtes), inutile d'utiliser headers : <th scope="col"> et <th scope="row"> suffisent.

À éviter
<table>
  <tr><th id="poste">Poste</th><th id="budget-2026">Budget 2026</th></tr>
  <tr><th id="audit">Audit</th><td headers="audit budget2026">1 240</td></tr>
</table>
Correct
<table>
  <tr><th id="poste">Poste</th><th id="budget-2026">Budget 2026</th></tr>
  <tr><th id="audit">Audit</th><td headers="audit budget-2026">1 240</td></tr>
</table>

<!-- Tableau simple : scope suffit, pas besoin de headers -->
<tr><th scope="row">Audit</th><td>1 240</td></tr>

Critère RGAA 5.7 — Tableaux

Pour chaque tableau de données, la technique appropriée permettant d’associer chaque cellule avec ses en-têtes est-elle utilisée (hors cas particuliers) ?

Comment vérifier : tests officiels

  1. Test 5.7.1

    Pour chaque contenu de balise <th> s’appliquant à la totalité de la ligne ou de la colonne, la balise <th> respecte-t-elle une de ces conditions (hors cas particuliers) ?

    La balise <th> possède un attribut id unique ;

    La balise <th> possède un attribut scope ;

    La balise <th> possède un attribut WAI-ARIA role="rowheader" ou role="columnheader".

  2. Test 5.7.2

    Pour chaque contenu de balise <th> s’appliquant à la totalité de la ligne ou de la colonne et possédant un attribut scope, la balise <th> vérifie-t-elle une de ces conditions ?

    La balise <th> possède un attribut scope avec la valeur "row" pour les en-têtes de ligne ;

    La balise <th> possède un attribut scope avec la valeur "col" pour les en-têtes de colonne.

  3. Test 5.7.3

    Pour chaque contenu de balise <th> ne s’appliquant pas à la totalité de la ligne ou de la colonne, la balise <th> vérifie-t-elle ces conditions ?

    La balise <th> ne possède pas d’attribut scope ;

    La balise <th> ne possède pas d’attribut WAI-ARIA role="rowheader" ou role="columnheader" ;

    La balise <th> possède un attribut id unique.

  4. Test 5.7.4

    Pour chaque contenu de balise <td> ou <th> associée à un ou plusieurs en-têtes possédant un attribut id, la balise vérifie-t-elle ces conditions ?

    La balise possède un attribut headers ;

    L’attribut headers possède la liste des valeurs d’attribut id des en-têtes associés.

  5. Test 5.7.5

    Pour chaque balise pourvue d’un attribut WAI-ARIA role="rowheader" ou role="columnheader" dont le contenu s’applique à la totalité de la ligne ou de la colonne, la balise vérifie-t-elle une de ces conditions ?

    La balise possède un attribut WAI-ARIA role="rowheader" pour les en-têtes de ligne ;

    La balise possède un attribut WAI-ARIA role="columnheader" pour les en-têtes de colonne.

Fiche complète du critère 5.7 · Texte officiel : Référentiel général d'amélioration de l'accessibilité (RGAA) 4.1, DINUM, Licence Ouverte 2.0.

Vérifiez votre site en 30 secondes

Conformly détecte ce type de problème sur toutes vos pages, en continu, et vous alerte à chaque régression.

Scan gratuit