<COLGROUP>NN 6 IE 3 HTML 4  

<COLGROUP>...</COLGROUP>

Balise de fin HTML : Facultatif  

L'élément colgroup permet de définir rapidement des largeurs et autres caractéristiques de style pour un ou plusieurs sous-ensembles de colonnes de tableau. Lorsque ces informations apparaissent au début du code source de l'élément table, un navigateur compatible avec cette fonction commence à afficher le tableau avant que tout son code source soit chargé (moment auquel, normalement, il commencerait à effectuer les calculs relatifs à la disposition du tableau).

Vous pouvez utiliser l'élément colgroup en combinaison avec l'élément col ou isolément. Vous pouvez également définir un élément colgroup dans lequel sont imbriqués des éléments col afin d'aider à définir des sous-ensembles de colonnes partageant certains paramètres d'attribut ou de style. La nécessité d'une balise de fin pour l'élément est déterminée par la présence ou non d'éléments col autonomes suivant l'élément colgroup. Par exemple, si vous spécifiez des groupes de colonnes entièrement avec des éléments colgroup, les balises de fin sont superflues.

Si un élément col autonome suit l'élément colgroup, vous devez clairement terminer l'élément colgroup placé devant l'élément col autonome:

La structure dépend de la manière dont vous devez affecter les largeurs et les styles à des colonnes individuelles ou contiguà«s. Pour créer un groupe de plusieurs colonnes adjacentes, utilisez l'attribut span. Celui-ci est différent de l'attribut colspan d'un élément td, qui a pour effet de joindre des cellules adjacentes pour constituer une cellule unique. L'attribut span vous aide à définir le nombre de colonnes à traiter de façon structurelle en tant que groupe (afin d'affecter des paramètres d'attribut et de feuille de style à plusieurs colonnes, indépendamment de leur contenu).

Quelle que soit la manière dont vous abordez la structure des colonnes du tableau, le nombre total de colonnes définies dans l'ensemble des éléments col et colgroup doit être égal au nombre de colonnes physiques souhaitées pour le tableau. Les trois exemples de structure ci-dessous définissent des tableaux HTML 4 de six colonnes:

