<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>
Exemple
#<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>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
#<th scope="col">Nom de la colonne</th>Attributs
#col | row | colgroup | rowgroup
Précise à quelles cellules l’en-tête se rapporte :colla colonne située en dessous,rowla ligne située à côté, etcolgroupetrowgrouptout un groupe de colonnes ou de lignes. Sans cet attribut, le navigateur essaie de deviner, ce qui ne réussit pas toujours.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.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 exempleabbr="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 | rowgroupPré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.
<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>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.
<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>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.
<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>CSS par défaut
#La plupart des navigateurs affichent cet élément avec ces styles par défaut :
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 avecscope="row". - Vous pouvez modifier le centrage par défaut en CSS :
th { text-align: start; }.
Entrées associées
#- <td>Une cellule de tableau ordinaire contenant des données.
- <tr>Une ligne de tableau, qui contient des cellules `<th>` et `<td>`.
- <thead>Un groupe de lignes contenant les en-têtes de colonnes du tableau.
- <table>Un tableau de données organisées en lignes et en colonnes.
- <caption>Le titre d’un tableau, placé comme premier élément à l’intérieur de `<table>`.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.