CKTIS / HTML
prvok HTML: colgroup
Prvok skupiny stĺpcov spája po sebe idúce stĺpce tabuľky do rozsahu so spoločnou prezentáciou.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<table><colgroup><col></colgroup><colgroup span="2"></colgroup>…</table>colgroup je priamym potomkom table, umiestneným za voliteľným caption a pred thead, tbody, tfoot či priamymi riadkami tr.
Skupina používa buď vlastný atribút span, alebo potomkov col; s prítomným span je model obsahu prázdny a stĺpce nemožno pridať ako potomkov.
Hodnota span pokrýva 1 až 1000 stĺpcov. Bez nej je rozsah súčtom potomkov col; prázdny colgroup potom do modelu tabuľky prispieva predvoleným rozsahom jedného stĺpca.
Zoskupenie nevytvára hlavičky údajov, preto zostávajú nutné th a scope. Príklad cez querySelectorAll() porovná jeden výslovný stĺpec s rozsahom dvoch.
Príklady
<!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>
Výsledok
groups=2; afterCaption=COLGROUP; explicitCols=1; metricsSpan=2; metricsChildren=0
Výsledok potvrdzuje dve skupiny za titulkom, jeden výslovný stĺpec a prázdnu skupinu span; nehodnotí konečný štýl.