L'élément HTML <caption> représente la légende (ou le titre) d'un tableau. Il doit être le première élément parmi les descendants de l'élément <table>. La mise en forme CSS peut placer cet élément à un autre endroit par rapport au tableau et on pourra notamment utiliser les propriétés caption-side et text-align.

Catégories de contenu Aucune.
Contenu autorisé Catégorie de flux.
Omission de balises La balise de fin peut être absente si l'élément n'est pas immédiatement suivi d'un blanc ASCII ou d'un commentaire.
Éléments parents autorisés Un élément <table> dont il doit être le premier descendant.
Rôles ARIA autorisés Aucun.
Interface DOM HTMLTableCaptionElement

Attributs

On peut utiliser les attributs universels sur cet élément.

Attributs obsolètes

align Obsolète depuis HTML4.01 Obsolète depuis HTML5
Cet attribut à valeur contrainte indique l'alignement de la légende du tableau par rapport au tableau lui-même. Il peut valoir :
  • left pour un affichage à gauche du tableau
  • top pour un affichage au dessus du tableau
  • right pour un affichage à droite du tableau
  • bottom pour un affichage en dessous du tableau
Note d'utilisation : Ne pas utiliser cet attribut. Il a été déprécié. L'élément <caption> devrait être mis en forme grâce au CSS. Afin d'obtenir des effets similaires à cet attribut, on utilisera les propriétés CSS caption-side et text-align.

Notes d'utilisation

Quand l'élément <table> (étant le parent de l'élément <caption>) n'est que l'unique descendant d'un élément <figure>,c'est l'élément <figcaption> doit être utilisé.

Exemples

HTML

<table>
  <caption>Une légende pour un tableau</caption>
  <tr>
    <td>Bip bop bip bop</td>
    <td>Bop bip bop bip</td>
  </tr>
</table>

CSS

caption { 
  caption-side: top;
  align: right;
}
table { 
  border-collapse: collapse;
  border-spacing: 0px; 
}
table, th, td { 
  border: 1px solid black; 
}

Résultat

Spécifications

Spécification État Commentaires
HTML Living Standard
La définition de '<caption>' dans cette spécification.
Standard évolutif  
HTML5
La définition de '<caption>' dans cette spécification.
Recommendation  
HTML 4.01 Specification
La définition de '<caption>' dans cette spécification.
Recommendation  

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple Oui Oui1 Oui Oui Oui
align Oui Oui1 Oui Oui Oui
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple Oui Oui Oui4 Oui Oui Oui
align Oui Oui Oui4 Oui Oui Oui

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : SphinxKnight, Valbou, _pierrick_, tregagnon
Dernière mise à jour par : SphinxKnight,