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

CKTIS / HTML

elemento HTML: colgroup

El elemento de grupo de columnas reúne columnas consecutivas en un intervalo que puede compartir presentación.

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

Sintaxis

<table><colgroup><col></colgroup><colgroup span="2"></colgroup>…</table>

colgroup es hijo directo de table, situado tras un caption opcional y antes de thead, tbody, tfoot o filas tr directas.

Un grupo usa su atributo span o elementos col hijos; cuando existe span, su modelo de contenido es vacío y no deben añadirse columnas hijas.

Un valor span cubre de 1 a 1000 columnas. Sin él, la cobertura es la suma de los hijos col; un colgroup vacío aporta entonces al modelo de tabla el intervalo inicial de una columna.

Agrupar no crea encabezados de datos, por lo que siguen siendo necesarios th y scope. El ejemplo usa querySelectorAll() para comparar una columna explícita con un intervalo de dos.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<table id="report">
  <caption>Measurements</caption>
  <colgroup id="identity"><col></colgroup>
  <colgroup id="metrics" span="2"></colgroup>
  <tbody><tr><td>Item</td><td>Min</td><td>Max</td></tr></tbody>
</table>
<output id="result"></output>
<script>
const report = document.querySelector("#report");
const groups = [...report.querySelectorAll(":scope > colgroup")];
const identity = document.querySelector("#identity");
const metrics = document.querySelector("#metrics");
document.querySelector("#result").textContent = `groups=${groups.length}; afterCaption=${report.caption.nextElementSibling.tagName}; explicitCols=${identity.querySelectorAll("col").length}; metricsSpan=${metrics.span}; metricsChildren=${metrics.children.length}`;
</script>

Resultado

groups=2; afterCaption=COLGROUP; explicitCols=1; metricsSpan=2; metricsChildren=0

El resultado confirma dos grupos tras el título, una columna explícita y un grupo span vacío; no evalúa el estilo final.

Fuentes