Les spécifications HTML 4 pour l'élément colgroup vont au-delà de leur implémentation dans IE pour Windows et Navigator, jusqu'à la Version 6. Par exemple, le code HTML 4 permet d'opérer un alignement, dans une colonne, sur n'importe quel caractère, par exemple une virgule décimale ou un symbole monétaire. Ce type de fonction contribue à justifier l'existence de l'élément col (pour un exemple, voir la section relative à l'élément col).

Il existe peu de différences syntaxiques entre les éléments colgroup et col. Un élément colgroup confère cependant une intégrité structurelle à un groupe de colonnes qui s'affiche différemment lorsque l'élément contenant table spécifie rules="groups"; le navigateur trace des lignes droites (bordures de tableau standard dans IE) uniquement entre les éléments colgroup, pas entre les éléments col.

La prise en charge indiquée ici pour Netscape 6 repose sur l'implémentation DOM du navigateur. Le DOM signale aux scripts l'existence de l'élément colgroup et ses attributs (assimilés à des propriétés). Cependant, à partir de Netscape 7, cet élément n'exécute plus les tâches escomptées. Une version ultérieure pourra probablement connecter les liens internes.

 
Exemple
 
<COLGROUP class="dateCols" width="15" align="right">
 
Rference de modle d'objet
 
[window.]document.getElementById(elementID)
 
Attributs sp
 
aligncharcharoffspanvalign
width
 
Attributs du gestionnaire d'événements spécifiques à l'élément

Aucune.

alignNN s.o. IE 3 HTML 4  

align="alignConstant"

Facultatif  

Définit les caractéristiques d'alignement horizontal du contenu des colonnes incluses dans l'élément colgroup. Les spécifications HTML 4 définissent pour l'attribut align des paramètres dont l'équivalent n'existe pas encore dans les spécifications CSS. Par exemple, il n'existe aucun équivalent CSS à l'alignement par caractère. Reportez-vous à la description de l'élément colgroup pour plus de détails sur la compatibilité de Netscape 6.

 
Exemple
 
<COLGROUP class="dateCols" width="15" align="right" span="3">
 
Valeur

HTML 4 et IE possèdent deux jeux de valeurs d'attributs.

Les noms des valeurs center (centré), left (gauche) et right (droite) sont explicites. La valeur justify est destinée à justifier le texte, en l'alignant sur les bords gauche et droit à la fois. Avec la valeur char, l'attribut char doit être également défini pour indiquer le caractère utilisé pour l'alignement du contenu. Dans l'exemple des spécifications HTML 4, tout contenu dans lequel ce caractère n'apparaît pas sera aligné à droite par rapport à l'emplacement de ce caractère dans les autres lignes de la même colonne.

Il est important de noter que l'attribut align s'applique à toutes les lignes incluses dans une colonne, y compris celles d'un élément th que vous auriez inséré dans le tableau. Si vous désirez obtenir un alignement différent pour l'en-tête de colonne, compensez le paramétrage général en insérant un attribut align séparé ou en affectant l'attribut de feuille de style text-align à l'élément thead ou, individuellement, aux éléments th.

ValeurIEHTML 4
center
char-
justify-
left
right
 
Par défaut

left

 
Rf&rence de modle d'objet
 
[window.]document.getElementById(elementID).align
charNN 6 IE s.o. HTML 4  

char="character"

Facultatif  

L'attribut char définit le caractère utilisé comme point d'alignement dans une colonne. Cet attribut n'est utile que si l'attribut align reçoit la valeur "char". Microsoft documente un attribut ch, qui correspond à l'attribut char reposant sur les standards. Quoi qu'il en soit, le navigateur ne répond à aucun attribut. Netscape 7 ne propose pas encore la prise en charge de l'attribut char.

 
Exemple
 
<COLGROUP class="priceCols" align="char" char="." span="2">
 
Valeur

Tout caractère alphanumérique unique.

 
Par défaut

Aucune.

charoffNN 6 IE s.o. HTML 4  

charoff="length"

Facultatif  

L'attribut charoff permet de définir le point de décalage spécifique auquel le caractère spécifié par l'attribut char doit apparaître dans chaque cellule. Cet attribut est destiné à résoudre les cas où le positionnement par défaut du navigateur ne correspondrait pas aux objectifs de mise en page du tableau. Microsoft documente un attribut choff, qui correspond à l'attribut charoff reposant sur les standards. Quoi qu'il en soit, le navigateur ne répond à aucun attribut. Netscape 7 ne propose pas encore la prise en charge de l'attribut charoff.

 
Exemple
 
<COLGROUP class="priceColumn" align="char" char="." charoff="80%" span="2">
 
Valeur

Toute valeur en pixels ou en pourcentage de l'espace disponible dans les cellules.

 
Par défaut

Aucune.

titleNN 6 IE 3 HTML 3.2

title="advisoryText"

Facultatif

Description de l'élément. Pour les éléments HTML qui produisent du contenu visible sur la page, IE 4 et versions ultérieures ainsi que Netscape 6 affichent le contenu de l'attribut title sous forme d'info-bulle lorsque le curseur reste un moment sur l'élément concerné. Par exemple, l'élément de colonne col n'affiche pas le contenu, donc son attribut title fournit simplement des informations. Pour générer des info-bulles dans les tableaux, affectez des attributs title aux éléments tels que table, tr, th ou td.

Les propriétés de police et de couleur sont régies par le navigateur et ne peuvent pas être modifiées par script. Dans IE pour Windows, l'info-bulle est le petit rectangle jaune clair standard; dans IE pour Macintosh, l'info-bulle s'affiche comme une bulle de BD, à la manière du système d'aide de MacOS. Dans Netscape 6, les info-bulles s'affichent toujours sous la forme du même petit rectangle quelle que soit la version du système d'exploitation. Si aucun attribut n'est spécifié, l'info-bulle ne s'affiche pas.

Vous pouvez affecter à cet attribut le texte descriptif de votre choix. Etant donné que tout le monde ne le verra pas, n'y placez pas d'informations essentielles. Peut-être les navigateurs conçus pour satisfaire les critères d'accessibilité Web utiliseront-ils les informations de cet attribut pour lire les informations au sujet d'un lien ou d'éléments autres que du texte à des utilisateurs malvoyants. Donc, ne négligez pas cette aide potentiellement utile pour décrire l'objectif d'un élément sur une page.

Bien que les indications de compatibilité pour cet attribut le fassent remonter à l'époque de Microsoft Internet Explorer 3 et HTML 3.2, il est nouvellement affecté à de nombreux éléments à partir de Microsoft Internet Explorer 4 et de HTML 4.0.

 
Exemple
 
<span title="United States of America">U.S.A.</span>
 
Valeur

Toute chaîne de caractères. Cette chaîne doit figurer entre guillemets (simples ou doubles, mais identiques).

 
Par défaut

Aucune.

 
Rf=rence de modle d'objet
 
[window.]document.getElementById(elementID).title
spanNN s.o. IE 3 HTML 4  

span="columnCount"

Facultatif  

Dofinit le nombre de colonnes adjacentes auxquelles s'appliquent l'attribut et les paramètres de style de l'élément colgroup . Si cet attribut manque, l'élément colgroup régit une seule colonne. Vous pouvez combiner plusieurs éléments colgroup ayant différentes valeurs pour span en fonction des besoins de sous-groupement de colonne. Reportez-vous à la description de l'élément colgroup pour plus de détails sur la compatibilité de Netscape 6.

 
Exemple
 
<COLGROUP span="3">
 
Valeur

Valeur entière supérieur à zéro.

 
Par défaut

1

 
Rfcrence de modle d'objet
 
[window.]document.getElementById(elementID).span
valignNN 6 IE 3 HTML 4  

valign="alignmentConstant"

Facultatif  

Définit les caractéristiques de l'alignement vertical du contenu des cellules de toutes les colonnes incluses dans l'élément colgroup. Vous pouvez modifier manuellement l'alignement vertical d'une cellule particulière d'une colonne. Reportez-vous à la description de l'élément colgroup pour plus de détails sur la compatibilité de Netscape 6.

 
Exemple
 
<COLGROUP valign="middle">
 
Valeur

IE 4 et HTML 4.0 reconnaissent quatre constantes possibles: top | middle | bottom | baseline. Avec top et bottom, le contenu est aligné sur le haut et le bas de la cellule (ou en est très proche). Avec middle (la valeur par défaut), le contenu est parfaitement centré verticalement dans les cellules. Dans les cas où le contenu d'une cellule pourrait s'étendre sur plusieurs lignes dans les largeurs de fenêtre courantes (dans l'hypothèse d'un tableau de largeur variable), il est conseillé de donner à l'attribut valign de toutes les cellules d'une même ligne (ou de tous les éléments colgroup) la valeur baseline. Ainsi, la ligne de base des caractères de la première (ou de la seule) ligne de texte de la cellule sera alignée sur celle du contenu des autres cellules de la même ligne, ce qui est en général le meilleur compromis sur le plan esthétique.

 
Par défaut

middle

 
Rf rence de modle d'objet
 
[window.]document.getElementById(elementID).vAlign
widthNN 6 IE 3 HTML 4  

width="multiLength"

Facultatif  

Dafinit la largeur maximale des colonnes incluses dans l'élément colgroup. Dans la pratique (IE 4 pour Windows et versions ultérieures), le navigateur n'affiche pas une colonne dont la largeur est inférieure à la plus longue chaîne de caractères sans espace (c'est-à -dire au mot le plus long). La mesure exacte d'une telle largeur de colonne dépend également des paramètres de police du contenu. Reportez-vous à la description de l'élément colgroup pour plus de détails sur la compatibilité de Netscape 6.

 
Exemple
 
<COLGROUP width="100">
 
Valeur

Internet Explorer  4 accepte pour width des valeurs de longueur exprimées en pixels (sans l'unité « px » ) ou en pourcentage de l'espace horizontal disponible alloué au tableau (width="25%").

Une variante de la valeur de longueur proportionnelle est décrite dans les spécifications HTML  4.0. Pour un élément colgroup, vous pouvez spécifier la valeur width="*0" afin d'indiquer au navigateur qu'il doit afficher toutes les colonnes en fonction de la largeur minimale nécessaire pour insérer le contenu des cellules dans la colonne. Pour pouvoir effectuer ce calcul, le navigateur doit charger tout le contenu du tableau, ce qui empêche tout affichage incrémentiel d'un long tableau. Pour plus de détails sur les longueurs proportionnelles, voir la section relative à l'attribut width de l'élément col.

 
Par défaut

Déterminé par calcul dans le navigateur.