Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

element HTML: colgroup

Element grupy kolumn łączy kolejne kolumny tabeli w zakres, któremu można przypisać wspólną prezentację.

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

Składnia

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

colgroup jest bezpośrednim dzieckiem table, umieszczanym po opcjonalnym caption, a przed thead, tbody, tfoot lub bezpośrednimi wierszami tr.

Grupa używa albo własnego atrybutu span, albo potomnych elementów col; obecność span oznacza pusty model zawartości i nie wolno wtedy dodawać kolumn potomnych.

Wartość span obejmuje od 1 do 1000 kolumn. Bez niej zasięg jest sumą potomnych col; pusty colgroup wnosi wtedy do modelu tabeli domyślny zasięg jednej kolumny.

Grupowanie nie tworzy nagłówków danych, więc nadal potrzebne są th i scope. Przykład przez querySelectorAll() porównuje grupę z jawną kolumną z grupą o zakresie dwóch.

Przykłady

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

Wynik

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

Wynik potwierdza dwie grupy po podpisie, jedną jawną kolumnę i pustą grupę span; nie ocenia końcowego stylu kolumn.

Źródła