<tr>

L'élément HTML <tr> définit une ligne de cellules dans un tableau. Une ligne peut être constitué d'éléments <td> et <th>.

Catégories de contenu Aucune.
Contenu autorisé Zéro ou plusieurs éléments <td> ou <th>, éventuellement mélangés.
Omission de balises La balise de début est obligatoire. La balise de fin peut être absente si l'élément <tr> est immédiatement suivi par un élément <tr> ou si l'élément du groupe parent ((<thead>, <tbody> ou <tfoot>) n'a plus d'autre contenu.
Parents autorisés Un élément <table>, <thead>, <tbody> ou <tfoot>.
Rôles ARIA autorisés Tous les rôles sont autorisés.
Interface DOM HTMLTableRowElement

Attributs

À l'instar de tous les éléments HTML, cet élément inclut les attributs universels.

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

align Obsolète depuis HTML4.01, Obsolète depuis HTML5
Cet attribut à valeurs définit l'alignement horizontal pour le contenu de chaque cellule. 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 est héritée du nœud parent.

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é.
bgcolor Obsolète depuis HTML4.01, Obsolète depuis HTML5
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 <tr> 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 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 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, 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 ligne. 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>
  <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>.

Spécifications

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

Compatibilité des navigateurs

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Support simple 1.0 (Oui) 1.0 (1.7 ou moins) (Oui) (Oui) (Oui)
Attribut align/valign 1.0 ? Pas de support [1] (Oui) (Oui) (Oui)
Attribut char/charoff 1.0 ? Pas de support [2] (Oui) (Oui) (Oui)
Attribut bgcolor Pas de support ? Pas de support (Oui) Pas de support Pas de support
Fonctionnalité Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) 1.0 (1.0) (Oui) (Oui) (Oui)
Attribut align/valign ? ? Pas de support [1] ? ? ?
Attribut char/charoff ? ? Pas de support [2] ? ? ?
Attribut bgcolor Pas de support ? Pas de support (Oui) Pas de support Pas de support

[1] Cf. bug 915.

[2] Cf. bug 2212.

Voir aussi

  • Les autres éléments HTML relatifs aux tableaux : <caption>, <col>, <colgroup>, <table>, <tbody>, <td>, <tfoot>, <th>, <thead>.
  • Les propriétés et pseudo-classes CSS qui sont particulièrement utiles pour mettre en forme l'élément <tr> :
    • La pseudo-classe :nth-child qui permet de définir l'alignement des cellules dans la colonne
    • La propriété text-align qui permet d'aligner l'ensemble des cellules par rapport au même caractère (comme le point ou la virgule).

Étiquettes et contributeurs liés au document

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