Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

elemento HTML: colgroup

O elemento de grupo de colunas reúne colunas consecutivas num intervalo que pode receber apresentação comum.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

colgroup é filho direto de table, colocado depois de caption opcional e antes de thead, tbody, tfoot ou linhas tr diretas.

Um grupo usa o seu atributo span ou filhos col; com span, o modelo de conteúdo é vazio e não se podem acrescentar colunas filhas.

Um valor span cobre de 1 a 1000 colunas. Sem ele, a cobertura é a soma dos filhos col; um colgroup vazio contribui então para o modelo com o intervalo inicial de uma coluna.

O grupo não cria cabeçalhos de dados, por isso th e scope continuam necessários. O exemplo usa querySelectorAll() para comparar uma coluna explícita com um intervalo de duas.

Exemplos

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

O resultado confirma dois grupos depois da legenda, uma coluna explícita e um grupo span vazio; não avalia o estilo final.

Fontes