HTML Reference Guide


Tag Index| Content List| HTML FAQ

<COLGROUP> ... </COLGROUP> Table Column GROUP

Description:

This element acts as a container for a group of columns (which are specified with COL elements), and allows the author to specify default properties for these columns. This element comes before any of the standard row grouping hierarchies (TR, THEAD, TBODY and TFOOT), and only serves to more completely describe organizational characteristics of the row grouping data that follow (no cell data is contained in COLGROUPs.)

If no COLGROUP elements are present, all columns in the table are assumed to be part of a single column group. Each COLGROUP grouping can contain zero or more COL elements.

Attributes:

align - This controls the horizontal alignment of text within the column group.

char - This attribute specifies a character in the cell content to be used to align the data in each cell of the column group (the first occurrence should be used.) The default value for this attribute is the decimal point character for the current specified language.

charoff - This attribute specifies the spacing offset to the first occurrence of the alignment character (specified by the CHAR attribute) on each line of cells in the current column group. The direction of the offset is determined by the current text direction (set with the DIR attribute or the BDO element.)

repeat - This attribute specifies how many columns the current column definition applies to. This is a shorthand for providing column attributes to multiple columns at once.

span - This attribute specifies a default for how many columns are in the current group. It provides a convenient way of grouping columns without the need to supply COL elements. This attribute should be ignored if the current COLGROUP contains one or more COL tags.

valign - This attribute specifies the vertical alignment of cell contents relative to the cell boundaries for all cells in the column group.

width - Specifies the overall width of the column grouping.

Example code:

<table BORDER="2" ALIGN="middle" CELLPADDING="5" BORDERCOLOR="#ff0000" COLS="4" FRAME="vsides" RULES="cols" WIDTH="75%"><colgroup><col ALIGN="right"></colgroup><colgroup><col ALIGN="center"><col ALIGN="center"><col ALIGN="center"></colgroup><caption ALIGN="top">Juggling Capabilities of Waterfront Performers</caption><thead><tr><th>Juggler</th><th>Pins</th><th>Bowling Balls</th><th>Flaming Baseballs</th></tr></thead><tbody><tr><td>Bob</td><td>5</td><td>2</td><td>5</td></tr><tr><td>Larry</td><td>2</td><td>7!!!</td><td>NA</td></tr><tr><td>Julie the Great</td><td>1</td><td>2</td><td>20<br>(She IS great!)</td></tr></tbody></table>

Result:

Juggling Capabilities of Waterfront Performers
JugglerPinsBowling BallsFlaming Baseballs
Bob525
Larry27!!!NA
Julie the Great1220
(She IS great!)