Balise HTMLTableaux

<th>

Une cellule d’en-tête de tableau : le nom d’une colonne ou d’une ligne.

Affichage
table-cell
Balise fermante
Obligatoire
Contenu autorisé
Contenu de flux sans titres, éléments de section, <header> ni <footer>
Sur cette page

Exemple

#
HTML
<style>
  table { border-collapse: collapse; }
  th, td { border: 1px solid #8886; padding: 4px 10px; }
</style>
<table>
  <tr>
    <th scope="col">Formation</th>
    <th scope="col">Leçons</th>
    <th scope="col">Résultat du test</th>
  </tr>
  <tr>
    <th scope="row">HTML et CSS</th>
    <td>24</td>
    <td>92 %</td>
  </tr>
  <tr>
    <th scope="row">JavaScript</th>
    <td>32</td>
    <td>78 %</td>
  </tr>
</table>
Aperçu

Définition et utilisation

#

L’élément <th> (de l’anglais table header) est une cellule d’en-tête, c’est-à-dire une description de ce que signifient les données d’une colonne ou d’une ligne. Par défaut, le navigateur met son contenu en gras et le centre horizontalement.

L’attribut scope indique ce à quoi se rapporte l’en-tête : une colonne (col) ou une ligne (row). Grâce à lui, lorsqu’un lecteur d’écran lit une cellule contenant la valeur 92 %, il annonce aussi les en-têtes « Résultat du test » et « HTML et CSS », et pas seulement le nombre.

Dans les tableaux simples, scope suffit. Dans les tableaux complexes, où une cellule dépend de plusieurs en-têtes à la fois, vous la reliez à eux avec l’attribut headers sur <td>, en indiquant les identifiants des <th> concernés.

Syntaxe

#
Syntaxe
<th scope="col">Nom de la colonne</th>

Attributs

#
  • scope

    col | row | colgroup | rowgroup

    Précise à quelles cellules l’en-tête se rapporte : col la colonne située en dessous, row la ligne située à côté, et colgroup et rowgroup tout un groupe de colonnes ou de lignes. Sans cet attribut, le navigateur essaie de deviner, ce qui ne réussit pas toujours.
  • colspan

    nombre positif (1 par défaut)

    Le nombre de colonnes que la cellule occupe. Utile pour un en-tête qui couvre plusieurs colonnes à la fois.
  • rowspan

    nombre non négatif (1 par défaut)

    Le nombre de lignes que la cellule occupe. Un en-tête de ligne étiré sur plusieurs lignes regroupe bien les données liées.
  • abbr

    texte

    Une version plus courte du contenu de l’en-tête. Le lecteur d’écran peut l’utiliser lorsqu’il répète l’en-tête pour les cellules suivantes, par exemple abbr="Prix" pour un en-tête « Prix mensuel TTC ».
  • headers

    liste d’identifiants

    Les identifiants d’autres en-têtes <th> dont dépend cet en-tête, séparés par des espaces. Nécessaire uniquement dans les tableaux complexes avec des en-têtes sur plusieurs niveaux.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

scope

col | row | colgroup | rowgroup

Précise à quelles cellules l’en-tête se rapporte : col la colonne située en dessous, row la ligne située à côté, et colgroup et rowgroup tout un groupe de colonnes ou de lignes. Sans cet attribut, le navigateur essaie de deviner, ce qui ne réussit pas toujours.

HTML
<style>
  table { border-collapse: collapse; }
  th, td { border: 1px solid #8886; padding: 4px 10px; text-align: left; }
</style>
<table>
  <tr><th scope="row">E-mail</th><td>anna@example.com</td></tr>
  <tr><th scope="row">Ville</th><td>Cracovie</td></tr>
  <tr><th scope="row">Niveau</th><td>7</td></tr>
</table>
Aperçu

colspan

nombre positif (1 par défaut)

Le nombre de colonnes que la cellule occupe. Utile pour un en-tête qui couvre plusieurs colonnes à la fois.

HTML
<style>
  table { border-collapse: collapse; }
  th, td { border: 1px solid #8886; padding: 4px 10px; }
</style>
<table>
  <tr>
    <th rowspan="2" scope="col">Élève</th>
    <th colspan="2" scope="col">Résultat du quiz</th>
  </tr>
  <tr>
    <th scope="col">HTML</th>
    <th scope="col">CSS</th>
  </tr>
  <tr><td>Ola</td><td>9/10</td><td>8/10</td></tr>
  <tr><td>Kuba</td><td>7/10</td><td>9/10</td></tr>
</table>
Aperçu

rowspan

nombre non négatif (1 par défaut)

Le nombre de lignes que la cellule occupe. Un en-tête de ligne étiré sur plusieurs lignes regroupe bien les données liées.

HTML
<style>
  table { border-collapse: collapse; }
  th, td { border: 1px solid #8886; padding: 4px 10px; text-align: left; }
</style>
<table>
  <tr><th rowspan="2" scope="row">Module 1</th><td>Balises</td></tr>
  <tr><td>Attributs</td></tr>
  <tr><th rowspan="2" scope="row">Module 2</th><td>Listes</td></tr>
  <tr><td>Tableaux</td></tr>
</table>
Aperçu

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
th {
  display: table-cell;
  padding: 1px;
  font-weight: bold;
  text-align: center;
  vertical-align: inherit;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ne remplacez pas <th> par un <td> en gras. L’aspect sera similaire, mais les technologies d’assistance ne reconnaîtront pas l’en-tête.
  • Les en-têtes de lignes, par exemple les noms de formations dans la première colonne, sont aussi des éléments <th>, simplement avec scope="row".
  • Vous pouvez modifier le centrage par défaut en CSS : th { text-align: start; }.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.