cftreeitem

value

Required for applet, Flash, XML.value or bind is required for HTML.

Value passed when the form containing the tree 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.

bind

value or bind is required for HTML

A bind expression specifying a CFC function, JavaScript function, or URL that dynamically gets all tree nodes. You can use this attribute only at the top level of the tree, and in this case, the tree can have only cftreeitem tag.
If you use the bind attribute, the only other allowed attribute is onBindError. For details creating trees that using binding, see Using HTML trees in the Developing ColdFusion Applications

display

Optional;All

value

Tree item label. When populating a tree with data from a query, specify names in a delimited list, for example:display = "dept_name,emp_name"

expand

Optional;All

yes

• yes: expands tree to show tree item children.
• no: keeps tree item collapsed.

href

Optional;All

URL to link to if the user clicks the tree item. If you use a query attribute, the href attribute can specify a query column that contains URLs. If href is not a query column, the attribute text must be a URL or list of URLs. When populating a tree with data from a query, specify the URLs in a comma-delimited list, for example:{{href = "http://dept_svr,

"}}

img

Optional;Applet, HTML, object

folder

Image name, filename, or file URL for tree item icon. The following values are provided:

• cd
• computer
• document
• element
• folder
• floppy
• fixed
• remote
  You can also specify a custom image. To do so, include path and file extension; for example: img = "../images/page1.gif" You can also specify a path relative to the web root.Custom images are not supported for Flash format.
  To specify more than one image in a tree, or an image at the second or subsequent level, use commas to separate names, corresponding to level; for example:img = "folder,document" img = ",document" (example of second level)

imgopen

Optional;Applet, HTML, object

Icon displayed with open tree item, as described for the img attribute.

onBindError

Optional;HTML

see Description

The name of a JavaScript function to execute if evaluating a bind expression results in an error. The function must take two attributes: an HTTP status code and a message.
If you omit this attribute, and you specified a global error handler (by using the ColdFusion.setGlobalErrorHandler function), it displays the error message; otherwise a default error pop-up appears.

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.

query

Optional;All

Query name to use to populate the treeitem. ColdFusion generates an item for each field value in the query column list specified by the value attribute. The fields in each row are hierarchically linked to the first column.

queryAsRoot

Optional;All

yes

Applies only if you specify a query attribute. Defines the query as the root level for all items generated by this tag. This attribute lets you avoid creating a parent cftreeitem.

• yes: generates a parent (root) item for all other items generated by the tag, with the query name as its value; if you specify a parent attribute, the root item is a child of the specified parent.
• no: uses the item specified by the parent attribute as the immediate parent of all items generated by this tag. If there is no parent attribute, use the query as the parent.
• A string: creates a root item and uses the specified string as the item name; if you specify a parent attribute, the root item is a child of the specified parent.

target

Optional;All

Target attribute of href URL. When populating a tree with data from a query, specify targets in a comma-delimited list, for example:target = "FRAME_BODY,_blank"