Balise HTMLTableaux

<colgroup>

Un groupe de colonnes de tableau que l’on peut styler d’un seul coup.

Affichage
table-column-group
Balise fermante
Obligatoire
Contenu autorisé
Éléments <col>, ou rien lorsque span est indiqué
Sur cette page

Exemple

#
HTML
<style>
  table { border-collapse: collapse; }
  th, td { border: 1px solid #8886; padding: 4px 10px; }
  .student { width: 110px; }
  .quizzes { background: #38bdf826; }
</style>
<table>
  <colgroup>
    <col class="student">
  </colgroup>
  <colgroup class="quizzes" span="3"></colgroup>
  <tr><th scope="col">Élève</th><th scope="col">Quiz 1</th><th scope="col">Quiz 2</th><th scope="col">Quiz 3</th></tr>
  <tr><th scope="row">Ola</th><td>9</td><td>10</td><td>8</td></tr>
  <tr><th scope="row">Kuba</th><td>7</td><td>9</td><td>9</td></tr>
</table>
Aperçu

Définition et utilisation

#

L’élément <colgroup> définit un groupe de colonnes. Vous le placez dans le tableau juste après <caption> et avant <thead>. Vous décrivez les colonnes à l’intérieur avec des éléments <col> ou, si elles doivent toutes avoir le même aspect, avec le seul attribut span.

En HTML, les colonnes ne sont pas de vrais conteneurs : les cellules appartiennent aux lignes, pas aux colonnes. C’est pourquoi, via <colgroup> et <col>, vous ne pouvez définir que quelques propriétés : background, border (avec border-collapse: collapse), width et visibility: collapse. La couleur du texte ou l’alignement doivent être définis sur les cellules.

Les groupes de colonnes sont utiles dans les tableaux comparatifs et les plannings : vous pouvez mettre en valeur le week-end d’un emploi du temps hebdomadaire par un fond, ou fixer la largeur de la colonne de description, sans ajouter de classes à chaque cellule.

Syntaxe

#
Syntaxe
<colgroup>
  <col>
  <col span="2">
</colgroup>

Attributs

#
  • span

    nombre positif (1 par défaut)

    Le nombre de colonnes du groupe. Vous ne l’utilisez que lorsque le groupe ne contient pas d’éléments <col>. S’il y en a à l’intérieur, ce sont eux qui déterminent le nombre de colonnes.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

span

nombre positif (1 par défaut)

Le nombre de colonnes du groupe. Vous ne l’utilisez que lorsque le groupe ne contient pas d’éléments <col>. S’il y en a à l’intérieur, ce sont eux qui déterminent le nombre de colonnes.

HTML
<style>
  table { border-collapse: collapse; }
  th, td { border: 1px solid #8886; padding: 4px 8px; text-align: center; }
  .weekend { background: #f43f5e26; }
</style>
<table>
  <caption>Minutes d’étude cette semaine</caption>
  <colgroup span="5"></colgroup>
  <colgroup span="2" class="weekend"></colgroup>
  <tr><th>Lun</th><th>Mar</th><th>Mer</th><th>Jeu</th><th>Ven</th><th>Sam</th><th>Dim</th></tr>
  <tr><td>30</td><td>45</td><td>20</td><td>0</td><td>60</td><td>90</td><td>15</td></tr>
</table>
Aperçu

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
colgroup {
  display: table-column-group;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Si vous définissez color ou text-align sur <colgroup> et que rien ne se passe, ce n’est pas un bogue. Les colonnes ne prennent en charge que le fond, la bordure, la largeur et la visibilité.
  • Pour mettre en valeur une seule colonne d’un groupe, utilisez un <col> avec une classe.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.