Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

élément HTML: caption

L’élément de légende donne à un tableau un titre ou une explication concise, aidant à comprendre la portée des données avant les cellules.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<table><caption>Table title</caption>…</table>

Lorsqu’un caption existe, il doit être le premier élément enfant de table ; des nœuds texte ou commentaire peuvent le précéder, et le tableau ne peut en avoir plus d’un.

Dans le DOM, table.caption référence la légende associée ; createCaption() la crée ou renvoie l’existante, tandis que deleteCaption() ne retire que cet élément.

La légende ne remplace pas les en-têtes : th avec scope ou une association headers–id décrit toujours les relations de la grille.

Le CSS caption-side peut modifier la position visuelle. L’exemple lit firstElementChild, les collections rows et tBodies et le nombre d’en-têtes.

Exemples

<!doctype html>
<meta charset="utf-8">
<table id="sales">
  <caption>Quarterly sales</caption>
  <thead><tr><th scope="col">Quarter</th><th scope="col">Units</th></tr></thead>
  <tbody><tr><th scope="row">Q1</th><td>42</td></tr></tbody>
</table>
<output id="result"></output>
<script>
const sales = document.querySelector("#sales");
document.querySelector("#result").textContent = `caption=${sales.caption.textContent}; first=${sales.firstElementChild.tagName}; rows=${sales.rows.length}; bodies=${sales.tBodies.length}; headers=${sales.querySelectorAll("th").length}`;
</script>

Résultat

caption=Quarterly sales; first=CAPTION; rows=2; bodies=1; headers=3

Le résultat confirme une légende comme premier élément et une structure de deux lignes ; il ne simule pas l’annonce par lecteur d’écran.

Sources