Adobe COLDFUSION 9, Manual, Page: 865 / 1350

860
DEVELOPING COLDFUSION 9 APPLICATIONS
Requesting and Presenting Information
Las t upda te d 8/5/2010
ColdFusion Ajax tags
The following table lists ColdFusion Ajax-related tags and functions, including all tags that support Ajax-based
features. It does not include subtags that are used only in the bodies of the listed tags:
Binding data to form fields
Many ColdFusion Ajax features use binding to provide dynamic interactivity based on user input or changing data.
When you use binding, a bind expression gets evaluated, and the display gets updated based on new data each time a
specific event (
onChange
by default) occurs on a form control field specified by a bind parameter . This way, the value
of the tag that specifies the bind expression, and the display, get updated dynamically based on changing information,
including user-entered form data. When you use binding the page contents updates, but the entire page is not
refreshed.
Note: When a bound window is not visible, or a tab is not selected, its contents is not updated when the controls it is bound
to change. When the tab or window is made visible, it is updated only if events have been received from the bound controls
while the control was not visible.
Depending on the specific ColdFusion tag, a bind expression uses bind parameter values directly or passes bind
parameter values as parameters to a CFC function, a JavaScript function, or an HTTP request and uses the function or
request response to update the page. Use the following as the data source for a bind expression:
•
ColdFusion form control attributes and values. You can bind to the following controls:
• cfgrid
•
cfinput with checkbox, datefield, file, hidden, radio, or text types
• cfselect
•
cftextarea
• cftree
•
Spry data set elements
Note: You cannot use a bind expression to bind to controls in a dynamically loaded region. For example, you cannot bind
from a control on one page to a control in a layout area on that page if the
cflayoutarea
tag uses a
source
attribute
for its contents. However, a dynamically loaded region binds to controls on the page that loads it, so the file specified by
the
source
attribute uses bind expressions that specify controls on the page that contains the
cflayoutarea
tag.
The results of the bind expression determine the value of the tag that uses the expression. For example, if you specify
a URL in a bind expression as the
source
attribute of a
cfwindow
control, the page specified by the URL must return
the full contents of the window.
For more examples, see “ Using Ajax User Interface Components and Features ” on page 804 and the reference pages
for controls that support binding.
Data tags UI tags UI tags Functions
cfajaximport cfdiv cfselect AjaxLink
cfajaxproxy cfgrid cftextarea AjaxOnLoad
cfsprydataset cfinput cftree DeserializeJSON
cflayout cftooltip IsJSON
cfmenu cfwindow QueryConvertForGrid
cfpod SerializeJSON