CKTIS / HTML
HTML-element: caption
Het tabelbijschriftelement geeft een tabel een titel of beknopte uitleg, zodat lezers de reikwijdte van de gegevens vóór de cellen begrijpen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<table><caption>Table title</caption>…</table>Wanneer caption aanwezig is, moet dit het eerste elementkind van table zijn; tekst- of commentaarknooppunten mogen eraan voorafgaan en een tabel mag er maar één hebben.
In het DOM verwijst table.caption naar het bijschrift; createCaption() maakt of retourneert het en deleteCaption() verwijdert alleen dat element.
Een bijschrift vervangt celkoppen niet: th met scope of een koppeling headers–id beschrijft nog steeds relaties in het raster.
CSS caption-side kan de visuele plaatsing wijzigen. Het voorbeeld leest firstElementChild, de collecties rows en tBodies en het aantal koppen.
Voorbeelden
<!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>
Resultaat
caption=Quarterly sales; first=CAPTION; rows=2; bodies=1; headers=3
Het resultaat bevestigt één bijschrift als eerste element en een structuur van twee rijen; het simuleert geen schermlezeraankondiging.