Free scan

Fix "Table header without data cells" in HTML

Why it's a problem

A <th> must describe data. A header column with no data, or a table made only of <th>, breaks navigation: the screen reader announces headers that relate to nothing and the user can no longer link values to their meaning.

How to fix it — HTML

Remove header rows or columns that have no data, or fill them. If a cell holds data rather than a label, it is a <td>. If the table is only there for layout, replace it with CSS (grid or flex).

Avoid
<table>
  <tr><th>Offre</th><th>Prix</th><th>Remarques</th></tr>
  <tr><th>Gratuit</th><th>0 €</th></tr>
  <tr><th>Pro</th><th>29 €</th></tr>
</table>
Correct
<table>
  <tr><th scope="col">Offre</th><th scope="col">Prix</th></tr>
  <tr><th scope="row">Gratuit</th><td>0 €</td></tr>
  <tr><th scope="row">Pro</th><td>29 €</td></tr>
</table>

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