Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

prvek HTML: caption

Prvek titulku tabulky dává tabulce název nebo stručné vysvětlení a pomáhá pochopit rozsah dat ještě před buňkami.

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

Syntaxe

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

Je-li caption přítomen, musí být prvním přímým potomkem table, který je elementem; textové či komentářové uzly mu mohou předcházet a tabulka smí mít jen jeden.

V DOM odkazuje table.caption na přidružený titulek; createCaption() jej vytvoří nebo vrátí stávající a deleteCaption() odstraní jen tento prvek.

Titulek nenahrazuje záhlaví buněk: th se scope nebo vazba headers–id stále popisuje vztahy v mřížce.

CSS caption-side může změnit vizuální umístění. Příklad čte firstElementChild, kolekce rows a tBodies i počet záhlaví.

Příklady

<!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>

Výsledek

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

Výsledek potvrzuje jeden titulek jako první prvek a strukturu dvou řádků; nesimuluje oznámení tabulky čtečkou.

Zdroje