KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

HTML-element: colgroup

Het kolomgroepelement verenigt opeenvolgende tabelkolommen in een bereik met gedeelde presentatie.

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

Syntax

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

colgroup is een direct kind van table, na een optionele caption en vóór thead, tbody, tfoot of directe tr-rijen.

Een groep gebruikt het eigen attribuut span of kindelementen col; met span is het inhoudsmodel leeg en mogen geen kolommen als kind worden toegevoegd.

Een waarde span beslaat 1 tot 1000 kolommen. Zonder die waarde is het bereik de som van kindelementen col; een lege colgroup draagt dan de tabelmodelstandaard van één kolom bij.

Groeperen maakt geen gegevenskoppen, dus th en scope blijven nodig. Het voorbeeld gebruikt querySelectorAll() om één expliciete kolom met een bereik van twee te vergelijken.

Voorbeelden

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

Resultaat

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

Het resultaat bevestigt twee groepen na het bijschrift, één expliciete kolom en een lege spangroep; het beoordeelt de uiteindelijke stijl niet.

Bronnen