Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

elemento HTML: caption

El elemento de título de tabla da a la tabla un título o explicación breve, ayudando a entender el alcance de los datos antes de sus celdas.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

Cuando existe caption, debe ser el primer elemento hijo de table; pueden precederlo nodos de texto o comentario, y una tabla no puede tener más de uno.

En el DOM, table.caption referencia el título asociado; createCaption() lo crea o devuelve el existente y deleteCaption() elimina solo ese elemento.

El título no sustituye encabezados de celda: th con scope o una asociación headers–id sigue describiendo relaciones en la cuadrícula.

CSS caption-side puede cambiar la posición visual. El ejemplo lee firstElementChild, las colecciones rows y tBodies y el número de encabezados.

Ejemplos

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

El resultado confirma un título como primer elemento y una estructura de dos filas; no simula anuncios de tabla de un lector de pantalla.

Fuentes