L'élément HTML <col>
définit une colonne appartenant à un tableau et est utilisé afin de définir la sémantique commune à toutes ses cellules. On trouve généralement cet élément au sein d'un élément <colgroup>
.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Cet élément peut être mis en forme grâce à CSS mais seules quelques propriétés auront un effet sur la colonne (se référer à la spécification CSS 2.1 pour une liste exhaustive)
Attributs
Comme pour tous les éléments, on peut utiliser les attributs universels avec cet élément.
align
Obsolète depuis HTML4.01, Obsolète depuis HTML5- Cet attribut énuméré définit l'alignement horizontal pour le contenu de chaque cellule de la colonne. Les valeurs possibles sont :
left
: le contenu de la cellule est aligné à gauche de la cellulecenter
: le contenu de la cellule est centré horizontalementright
: le contenu de la cellule est aligné à droite de la cellulejustify
: insère des espaces dans le contenu textuel afin que le contenu de la cellule soit justifiéchar
: aligne le contenu textuel de la cellule selon un caractère spécial avec un décalage minimum définis par les attributschar
etcharoff
Non implémenté (voir bug 2212).
Si cet attribut n'est pas renseigné, sa valeur est héritée de la valeur de l'attribut
align
de l'élément<colgroup>
auquel cette colonne appartient. S'il n'y en a pas, la valeurleft
est prise comme valeur par défaut.Attention : Cet attribut est devenu obsolète dans le dernier standard.- Pour réaliser les mêmes effets que les valeurs
left
,center
,right
oujustify
:- N'utilisez pas la propriété
text-align
sur un sélecteur renvoyant un élement<col>
. Les éléments<td>
ne sont pas des descendants de l'élément<col>
il n'hériteront pas de cette propriété. - Si le tableau n'utilise pas l'attribut
colspan
, il est possible d'utiliser le sélecteur CSStd:nth-child(an+b)
avec a qui vaut zéro etb
la position ordinale de la colonne dans le tableau.td:nth-child(2) { text-align: right; }
permettra d'aligner à droite la deuxième colonne. - Si le tableau utilise l'attribut
colspan
, l'effet peut être réalisé en combinant différents sélecteurs CSS comme[colspan=n]
. Cependant cela n'est pas trivial à effectuer.
- N'utilisez pas la propriété
- Pour réaliser le même effet qu'avec la valeur
char
. Il est possible, en CSS3, d'utiliser la valeur de l'attributchar
comme valeur de la propriététext-align
. Non implémenté.
bgcolor
- Cet attribut définit la couleur d'arrière-plan de toutes les cellules de la colonne. C'est un code à 6 chiffres hexadécimaux comme défini par le sRGB. Il est précédé d'un '#'. Un de ces seize mot-clé peut également être utilisé.
black
= "#000000"green
= "#008000"silver
= "#C0C0C0"lime
= "#00FF00"gray
= "#808080"olive
= "#808000"white
= "#FFFFFF"yellow
= "#FFFF00"maroon
= "#800000"navy
= "#000080"red
= "#FF0000"blue
= "#0000FF"purple
= "#800080"teal
= "#008080"fuchsia
= "#FF00FF"aqua
= "#00FFFF"Note d'utilisation : Il est fortement conseillé de ne pas utiliser cet attribut car celui-ci n'est pas un attribut standard et n'a été implémentée que sous certaines versions d'Internet Explorer. L'élément<col>
doit être mis en forme grâce au CSS. Pour obtenir un effet semblable à celui obtenu avec l'attributbgcolor
, il est possible d'utiliser la propriété CSSbackground-color
sur les éléments<td>
souhaités.
char
Obsolète depuis HTML4.01, Obsolète depuis HTML5- Cet attribut est utilisé pour définir le caractère sur lequel aligner les cellules de la colonne. Les valeurs de cet attribut contiennent généralement un point (.) pour aligner des nombres ou des valeurs monétaires. Si l'attribut
align
ne vaut paschar
, l'attribut est ignoré. -
Note d'utilisation : Cet attribut est obsolète et il est donc fortement déconseillé de l'utiliser. De fait, il n'est pas supporté par le dernier standard. Pour réaliser le même effet qu'avec
char
, on pourra utiliser CSS3 en attribuant la même valeur à la propriététext-align
.Non implémenté.
charoff
Obsolète depuis HTML4.01, Obsolète depuis HTML5- Cet attribut est utilisé pour indiquer le décalage, en nombre de caractères, depuis le caractère définit par l'attribut char à appliquer au contenu des cellules.
Note d'utilisation : Cet attribut ne doit plus être utilisé car il est maintenant obsolète et n'est plus supporté dans le dernier standard.
span
- Cet attribut contient un entier positif indiquand le nombre de colonne consécutives regroupées sous l'élément
<col>
. La valeur par défaut de cet attribut est 1.
valign
Obsolète depuis HTML4.01, Obsolète depuis HTML5- Cet attribut définit l'alignement vertical du texte des cellules de la colonne. Les valeurs possibles de cet attribut sont :
baseline
qui alignera le texte à la ligne la plus basse possible en utilisant la ligne de base des caractères. Si les caractères ont tous la même taille, cela aura le même effet que la valeurbottom
.bottom
qui placera le texte au plus bas de la cellulemiddle
qui centrera verticalement le texte dans la celluletop
qui placera le texte au plus haut de la cellule.
Notes d'utilisation : Cet attribut étant maintenant obsolète (et n'étant plus supporté), il est fortement déconseillé de l'utiliser.- Il ne faut pas essayer de régler la propriété
vertical-align
sur un sélecteur retournant un élément<col>
. En effet les éléments<td>
n'étant pas des descendants de l'élément<col>
, ils n'hériteront pas de la propriété. - Si le tableau n'utilise pas d'attribut
colspan
il est possible d'utiliser le sélecteur CSStr:nth-child(an+b)
avec a le nombre total de colonnes dans le tableau et b la position ordinale de la colonne dans le tableau. La propriétévertical-align
peut alors être utilisée sur le sélecteur. - Si le tableau n'utilise pas l'attribut
colspan
l'effet peut être obtenu avec une combinaison de différents sélecteurs CSS comme[colspan=n]
. Cependant cela n'est pas trivial à réaliser.
width
Obsolète depuis HTML5- Cet attribut définit la largeur par défaut pour chaque colonne dans le groupe de colonnes. En plus de la notation standard en pixels et pourcents, cet attribut peut prendre la valeur spéciale
0*
, indiquant ainsi que la largeur de chaque colonne doit être suffisante pour contenir les contenus des cellules. Utiliser cette notation de manière relative (par exemple0.5*
) est également possible.
Exemples
HTML
<table>
<colgroup>
<col class="premiereColonne">
<col class="deuxDernieresColonnes" span="2">
</colgroup>
<tr>
<th>Citron vert</th>
<th>Citron</th>
<th>Orange</th>
</tr>
<tr>
<td>Vert</td>
<td>Jaune</td>
<td>Orange</td>
</tr>
</table>
Résultat
Note : On pourra consulter la page <table>
pour d'autres exemples sur les tableaux.
Résumé technique
Catégorie de contenu | Aucune. |
---|---|
Contenu autorisé | Aucun, cet élément est un élément vide. |
Omission de balise | La balise ouvrante est obligatoire, l'élément étant un élément vide, la balise de fin est interdite. |
Parents autorisés | <colgroup> uniquement. Toutefois, ce parent peut être défini de façon implicite car sa balise ouvrante n'est pas obligatoire. L'élément <colgroup> ne doit pas avoir d'attribut span . |
Rôles ARIA autorisés | Aucun. |
Interface DOM | HTMLTableColElement |
Spécifications
Spécification | État | Commentaires |
---|---|---|
HTML Living Standard La définition de '<col>' dans cette spécification. |
Standard évolutif | |
HTML5 La définition de '<col>' dans cette spécification. |
Recommendation | |
HTML 4.01 Specification La définition de '<col>' dans cette spécification. |
Recommendation | Définition initiale. |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- Les autres éléments HTML relatifs aux tableaux :
- Les propriétés et pseudo-classes CSS qui peuvent s'avérer utiles pour mettre en forme l'élément
<col>
:- La propriété
width
pour contrôler la largeur de la colonne - La pseudo-classe
:nth-child
qui permet de définir l'alignement sur les cellules d'une colonne - La propriété
text-align
qui permet d'aligner le contenu de cellules sur le même caractère (le point « . » par exemple).
- La propriété