Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

elemento HTML: caption

L’elemento didascalia della tabella fornisce titolo o spiegazione concisa, aiutando a capire l’ambito dei dati prima delle celle.

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

Sintassi

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

Quando caption è presente, deve essere il primo elemento figlio di table; nodi di testo o commento possono precederlo e una tabella non può averne più di uno.

Nel DOM, table.caption riferisce la didascalia associata; createCaption() la crea o restituisce quella esistente, mentre deleteCaption() rimuove solo tale elemento.

La didascalia non sostituisce le intestazioni: th con scope o un’associazione headers–id descrive ancora le relazioni nella griglia.

CSS caption-side può cambiare la posizione visiva. L’esempio legge firstElementChild, le raccolte rows e tBodies e il numero di intestazioni.

Esempi

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

Risultato

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

Il risultato conferma una didascalia come primo elemento e una struttura di due righe; non simula l’annuncio di uno screen reader.

Fonti