CKTIS / HTML
HTML-Element: colgroup
Das Spaltengruppenelement verbindet aufeinanderfolgende Tabellenspalten zu einem Bereich mit gemeinsamer Darstellung.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<table><colgroup><col></colgroup><colgroup span="2"></colgroup>…</table>colgroup ist direktes Kind von table, nach einem optionalen caption und vor thead, tbody, tfoot oder direkten tr-Zeilen.
Eine Gruppe verwendet entweder ihr Attribut span oder untergeordnete col-Elemente; mit span ist das Inhaltsmodell leer und Spalten dürfen nicht als Kinder hinzukommen.
Ein Wert span deckt 1 bis 1000 Spalten ab. Ohne ihn ist die Abdeckung die Summe untergeordneter col; ein leeres colgroup trägt dann die Tabellenmodell-Vorgabe von einer Spalte bei.
Die Gruppierung erzeugt keine Datenüberschriften, daher bleiben th und scope nötig. Das Beispiel vergleicht mit querySelectorAll() eine explizite Spalte mit einer Zweierspanne.
Beispiele
<!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>
Ergebnis
groups=2; afterCaption=COLGROUP; explicitCols=1; metricsSpan=2; metricsChildren=0
Das Ergebnis bestätigt zwei Gruppen nach der Beschriftung, eine explizite Spalte und eine leere Spangruppe; endgültige Spaltenstile werden nicht bewertet.