<td> : l'élément de cellule de tableau

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

L'élémentHTML<td> définit une cellule d'un tableau qui contient des données. Cet élément fait partie dumodèle de tableau.

Exemple interactif

<table>  <caption>    Alien football stars  </caption>  <tr>    <th scope="col">Player</th>    <th scope="col">Gloobles</th>    <th scope="col">Za'taak</th>  </tr>  <tr>    <th scope="row">TR-7</th>    <td>7</td>    <td>4,569</td>  </tr>  <tr>    <th scope="row">Khiresh Odo</th>    <td>7</td>    <td>7,223</td>  </tr>  <tr>    <th scope="row">Mia Oolong</th>    <td>9</td>    <td>6,219</td>  </tr></table>

th,td {  border: 1px solid rgb(160 160 160);  padding: 8px 10px;}th[scope="col"] {  background-color: #505050;  color: #fff;}th[scope="row"] {  background-color: #d6ecd4;}td {  text-align: center;}tr:nth-of-type(even) {  background-color: #eee;}table {  border-collapse: collapse;  border: 2px solid rgb(140 140 140);  font-family: sans-serif;  font-size: 0.8rem;  letter-spacing: 1px;}caption {  caption-side: bottom;  padding: 10px;}

Catégories de contenu	Racine de section.
Contenu autorisé	Contenu de flux.
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`<td>` ou s'il n'y a plus aucune donnée dans l'élément parent.
Parents autorisés	Un élément`<tr>`.
Rôle ARIA implicite	`cell` si l'élément est un descendant d'un élément`<table>`.
Rôles ARIA autorisés	Tous les rôles sont autorisés.
Interface DOM	`HTMLTableDataCellElement`

Attributs

Cet élément inclutles 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. Des valeurs supérieures à 1000 peuvent être considérées comme incorrectes et seront interprétées comme valant la valeur par défaut (1).
headers: Cet attribut est une liste de chaînes de caractères séparées par des espaces. Chacune correspond à l'attributid de l'élément<th> qui s'applique à la cellule courante.
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 sont ramenées à 65534.

Attributs dépréciés

abbrObsolète

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'attributtitle de la cellule pour représenter le contenu et la cellule elle-même pour représenter le contenu abrégé.

alignObsolète

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 aligné à 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: S'applique uniquement au texte. Insère des espaces dans le contenu textuel afin que le contenu de la cellule soit justifié.
char: S'applique uniquement au texte. Aligne le contenu textuel de la cellule selon un caractère spécial avec un décalage minimum définis par les attributschar etcharoff

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

Note :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 valeursleft,center,right oujustify, il faut utiliser la propriété CSStext-align sur l'élément
Pour réaliser le même effet qu'avec la valeurchar. Il est possible, en CSS3, d'utiliser la valeur de l'attributchar comme valeur de la propriététext-align (non implémenté à date).

axisObsolète

Cet attribut contient une liste de chaînes 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.

bgcolorNon standard

Cet attribut définit la couleur d'arrière-plan de chaque cellule dans une colonne. Sa valeur estun code hexadécimal RGB sur 6 chiffres, préfixé d'un '#' ou un desmots-clés de couleurs prédéfinis.

Pour réaliser un effet équivalent, on utilisera plutôt la propriété CSSbackground-color.

charObsolète

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'attributalign ne vaut paschar, l'attribut est ignoré.

charoffObsolète

Cet attribut est utilisé pour indiquer le décalage, en nombre de caractères, depuis le caractère défini par l'attributchar à appliquer au contenu des cellules.

heightObsolète

Cet attribut définit une hauteur de cellule recommandée. On utilisera plutôt la propriété CSSheight.

scopeObsolète

Cet attribut à valeurs énumérées définit les cellules qui sont liées à l'en-tête défini par l'élément<th>. À utiliser uniquement avec l'élément<th> pour définir la ligne ou la colonne pour laquelle il est son en-tête.

valignObsolète

Cet attribut définit l'alignement vertical du texte des cellules de la colonne. Les valeurs possibles de cet attribut sont :

baseline: Aligne le texte à la ligne la plus basse possible en utilisant laligne de base des caractères. Si les caractères ont tous la même taille, cela aura le même effet que la valeurbottom.
bottom: Place le texte au plus bas de la cellule.
middle: Centre verticalement le texte dans la cellule.
top: Place le texte au plus haut de la cellule.

On utilisera plutôt la propriété CSSvertical-align à la place.

widthObsolète