User Guide

80 Chapter 2: ColdFusion Tags
cfcol
Description
Defines table column header, width, alignment, and text. Used within a cftable tag.
Category
Data output tags
Syntax
<cfcol
header = "column_header_text"
width = "number_indicating_width_of_column"
align = "left" or "right" or "center"
text = "column_text">
See also
cfcontent
, cfoutput, cftable; “Performing file operations with cfftp” in Chapter 40,
“Interacting with Remote Servers,” in ColdFusion MX Developer’s Guide
History
ColdFusion MX: Added the ability to construct dynamic cfcol statements.
Usage
At least one cfcol tag is required within the cftable tag. You must put cfcol and cftable tags
adjacent in a page. The only tag that you can nest within the
cftable tag is the cfcol tag. You
cannot nest
cftable tags.
To display the
cfcol header text, you must specify the cfcol header and the cftable
colHeader attribute. If you specify either attribute without the other, the header does not display.
No error is thrown.
Attribute Req/Opt Default Description
header Required Column header text. To use this attribute, you must also use the
cftable colHeaders attribute.
width Optional 20 Column width. If the length of data displayed exceeds this value,
data is truncated to fit. To avoid this, use an HTML
table tag.
If the surrounding
cftable tag includes the htmltable attribute,
width specifies the percent of the table width and it does not
truncate text; otherwise,
width specifies the number of
characters.
align Optional left Column alignment:
• left
• right
• center
text Required Double-quotation mark-delimited text; determines what to
display. Rules: same as for
cfoutput sections. You can embed
hyperlinks, image references, and input controls.