Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

prvek HTML: colgroup

Prvek skupiny sloupců spojuje po sobě jdoucí sloupce tabulky do rozsahu se společnou prezentací.

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

Syntaxe

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

colgroup je přímým potomkem table, umístěným za volitelným caption a před thead, tbody, tfoot či přímými řádky tr.

Skupina používá buď vlastní atribut span, nebo potomky col; s přítomným span je model obsahu prázdný a sloupce nelze přidat jako potomky.

Hodnota span pokrývá 1 až 1000 sloupců. Bez ní je rozsah součtem potomků col; prázdný colgroup pak do modelu tabulky přispívá výchozím rozsahem jednoho sloupce.

Seskupení nevytváří záhlaví dat, proto zůstávají nutné th a scope. Příklad přes querySelectorAll() porovná jednu výslovnou kolonu s rozsahem dvou.

Pří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ýsledek

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

Výsledek potvrzuje dvě skupiny za titulkem, jeden výslovný sloupec a prázdnou skupinu span; nehodnotí konečný styl.

Zdroje