CKTIS / HTML
elemento HTML: caption
O elemento de legenda da tabela fornece título ou explicação concisa, ajudando a compreender o âmbito dos dados antes das células.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<table><caption>Table title</caption>…</table>Quando caption está presente, tem de ser o primeiro elemento filho de table; nós de texto ou comentário podem precedê-lo e a tabela não pode ter mais do que um.
No DOM, table.caption referencia a legenda associada; createCaption() cria-a ou devolve a existente, enquanto deleteCaption() remove apenas esse elemento.
A legenda não substitui cabeçalhos de célula: th com scope ou uma associação headers–id continua a descrever relações na grelha.
CSS caption-side pode mudar a posição visual. O exemplo lê firstElementChild, as coleções rows e tBodies e o número de cabeçalhos.
Exemplos
<!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>
Resultado
caption=Quarterly sales; first=CAPTION; rows=2; bodies=1; headers=3
O resultado confirma uma legenda como primeiro elemento e estrutura de duas linhas; não simula o anúncio da tabela por leitor de ecrã.