WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen