Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

élément HTML: colgroup

L’élément de groupe de colonnes réunit des colonnes consécutives en une plage pouvant recevoir une présentation commune.

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

Syntaxe

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

colgroup est un enfant direct de table, placé après un éventuel caption et avant thead, tbody, tfoot ou des lignes tr directes.

Un groupe emploie soit son attribut span, soit des enfants col ; avec span, son modèle est vide et aucune colonne enfant ne doit être ajoutée.

Une valeur span couvre de 1 à 1000 colonnes. Sans elle, la couverture est la somme des enfants col ; un colgroup vide contribue alors l’étendue par défaut d’une colonne au modèle de table.

Le groupe ne crée pas d’en-têtes de données, donc th et scope restent nécessaires. L’exemple emploie querySelectorAll() pour comparer une colonne explicite à une plage de deux.

Exemples

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

Résultat

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

Le résultat confirme deux groupes après la légende, une colonne explicite et un groupe span vide ; il n’évalue pas le style final.

Sources