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.
<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><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)
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 attributidunique ;La balise
<th>possède un attributscope;La balise
<th>possède un attribut WAI-ARIArole="rowheader"ourole="columnheader".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 attributscope, la balise<th>vérifie-t-elle une de ces conditions ?La balise
<th>possède un attributscopeavec la valeur"row"pour les en-têtes de ligne ;La balise
<th>possède un attributscopeavec la valeur"col"pour les en-têtes de colonne.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’attributscope;La balise
<th>ne possède pas d’attribut WAI-ARIArole="rowheader"ourole="columnheader";La balise
<th>possède un attributidunique.Test 5.7.4
Pour chaque contenu de balise
<td>ou<th>associée à un ou plusieurs en-têtes possédant un attributid, la balise vérifie-t-elle ces conditions ?La balise possède un attribut
headers;L’attribut
headerspossède la liste des valeurs d’attributiddes en-têtes associés.Test 5.7.5
Pour chaque balise pourvue d’un attribut WAI-ARIA
role="rowheader"ourole="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