|
<cfDiv [bind="string"] [bindonload="boolean"] [id="string"] [onbinderror="string"] [tagname="string"]> [</cfDiv>]
[] = Optional attribute
Creates an HTML tag with specified contents and lets you to use bind expressions to dynamically control the tag contents.
This tag may have a body.
The attributes for this tag are fixed. Except for the following attributes no other attributes are allowed.
| Name | Type | Required | Description |
| bind | string | No | A bind expression that returns the container contents. Note: If a CFML page specified in this attribute contains tags that use AJAX features, such as cfform, cfgrid, and cfwindow, you must use a tag on the page with the tag. For more information, see cfajaximport. |
| bindonload | boolean | No | - true (executes the bind attribute expression when first loading the tag. - false (does not execute the bind attribute expression until the first bound event) To use this attribute, you must also specify a bind attribute |
| id | string | No | The HTML ID attribute value to assign to the generated container tag. |
| onbinderror | string | No | 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. |
| tagname | string | No | The HTML container tag to create. |
By default, the cfdiv tag creates a div HTML element. You can use standard HTML and CSS techniques to control the position and appearance of the element and its contents.
If a bind is used the value returned is expected to be plain text to be pushed into the cfdiv element body. If value returned represent a json or xml string these will not be parsed.
Visit this page for more about the supported binding syntax.
<cfdiv bind="url:file.cfm?name={myForm:name}&age={myForm:age}" onBindError="onError" bindonload="false" id="mydiv"/>
A div with id mydiv is created and the contect will be updated any time the elements indicated in the bind expression change. Bindonload set to false will prevent the div to be filled on page load.
Every tag that use a bind expression can be programmatically refreshed via javascript :
Railo.Ajax.refresh('mydiv')
This command will refresh the div evaluating the bind expression. The string passed must match the id use by the cfdiv tag.