Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

elemento HTML: colgroup

L’elemento gruppo di colonne unisce colonne consecutive in un intervallo che può ricevere una presentazione comune.

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

Sintassi

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

colgroup è figlio diretto di table, posto dopo un eventuale caption e prima di thead, tbody, tfoot o righe tr dirette.

Un gruppo usa il proprio attributo span oppure figli col; con span il modello di contenuto è vuoto e non vanno aggiunte colonne figlie.

Un valore span copre da 1 a 1000 colonne. Senza, la copertura è la somma dei figli col; un colgroup vuoto contribuisce allora al modello la copertura iniziale di una colonna.

Il gruppo non crea intestazioni dati, quindi th e scope restano necessari. L’esempio usa querySelectorAll() per confrontare una colonna esplicita con un intervallo di due.

Esempi

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

Risultato

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

Il risultato conferma due gruppi dopo la didascalia, una colonna esplicita e un gruppo span vuoto; non valuta lo stile finale.

Fonti