KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen