CKTIS / HTML
element HTML: caption
Element podpisu tabeli nadaje tabeli tytuł lub zwięzłe objaśnienie, pomagając czytelnikowi zrozumieć zakres danych przed komórkami.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<table><caption>Table title</caption>…</table>Jeśli caption występuje, musi być pierwszym bezpośrednim dzieckiem table, które jest elementem; węzły tekstowe lub komentarze mogą go poprzedzać, a tabela nie może mieć więcej niż jednego podpisu.
W DOM table.caption wskazuje powiązany podpis; createCaption() tworzy go lub zwraca istniejący, a deleteCaption() usuwa tylko ten element.
Podpis nie zastępuje nagłówków komórek: th wraz z scope albo powiązaniem headers–id nadal opisuje relacje w siatce.
CSS caption-side może zmienić wizualne położenie. Przykład odczytuje firstElementChild, kolekcje rows i tBodies oraz liczbę nagłówków.
Przykłady
<!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>
Wynik
caption=Quarterly sales; first=CAPTION; rows=2; bodies=1; headers=3
Wynik potwierdza jeden podpis jako pierwszy element i strukturę dwóch wierszy; nie symuluje ogłaszania tabeli przez czytnik ekranu.