Element HTML colgroup reprezentuje jedną lub więcej kolumn tabeli HTML, którym można dzięki temu nadać spójne formatowanie.
Aby odnieść się do poszczególnych kolumn tabeli z osobna, można zdefiniować elementy potomne col w elemencie colgroup lub można zdefiniować kilka pustych elementów colgroup, ewentualnie z atrybutem span.
Przykład użycia elementu HTML colgroup
W poniższej tabeli dwie pierwsze kolumny będą miały czerwone tło, a trzecia – niebieskie.
<table>
<colgroup style="background-color: red" span="2"></colgroup>
<colgroup style="background-color: blue"></colgroup>
<tr>
<th>Jabłka</th>
<th>Gruszki</th>
<th>Banany</th>
</tr>
<tr>
<td>6 zł</td>
<td>7 zł</td>
<td>10 zł</td>
</tr>
</table>Taki sam efekt można uzyskać przy użyciu elementów col zagnieżdżonych w elemencie colgroup (który w takim przypadku nie może mieć atrybutu span).
<table>
<colgroup>
<col span="2" style="background-color: red">
<col style="background-color: blue">
</colgroup>
<tr>
<th>Jabłka</th>
<th>Gruszki</th>
<th>Banany</th>
</tr>
<tr>
<td>6 zł</td>
<td>7 zł</td>
<td>10 zł</td>
</tr>
</table>
Specyfikacja
| Elementy nadrzędne | Element table, po elementach caption i przed elementami thead, tbody, tfoot i tr |
|---|---|
| Elementy potomne | Brak, jeśli jest zdefiniowany atrybut span; elementy col i template, jeśli atrybut span nie jest zdefiniowany |
| Znaczniki | Znacznik otwierający elementu Znacznik zamykający elementu |
| Interfejs DOM | HTMLTableColElement |
Atrybuty obowiązkowe
Element HTML colgroup nie ma atrybutów obowiązkowych.
Atrybuty opcjonalne
Element colgroup obsługuje atrybuty globalne i atrybuty zdarzeniowe.
Ponadto element colgroup ma atrybut span określający liczbę obejmowanych przez niego kolumn. Jego wartość powinna mieścić się w przedziale od 1 do 1000.
