Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła