From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/html/element/colgroup/index.html | 276 ++++++++++++++++++++++++++ 1 file changed, 276 insertions(+) create mode 100644 files/fr/web/html/element/colgroup/index.html (limited to 'files/fr/web/html/element/colgroup') diff --git a/files/fr/web/html/element/colgroup/index.html b/files/fr/web/html/element/colgroup/index.html new file mode 100644 index 0000000000..3de84d1f8c --- /dev/null +++ b/files/fr/web/html/element/colgroup/index.html @@ -0,0 +1,276 @@ +--- +title: +slug: Web/HTML/Element/colgroup +tags: + - Element + - HTML + - Reference + - Tableau + - Web +translation_of: Web/HTML/Element/colgroup +--- +
{{HTMLRef}}
+ +

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

+ +
{{EmbedInteractiveExample("pages/tabbed/colgroup.html","tabbed-taller")}}
+ + + +

Attributs

+ +

Comme pour tous les éléments, on peut utiliser les attributs universels sur cet élément.

+ +
+
{{htmlattrdef("align")}} {{Deprecated_inline("html4.01")}}, {{obsolete_inline("html5")}}
+
Cet attribut à valeur contrainte 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 : 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 attributs  {{htmlattrxref("char", "col")}} et {{htmlattrxref("charoff", "col")}} {{unimplemented_inline(2212)}}.
    • +
+ +

Si cet attribut n'est pas renseigné, la valeur left sera prise comme valeur par défaut. Les éléments {{HTMLElement("col")}} descendants peuvent surcharger cette valeur en utilisant leur attribut {{htmlattrxref("align", "col")}}.

+ +
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 : + +
      +
    • Ne pas utiliser la propriété {{cssxref("text-align")}} sur un sélecteur renvoyant un élement {{HTMLElement("colgroup")}}. Les éléments {{HTMLElement("td")}} ne sont pas des descendants de l'élément {{HTMLElement("colgroup")}} il n'hériteront pas de cette propriété.
      • +
    • Si le tableau n'utilise pas l'attribut {{htmlattrxref("colspan", "td")}}, il est possible d'utiliser le sélecteur CSS tr:nth-child(an+b) avec a le nombre total de colonnes du tableau et b la position ordinale de la colonne. Une fois que ce selecteur a été utilisé, la propriété {{cssxref("text-align")}} peut être utilisée.
      • +
    • Si le tableau utilise l'attribut {{htmlattrxref("colspan", "td")}}, l'effet peut être réalisé en combinant différents sélecteurs CSS comme [colspan=n]. Cependant cela n'est pas trivial à réaliser.
      • +
    +
    • +
  • Pour réaliser le même effet qu'avec la valeur char. Il est possible, en CSS3, d'utiliser la valeur de l'attribut {{htmlattrxref("char", "colgroup")}} comme valeur de la propriété {{cssxref("text-align")}}. {{unimplemented_inline}}.
    • +
