L'élément HTML <td>
définit une cellule d'un tableau qui contient des données. Cet élément fait partie du modèle de tableau.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
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 la valeur est 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 interprétées comme valant la valeur par défaut (1).Note : En HTML5 cet attribut ne peut valoir qu'un nombre strictement positif car il ne doit pas être utilisé pour faire chevaucher des cellules. Par ailleurs, Firefox est le seul navigateur supportant la valeur 0 définie par la spécification HTML 4.01. 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 à 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 obsolètes
abbr
Obsolète depuis 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'attributtitle
de la cellule pour représenter le contenu et la cellule elle-même pour représenter le contenu abrégé. align
Obsolète depuis HTML4.01, Obsolète depuis 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 cellulecenter
: le contenu de la cellule est centré horizontalementright
: le contenu de la cellule est aligné à droite de la cellulejustify
: 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 attributschar
etcharoff
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
oujustify
, il faut utiliser la propriété CSStext-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'attributchar
comme valeur de la propriététext-align
. Non implémenté.
axis
Obsolète depuis 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<td>
doit être mis en forme grâce au CSS. Pour fournir un effet semblable à celui achevé par l'attributbgcolor
, il est possible d'utiliser la propriété CSSbackground-color
.
char
Obsolète depuis HTML4.01, Obsolète depuis 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 paschar
, 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
, il faut utiliser CSS3 en attribuant la même valeur à la propriététext-align
.Non implémenté. charoff
Obsolète depuis HTML4.01, Obsolète depuis 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
Obsolète depuis HTML4.01, Obsolète depuis 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 valeurbottom
.bottom
qui placera le texte au plus bas de la cellulemiddle
qui centrera verticalement le texte dans la celluletop
qui placera le texte au plus haut de la cellule.
Note : Cet attribut est obsolète dans le dernier standard, la propriété CSSvertical-align
doit être utilisée à la place. width
Obsolète depuis HTML4.01, Obsolète depuis HTML5- Cet attribut est utilisé afin de définir la largeur recommandée pour une cellule. Les propriétés
cellspacing
etcellpadding
peuvent être utilisées pour ajouter un espace supplémentaire et la largeur de l'élément<col>
peut avoir un effet. En général, si la largeur d'une colonne est trop étroite pour afficher une cellule correctement, elle sera élargie lors de l'affichage.Note : Cet attribut est obsolète dans le dernier standard, la propriété CSSwidth
doit être utilisée à la place.
Exemples
HTML
<table> <tr> <th>Prénom</th><th>Nom</th> </tr> <tr> <td>Jean</td> <td>Biche</td> </tr> <tr> <td>Marcel</td> <td>Patulacci</td> </tr> </table>
Résultat
Note : Pour plus d'exemples, voir la page <table>
.
Résumé technique
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 un élément <td> ou s'il n'y a plus aucune donnée dans 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 | HTMLTableDataCellElement |
Spécifications
Spécification | État | Commentaires |
---|---|---|
HTML Living Standard La définition de 'td element' dans cette spécification. |
Standard évolutif | |
HTML5 La définition de 'td element' dans cette spécification. |
Recommendation |
Compatibilité des navigateurs
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter https://github.com/mdn/browser-compat-data et à nous envoyer unepull request.
Update compatibility data on GitHub
Ordinateur | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
td | Chrome Support complet 1 | Edge Support complet Oui | Firefox Support complet 1 | IE Support complet Oui | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet Oui | Chrome Android Support complet Oui | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet Oui |
abbr | Chrome Support complet 1 | Edge Support complet Oui | Firefox Support complet 1 | IE Support complet Oui | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet Oui | Chrome Android Support complet Oui | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet Oui |
align | Chrome ? | Edge Support complet Oui | Firefox
Aucun support
Non
| IE Support complet Oui | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Firefox Android
Aucun support
Non
| Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
axis | Chrome Support complet 1 | Edge Support complet Oui | Firefox Support complet 1 | IE Support complet Oui | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet Oui | Chrome Android Support complet Oui | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet Oui |
bgcolor | Chrome ? | Edge Aucun support Non | Firefox Aucun support Non | IE Support complet Oui | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Firefox Android Aucun support Non | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
char | Chrome ? | Edge Support complet Oui | Firefox
Aucun support
Non
| IE Support complet Oui | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Firefox Android
Aucun support
Non
| Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
charoff | Chrome ? | Edge Support complet Oui | Firefox
Aucun support
Non
| IE Support complet Oui | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Firefox Android
Aucun support
Non
| Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
colspan | Chrome Support complet 1 | Edge Support complet Oui | Firefox Support complet 1 | IE Support complet Oui | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet Oui | Chrome Android Support complet Oui | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet Oui |
headers | Chrome Support complet 1 | Edge Support complet Oui | Firefox Support complet 1 | IE Support complet Oui | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet Oui | Chrome Android Support complet Oui | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet Oui |
rowspan | Chrome Support complet 1 | Edge Support complet Oui | Firefox Support complet 1 | IE Support complet Oui | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet Oui | Chrome Android Support complet Oui | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet Oui |
scope | Chrome Support complet 1 | Edge Support complet Oui | Firefox Support complet 1 | IE Support complet Oui | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet Oui | Chrome Android Support complet Oui | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet Oui |
valign | Chrome ? | Edge Support complet Oui | Firefox
Aucun support
Non
| IE Support complet Oui | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Firefox Android
Aucun support
Non
| Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
width | Chrome Support complet 1 | Edge Support complet Oui | Firefox Support complet 1 | IE Support complet Oui | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet Oui | Chrome Android Support complet Oui | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet Oui |
Légende
- Support complet
- Support complet
- Aucun support
- Aucun support
- Compatibilité inconnue
- Compatibilité inconnue
- Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
- Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
- Voir les notes d'implémentation.
- Voir les notes d'implémentation.