L'élément HTML <th> définit une cellule d'un tableau comme une cellule d'en-tête pour un groupe de cellule. La nature de ce groupe est définie grâce aux attributs scope et headers.

Catégories de contenu Aucune.
Contenu autorisé
Contenu de flux sans titre, pied de page, contenu sectionnant ou descendants d'un élément de titre.
Omission de balises La balise de début est obligatoire. La balise de fin peut être absente si l'élément est immédiatement suivi par un élément <th> ou par un élément <td> ou s'il n'y a plus de contenu au sein de l'élément parent.
Parents autorisés Un élément <tr>.
Rôles ARIA autorisés Tous les rôles sont autorisés.
Interface DOM HTMLTableHeaderCellElement

Attributs

Cet élément inclut les attributs universels.

colspan
Cet attribut contient un entier positif indiquant le nombre de colonnes sur lesquelles s'étend la cellule. La valeur par défaut est 1. Si cet attribut vaut 0, la cellule s'étend jusqu'à la fin du  <colgroup> auquel appartient la cellule, même si celui-ci est défini implicitement. Des valeurs supérieures à 1000 peuvent être considérées comme incorrectes et seront écrétées à 1000.
headers
Cet attribut est une liste de chaînes de caractères séparées par des espace. Chacune correspond à l'attribut id de l'élément <th> qui s'applique à cet élément.
rowspan
Cet attribut contient un entier positif indiquant sur combien de lignes s'étend la cellule. La valeur par défaut est 1. Si cet attribut vaut 0, la cellule s'étend jusqu'à la fin de la section (<thead>, <tbody>, <tfoot> du tableau à laquelle appartient la cellule même si cette section est définie implicitement. Les valeurs supérieures à 65534 seront ramenées à 65534.
scope
Cet attribut référence les cellules auxquelles l'élément <th> est lié. Cet attribut est un attribut à valeur contrainte qui peut prendre les valeurs suivantes :
  • row, ce qui signifie que l'en-tête s'applique à toutes les cellules de la ligne à laquelle appartient cet élément
  • col, ce qui signifie que l'en-tête s'applique à toutes les cellules de la colonne à laquelle appartient cet élément
  • rowgroup, ce qui signifie que l'en-tête s'applique à toutes les cellules restantes dans la ligne à laquelle appartient cet élément. Les cellules restants sont soit celles à droite de l'élément, soit celles à gauche selon la valeur de l'attribut dir
  • colgroup, ce qui signifie que l'en-tête s'applique à toutes les cellules restantes dans la colonne à laquelle appartient cet élément.
  • auto

Attributs dépréciés ou obsolètes

abbr en HTML5
Cet attribut contient une description courte et abrégée du contenu de la cellule. Certains outils utilisateurs, comme la synthèse vocale, peuvent décrire cette information avant le contenu lui-même.
Note : Cet attribut est obsolète dans le dernier standard et ne doit donc plus être utilisé. Il faut dans ces cas introduire la description au sein de la cellule comme un élément <abbr> indépendant ou utiliser l'attribut title de la cellule pour représenter le contenu et la cellule elle-même pour représenter le contenu abrégé.
align en HTML 4, en HTML5
Cet attribut à valeurs définit l'alignement horizontal pour le contenu de chaque cellule de la colonne. Les valeurs possibles sont :
  • left : le contenu de la cellule est alligné à gauche de la cellule
  • center : le contenu de la cellule est centré horizontalement
  • right : le contenu de la cellule est aligné à droite de la cellule
  • justify : insert des espaces dans le contenu textuel afin que le contenu de la cellule soit justifié
  • char : aligne le contenu textuel de la cellule selon un caractère spécial avec un décalage minimum définis par les attributs  char et charoff Non implémenté (voir bug 2212).

Si cet attribut n'est pas renseigné, la valeur left est prise par défaut.

Notes : Cet attribut est devenu obsolète dans le dernier standard et ne doit donc plus être utilisé.
  • Pour réaliser les mêmes effets que les valeurs left, center, right ou justify, il faut utiliser la propriété CSS text-align sur l'élément
  • Pour réaliser le même effet qu'avec la valeur char. Il est possible, en CSS3, d'utiliser la valeur de l'attribut char comme valeur de la propriété text-align. Non implémenté.
