User Guide

436 Chapter 2: ColdFusion Tags
cftreeitem
Description
Populates a form tree control, created with the cftree tag, with one or more elements.
Category
Forms tags
Syntax
<cftreeitem
value = "text"
display = "text"
parent = "parent_name"
img = "filename"
imgopen = "filename"
href = "URL"
target = "URL_target"
query = "queryname"
queryAsRoot = "yes" or "no"
expand = "yes" or "no">
See also
cfapplet
, cfform, cfformgroup, cfformitem, cfgrid, cfinput, cfselect, cfslider,
cftextarea, cftree; “Building tree controls with the cftree tag” in Chapter 27, “Building
Dynamic Forms with cfform Tags,” in ColdFusion MX Developer’s Guide
Attributes
Note: In XML format, ColdFusion MX passes all attributes to the XML. The supplied XSLT skins do
not handle or display XML format trees, but do display applet and Flash format trees.
Attribute Req/Opt;
Format
Default Description
value Required;
All
Value passed when
cfform is submitted. When populating a
tree with data from a
cfquery, you can specify multiple columns
to use in a delimited list; for example,
value =
"dept_id,emp_id". In this case, each column generates an item
that is a child of the column that precedes it in the list.
display Optional;
All
value Tree item label. When populating a tree with data from a query,
specify names in a delimited list. Example:
display =
"dept_name,emp_name"
parent Optional;
All
Value of the tree item parent. Determines the item’s placement
in the tree hierarchy. If omitted, the item is placed at the tree
root level, or if the
queryAsRoot attribute is True, directly under
the query.