<colgroup> Redirection 1

par 1 contributeur :

Une erreur de script s'est produite sur cette page. En attendant qu'elle soit traitée par les éditeurs du site, vous pouvez consulter le contenu partiel ci-dessous.

Résumé

L'élément HTML <colgroup> définit un groupe de colonnes au sein d'un tableau.

  • Catégories de contenu Aucune
  • Contenu autorisé Aucun si l'attribut span est présent c'est un élément vide.
    Si cet attribut n'est pas présent, zéro ou plusieurs éléments <col>.
  • Omission de balises La balise de début peut être omise si le premier enfant de cet élément est un élément <col> et s'il n'est pas précédé d'un élément  <colgroup> dont la balise de fin est absente.
    La balise de fin peut être absente si elle n'est pas suivie d'un espace ou d'un commentaire.
  • Éléments parents autorisésUn élément <table>. L'élément <colgroup> doit apparaître après tout élément <caption> éventuel et avant tout élément <thead>, <th>, <tbody>, <tfoot> et <tr>.
  • Interface DOM HTMLTableColElement

Attributs

Cet élément inclut les attributs globaux.

align Obsolète depuis HTML4.01, Obsolète depuis HTML5
Cet attribut à valeurs 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 alligné à gauche de la cellule
  • center : le contenu de la cellule est centré horizontalement
  • right : le contenu de la cellule est aligné à droite de la cellule
  • justify : insert 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 attributs  char et charoff Non implémenté (voir bug 2212).

Si cet attribut n'est pas renseigné, la valeur left est admise. Les éléments <col> descendants peuvent outrepasser cette valeur en utilisant leur attribut align.

Notes : Cet attribut est devenu obsolète et n'est plus supporté dans le dernier standard
  • Pour réaliser les mêmes effets que les valeurs left, center, right ou justify :
    • N'utilisez pas la propriété text-align sur un sélecteur renvoyant un élement <colgroup>. Les éléments <td> ne sont pas des descendants de l'élément <colgroup> 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 CSS tr:nth-child(n) avec n la position de la colonne dans le tableau. Une fois que ce selecteur a été utilisé, la propriété vertical-align peut être utilisée.
    • 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.
  • Pour réaliser le même effet qu'avec la valeur char. Il est possible, en CSS3, d'utiliser la valeur de l'attribut char 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 des colonnes appartenant au groupe de colonnes. 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 <colgroup> doit être mis en forme grâce au CSS. Pour fournir un effet semblable à celui achevé par l'attribut bgcolor, il est possible d'utiliser la propriété CSS background-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 pas char, l'attribut est ignoré. Cet attribut peut être outrepassé avec l'attribut align de chacun des éléments <col> appartenant au groupe de colonnes.
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, en utilisant 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
La valeur de cet attribut est un entier positif indiquant le nombre de colonnes consécutives sur lesquelles appliquer les attributs de l'élément. S'il est absent, sa valeur par défaut est 0.
Note : Cet attribut s'applique aux attributs des colonnes du groupe. Il n'a pas d'effet sur les différents règles CSS associées au groupe ou aux cellules des colonnes de ce groupe.
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 valeur bottom.
  • bottom qui placera le texte au plus bas de la cellule
  • middle qui centrera verticalement le texte dans la cellule
  • top qui placera le texte au plus haut de la cellule.
Note 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 <colgroup>. En effet les éléments <td> n'étant pas des descendants de l'élément <colgroup> 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 CSS tr:nth-child(n) avec n étant la position de lacolonne 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.
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 en 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 exemple 0.5* ) est également possible.

Exemples

Veuillez consulter la page de l'élément <table> pour des exemples sur l'utilisation de <colgroup>.

Spécifications

Spécification Statut Commentaires
WHATWG HTML Living Standard Living Standard  
HTML5 Candidate Recommendation  
HTML 4.01 Specification Recommendation  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple 1.0 1.0 (1.7 ou moins) (Oui) (Oui) (Oui)
Attribut align/valign ? Pas de support bug 915 ? ? ?
Attribut char/charoff ? Pas de support bug 2212 ? ? ?
attribut bgcolor ? Pas de support (Oui) ? ?
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple ? 1.0 (1.0) ? ? ?
Attribut align/valign ? Pas de support bug 915 ? ? ?
Attribut char/charoff ? Pas de support bug 2212 ? ? ?
Attribut bgcolor ? Pas de support ? ? ?

Voir également

Les propriétés CSS et les pseudo-classes pouvant être utile pour la mise en forme de l'élément <col> :

  • la propriété width contrôlant la largeur de la colonne
  • la pseudo-classe :nth-child permettant de régler l'alignement des contenus des cellules d'une colonne
  • la propriété text-align pour aligner tous les contenus de cellules sur le même caractère (par exemple sur un point (.).

{{ HTMLRef }}

Étiquettes et contributeurs liés au document

Contributeurs à cette page : tregagnon
Dernière mise à jour par : tregagnon,