Table of Contents
Advertisement
DEVELOPING COLDFUSION 9 APPLICATIONS
Requesting and Presenting Information
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:
Data tags
cfajaximport
cfajaxproxy
cfsprydataset
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 (
by default) occurs on a form control field specified by a bind parameter. This way, the value
onChange
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
for its contents. However, a dynamically loaded region binds to controls on the page that loads it, so the file specified by
the
attribute uses bind expressions that specify controls on the page that contains the
source
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
the full contents of the window.
For more examples, see
"Using Ajax User Interface Components and
for controls that support binding.
UI tags
cfdiv
cfgrid
cfinput
cflayout
cfmenu
cfpod
attribute of a
source
cfwindow
Last updated 8/5/2010
UI tags
cfselect
cftextarea
cftree
cftooltip
cfwindow
cflayoutarea
control, the page specified by the URL must return
Features" on page 804 and the reference pages
Functions
AjaxLink
AjaxOnLoad
DeserializeJSON
IsJSON
QueryConvertForGrid
SerializeJSON
tag uses a
attribute
source
tag.
cflayoutarea
860
Advertisement
Table of Contents
