User Guide

78 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
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 d i sp l a y t h e
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.
Example
<!--- This example shows the use of cfcol and cftable to align
information returned from a query --->
<!--- query selects information from cfsnippets data source --->
<cfquery name = "GetEmployees" dataSource = "cfsnippets">
SELECT Emp_ID, FirstName, LastName, EMail, Phone, Department
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.