+
+
+
+ +
+
{{htmlattrdef("bgcolor")}} {{Non-standard_inline}}
+
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 tel que défini par le sRGB, précédé d'un '#'. Un de ces seize mots-clés, comme présentés ci-dessous, peut ê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é que sous certaines versions d'Internet Explorer. L'élément {{HTMLElement("colgroup")}} doit être mis en forme grâce au CSS. Pour fournir un effet semblable à celui réalisé par l'attribut bgcolor, il est possible d'utiliser la propriété CSS {{cssxref("background-color")}} sur les éléments  {{HTMLElement("td")}} souhaités.
+
+
{{htmlattrdef("char")}} {{Deprecated_inline("html4.01")}}, {{obsolete_inline("html5")}}
+
Cet attribut spécifie l'alignement du contenu d'un groupe de colonnes en fonction d'un caractère.
+  Les valeurs généralement utilisées pour cet attribut contiennent généralement un point (.) pour aligner des nombres ou des valeurs monétaires. Si l'attribut {{htmlattrxref("align", "col")}} ne vaut pas char, l'attribut est ignoré. Cet attribut peut être surchargé avec l'attribut {{htmlattrxref("align", "col")}} de chacun des éléments {{HTMLElement("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 {{htmlattrxref("char", "colgroup")}}, on pourra utiliser CSS3 en attribuant la même valeur à la propriété {{cssxref("text-align")}}.{{unimplemented_inline}}.
+
+
{{htmlattrdef("charoff")}} {{Deprecated_inline("html4.01")}}, {{obsolete_inline("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.
+
+
+ +
+
{{htmlattrdef("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 1. +
Note : Cet attribut s'applique aux attributs des colonnes du groupe. Il n'a pas d'effet sur les différentes règles CSS associées au groupe ou aux cellules des colonnes de ce groupe.. L'attribut spann'est pas autorisé s'il y a un ou plusieurs éléments <col> au sein de <colgroup>.
+
+
+ +
+
{{htmlattrdef("valign")}} {{Deprecated_inline("html4.01")}}, {{obsolete_inline("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.
    • +
+ +
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é {{cssxref("vertical-align")}} sur un sélecteur retournant un élément {{HTMLElement("colgroup")}}. En effet les éléments {{HTMLElement("td")}} n'étant pas des descendants de l'élément {{HTMLElement("colgroup")}} ils n'hériteront pas de la propriété.
    • +
  • Si le tableau n'utilise pas d'attribut {{htmlattrxref("colspan", "td")}} il est possible d'utiliser le sélecteur CSS tr:nth-child(an+b) avec a le nombre de colonne du tableau et b la position ordinale de la colonne dans le tableau puis d'utiliser la propriété {{cssxref("vertical-align")}} sur le sélecteur.
    • +
  • Si le tableau n'utilise pas l'attribut {{htmlattrxref("colspan", "td")}} 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.
    • +
+
+
+
+ +
+
{{htmlattrdef("width")}} {{obsolete_inline("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 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. On peut également utiliser cette notation de manière relative (par exemple 0.5*).
+
+ +

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

+ +

{{EmbedLiveSample("Exemples","200","100")}}

+ +
+

Note : On pourra consulter la page {{HTMLElement("table")}} pour d'autres exemples sur les tableaux.

+
+

Résumé technique

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Catégories de contenuAucune.
Contenu autoriséSi l'attribut {{htmlattrxref("span", "colgroup")}} est présent : aucun car c'est un élément vide.
+ Si l'attribut n'est pas présent, zéro ou plusieurs éléments {{HTMLElement("col")}}.
Omission de balisesLa balise de début peut être absente si le premier élément fils {{HTMLElement("col")}} et que celui-ci n'est pas précédé par un élément {{HTMLElement("colgroup")}} dont la balise de fin est absente. La balise de fin peut être absente s'il n'est pas suivi par un blanc ou par un commentaire.
Éléments parents autorisésUn élément {{HTMLElement("table")}}. {{HTMLElement("colgroup")}} doit apparaître après tout élément  {{HTMLElement("caption")}} optionnel et avant tout élément {{HTMLElement("thead")}}, {{HTMLElement("th")}}, {{HTMLElement("tbody")}}, {{HTMLElement("tfoot")}} et {{HTMLElement("tr")}}.
Rôles ARIA autorisésAucun.
Interface DOM{{domxref("HTMLTableColElement")}}
+ + +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', 'tables.html#the-colgroup-element', '<colgroup>')}}{{Spec2('HTML WHATWG')}} 
{{SpecName('HTML5 W3C', 'tabular-data.html#the-colgroup-element', '<colgroup>')}}{{Spec2('HTML5 W3C')}} 
{{SpecName('HTML4.01', 'tables.html#edef-COLGROUP', '<colgroup>')}}{{Spec2('HTML4.01')}} 
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("html.elements.colgroup")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf