User Guide
cftable 333
Usage
This tag aligns table data, sets column widths, and defines column heads.
At least one
cfcol tag is required within this tag. You must put cfcol and cftable tags adjacent
in a page. The only tag that you can nest within this 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
and no error is thrown.
Example
<!--- This example shows the use of cfcol and cftable to align information
returned from a query --->
<!--- This query selects employee information from cfsnippets datasource --->
<cfquery name = "GetEmployees" dataSource = "cfsnippets">
SELECT Emp_ID, FirstName, LastName, EMail, Phone, Department
FROM Employees
</cfquery>
<html>
<body>
<h3>cftable Example</h3>
<!--- Note use of HTMLTable attribute to display cftable as an HTML table,
rather than as PRE formatted information --->
<cftable query = "GetEmployees"
startRow = "1" colSpacing = "3" HTMLTable>
<!--- each cfcol tag sets width of a column in table, and specifies header
information and text/CFML with which to fill cell --->
<cfcol header = "<b>ID</b>"
align = "Left"
width = 2
text = "#Emp_ID#">
<cfcol header = "<b>Name/Email</b>"
align = "Left"
width = 15
text = "<a href = ’mailto:#Email#’>#FirstName# #LastName#</A>">
<cfcol header = "<b>Phone Number</b>"
align = "Center"
width = 15
text = "#Phone#">
</cftable>
</body>
</html>
colHeaders Optional Displays column heads. If you use this attribute, you must also
use the cfcol tag
header attribute to define them.
If you use this attribute (regardless of its value), ColdFusion
displays column heads.
startRow Optional 1 The query result row to put in the first table row.
Attribute Req/Opt Default Description