Free scan

Fix "Broken headers attribute reference" in HTML

Why it's a problem

In a complex table, a cell's headers attribute lists the ids of the headers describing it. If an id does not exist in the table (renamed, typo, deleted header), the screen reader reads the value without its header: “1,240” instead of “2026 budget, 1,240”.

How to fix it — HTML

Check that every id in headers matches a header cell (<th>) in the SAME table, and that no cell references itself. For a simple table (one header row and/or column), skip headers entirely: <th scope="col"> and <th scope="row"> are enough.

Avoid
<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>

RGAA criterion 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) ?

How to check: official tests (in French)

  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.

Full page for criterion 5.7 · Official text: Référentiel général d'amélioration de l'accessibilité (RGAA) 4.1, DINUM, Licence Ouverte 2.0.

Check your site in 30 seconds

Conformly detects this kind of issue across all your pages, continuously, and alerts you on every regression.

Free scan