col, colgroupNN 6 IE 4 DOM 1  

  

The col object reflects the col element; the colgroup object reflects the colgroup element. Both elements provide ways of assigning multiple adjacent columns to groups for convenience in assigning styles, widths, and other visual treatments.

 
HTML Equivalent
 
<col>
<colgroup>
 
Object Model Reference
 
[window.]document.getElementById("elementID")
 
Object-Specific Properties
 
alignchchOffspanvAlign
width
 
Object-Specific Methods

None.

 
Object-Specific Event Handler Properties

None.

alignNN 6 IE 4 DOM 1  

Read/Write  

Defines the horizontal alignment of content within cells covered by the col or colgroup element.

 
Example
 
document.getElementById("myCol").align = "center";
 
Value

Any of the three horizontal alignment constants: center | char | left | right.

 
Default

left

chNN 6 IE 6 DOM 1  

Read/Write  

Defines the text character used as an alignment point for text within a column or column group (reflecting the char attribute). This property is normally of value only for the align attribute set to "char". In practice, neither IE nor Navigator respond to these properties.

 
Example
 
document.getElementById("myCol").ch = ".";
 
Value

Single character string.

 
Default

None.

chOffNN 6 IE 6 DOM 1  

Read/Write  

Defines the offset point at which the character specified by the char attribute is to appear within a cell. In practice, neither IE 6 nor Netscape 6 respond to these properties.

 
Example
 
document.getElementById("myCol").chOff = "80%";
 
Value

String value of the number of pixels or percentage (within the cell).

 
Default

None.

spanNN 6 IE 4 DOM 1  

Read/Write  

Provides the number of adjacent columns for which the element's attribute and style settings apply.

 
Example
 
document.getElementById("myColgroup").span = 2;
 
Value

Integer.

 
Default

1

vAlignNN 6 IE 4 DOM 1  

Read/Write  

Provides the manner of vertical alignment of text within the column grouping's cells.

 
Example
 
document.getElementById("myCol").vAlign = "baseline";
 
Value

Case-insensitive constant (as a string): baseline | bottom | middle | top.

 
Default

middle

widthNN 6 IE 4 DOM 1  

Read/Write  

Provides the width in pixels of each column of the column grouping. Changes to these values are immediately reflected in reflowed content on the page.

 
Example
 
document.getElementById("myColgroup").width = 150;
 
Value

Integer.

 
Default

None.