User Guide

332 Chapter 2: ColdFusion Tags
cftable
Description
Builds a table in a ColdFusion page. This tag renders data as preformatted text, or, with the
HTMLTable attribute, in an HTML table. If you don't want to write HTML table tag code, or if
your data can be presented as preformatted text, use this tag.
Preformatted text (defined in HTML with the <pre> and </pre> tags) displays text in a fixed-
width font. It displays white space and line breaks exactly as they are written within the pre tags.
For more information, see an HTML reference guide.
To define table column and row characteristics, use the
cfcol tag within this tag.
Category
Data output tags
Syntax
<cftable
query = "query_name"
maxRows = "maxrows_table"
colSpacing = "number_of_spaces"
headerLines = "number_of_lines"
HTMLTable
border
colHeaders
startRow = "row_number">
...
</cftable>
See also
cfcol, cfoutput, cfcontent, cfprocessingdirective, cflog, cftable
Attributes
Attribute Req/Opt Default Description
query Required Name of
cfquery from which to draw data.
maxRows Optional Maximum number of rows to display in the table.
colSpacing Optional 2 Number of spaces between columns
headerLines Optional 2 Number of lines to use for table header (the default leaves one
line between header and first row of table).
HTMLTable Optional Renders data in an HTML 3.0 table.
If you use this attribute (regardless of its value), ColdFusion
renders data in an HTML table.
border Optional Displays border around table.
If you use this attribute (regardless of its value), ColdFusion
displays a border around the table.
Use this only if you use the
HTMLTable attribute.