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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
align
Obsolète
Chrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
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 aussi

Étiquettes et contributeurs liés au document

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