Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 730

DEVELOPING COLDFUSION 9 APPLICATIONS
Requesting and Presenting Information
Because the controls use JavaScript to return data to ColdFusion, if you disable JavaScript in your browser, it cannot
properly run forms that contain these controls. In that case, the controls still display, but data return and validation
does not work and you can receive a JavaScript error.
Because Java is handled by the plug-in and not directly by the browser, disabling Java execution in the browser does
not affect the operation of the controls. If for some other reason, however, the browser is unable to render the controls
as requested, a "not supported" message appears in place of the control.
You can use the tag's
cfform
You can avoid browser Java and JavaScript issues with the
versions of these controls. These controls work on Windows, Mac OS X, and Linux, and do not rely on Java support.
There is no Flash version of the
Building tree controls with the cftree tag
The tag lets you display hierarchical information within a form in a space-saving collapsible tree populated
cftree
from data source queries. To build a tree control with the
the control.
You can create trees in three formats:
Creates a Java applet that the client must download. Downloading an applet takes time; therefore, using the
Applet
tag can be slightly slower than using an HTML form element to retrieve the same information. In addition,
cftree
browsers must be Java-enabled for the
Generates a Flash control that you can include in an HTML or Flash form. For more information on Flash
Flash
Forms see "Creating Forms in
Creates a hierarchical ColdFusion structure that represents the tree data and many of the
Object
attributes.
cftreeitem
The different formats support different sets of features and attributes. The information here discusses general
techniques that apply to all three formats, and indicates any techniques that do not apply to a specific format. It uses
applet format for all examples, which use applet-specific attributes. For details on the features and attributes supported
in each format, see the
cftree
Create and populate a tree control from a query
Create a ColdFusion page with the following content:
1
<cfquery name="engquery" datasource="cfdocexamples">
SELECT FirstName || ' ' || LastName AS FullName
FROM Employee
</cfquery>
<cfform name="form1" action="submit.cfm">
<cftree name="tree1"
required="Yes"
hscroll="No">
<cftreeitem value="FullName"
query="engquery"
queryasroot="Yes"
img="folder,document">
</cftree>
</cfform>
2 Save the page as tree1.cfm and view it in your browser.
attribute to specify an alternative error message.
notsupported
control, and there is no applet version of the
cfslider
cftree
tag to work properly.
cftree
Flash" on page 765.
entry in the CFML Reference.
Last updated 1/20/2012
and controls by using the Flash format
cfgrid cftree
tag, you use individual
control.
cfcalendar
tags to populate
cftreeitem
and
cftree
725