axis en HTML5
Cet attribut contient une liste de chaîne de caractères (séparées par des espaces). Chaque chaîne de caractère est l'identifiant d'un groupe de cellule auquel cet en-tête s'applique.
Note : Cet attribut est obsolète dans le dernier standard et ne doit donc plus être utilisé. L'attribut scope doit être utilisé pour le remplacer.
bgcolor
Cet attribut définit la couleur d'arrière-plan de toutes les cellules de la colonne. C'est un code à 6 chiffres hexadécimaux comme défini par le sRGB. Il est précédé d'un '#'. Un de ces seize mot-clé peut également être utilisé.
  black = "#000000"   green = "#008000"
  silver = "#C0C0C0"   lime = "#00FF00"
  gray = "#808080"   olive = "#808000"
  white = "#FFFFFF"   yellow = "#FFFF00"
  maroon = "#800000"   navy = "#000080"
  red = "#FF0000"   blue = "#0000FF"
  purple = "#800080"   teal = "#008080"
  fuchsia = "#FF00FF"  

aqua = "#00FFFF"

Note d'utilisation : Il est fortement conseillé de ne pas utiliser cet attribut car celui-ci n'est pas un attribut standard et n'a été implémentée que sous certaines versions d'Internet Explorer. L'élément <th> doit être mis en forme grâce au CSS. Pour fournir un effet semblable à celui achevé par l'attribut bgcolor, il est possible d'utiliser la propriété CSS background-color.
char en HTML 4, en HTML5
Cet attribut est utilisé pour définir le caractère sur lequel aligner les cellules d'une colonne. Les valeurs de cet attribut contiennent généralement un point (.) pour aligner des nombres ou des valeurs monétaires. Si l'attribut align ne vaut pas char, l'attribut est ignoré.
Note d'utilisation : Cet attribut est obsolète et il est donc fortement déconseillé de l'utiliser. De fait, il n'est pas supporté par le dernier standard. Pour réaliser le même effet qu'avec char, on peut utiliser CSS3 en attribuant la même valeur à la propriété text-align.Non implémenté.
charoff en HTML 4, en HTML5
Cet attribut est utilisé pour indiquer le décalage, en nombre de caractères, depuis le caractère définit par l'attribut char à appliquer au contenu des cellules.
Note d'utilisation: Cet attribut ne doit plus être utilisé car il est maintenant obsolète et n'est plus supporté dans le dernier standard.
valign en HTML 4, en HTML5
Cet attribut définit l'alignement vertical du texte des cellules de la colonne. Les valeurs possibles de cet attribut sont :
  • baseline qui alignera le texte à la ligne la plus basse possible en utilisant la ligne de base des caractères. Si les caractères ont tous la même taille, cela aura le même effet que la valeur bottom.
  • bottom qui placera le texte au plus bas de la cellule
  • middle qui centrera verticalement le texte dans la cellule
  • top qui placera le texte au plus haut de la cellule.
Note: Cet attribut est obsolète dans le dernier standard, la propriété CSS vertical-align doit être utilisée à la place.

Exemples

HTML

<table>
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
  </tr>
  <tr>
   <td>WHATWG</td>
   <td>Colorad</td>
  </tr>
  <tr>
   <td>W3C</td>
   <td>Wisconsin</td>
  </tr>
 </tbody>
</table>

Résultat

Note : Voir la page <table> pour d'autres exemples.

Spécifications

Spécification État Commentaires
HTML Living Standard
La définition de 'th element' dans cette spécification.
Standard évolutif  
HTML5
La définition de 'th element' dans cette spécification.
Recommendation  

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple1 Oui1 Oui Oui Oui
abbr1 Oui1 Oui Oui Oui
align ? Oui Non1 Oui ? ?
axis1 Oui1 Oui Oui Oui
bgcolor ? Non Non Oui ? ?
char ? Oui Non2 Oui ? ?
charoff ? Oui Non2 Oui ? ?
colspan1 Oui1 Oui Oui Oui
headers1 Oui1 Oui Oui Oui
rowspan1 Oui1 Oui Oui Oui
scope1 Oui1 Oui Oui Oui
valign ? Oui Non1 Oui ? ?
width1 Oui1 Oui Oui Oui
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Support simple Oui Oui Oui4 Oui Oui Oui
abbr Oui Oui Oui4 Oui Oui Oui
align ? ? Oui Non1 Oui ? ?
axis Oui Oui Oui4 Oui Oui Oui
bgcolor ? ? Non Non Oui ? ?
char ? ? Oui Non2 Oui ? ?
charoff ? ? Oui Non2 Oui ? ?
colspan Oui Oui Oui4 Oui Oui Oui
headers Oui Oui Oui4 Oui Oui Oui
rowspan Oui Oui Oui4 Oui Oui Oui
scope Oui Oui Oui4 Oui Oui Oui
valign ? ? Oui Non1 Oui ? ?
width Oui Oui Oui4 Oui Oui Oui

1. See bug 915

2. See bug 2212

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, tregagnon
 Dernière mise à jour par : SphinxKnight,