WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

HTML-Element: caption

Das Tabellenbeschriftungselement gibt einer Tabelle einen Titel oder eine knappe Erklärung, sodass der Datenumfang vor den Zellen verständlich wird.

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

Syntax

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

Wenn caption vorhanden ist, muss es das erste Elementkind von table sein; Text- oder Kommentarknoten dürfen davor stehen, und eine Tabelle darf nur eine Beschriftung haben.

Im DOM verweist table.caption auf die Beschriftung; createCaption() erstellt sie oder liefert die vorhandene, deleteCaption() entfernt nur dieses Element.

Eine Beschriftung ersetzt keine Zellüberschriften: th mit scope oder die Zuordnung headers–id beschreibt weiterhin die Beziehungen im Raster.

CSS caption-side kann die visuelle Position ändern. Das Beispiel liest firstElementChild, die Sammlungen rows und tBodies sowie die Überschriftenanzahl.

Beispiele

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

Ergebnis

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

Das Ergebnis bestätigt eine erste Beschriftung und eine Struktur aus zwei Zeilen; Tabellenansagen eines Screenreaders werden nicht simuliert.

Quellen