MACROMEDIA ColdFusion MX, Develop Manual, Page: 614 / 860

614 Chapter 27: Building Dynamic Forms
ColdFusion passes the following arguments to the JavaScript function you specify in the
onvalidate
attribute:
•
The form object
•
The JavaScript input object corresponding to the tag whose value is being validated
•
The value of the control to validate
For example, if you code the
cfinput
tag as the following:
<cfinput type="text"
...
<!--- Do not include () in JavaScript function name --->
onvalidate="handleValidation"
...
>
You define the JavaScript function as the following:
<script>
<!--
function handleValidation(form_object, input_object, object_value) {
...
}
//-->
</script>
Handling failed validation
The
onerror
attribute lets you specify a JavaScript function to execute if a validation fails. For
example, if you use the
onvalidate
attribute to specify a JavaScript function to handle input
validation, you can also use the
onerror
attribute to specify a JavaScript function to handle a
failed validation (that is, when
onvalidate
returns a false value). If you use the
validate
attribute, you can also use the
onerror
attribute to specify a JavaScript function handle validation
errors. The following
cfform
tags support the
onerror
attribute:
•
cfgrid
•
cfinput
•
cfselect
•
cfslider
•
cftextinput
•
cftree
ColdFusion passes the following JavaScript objects to the function in the
onerror
attribute:
•
form_object
•
input_object
•
object_value
•
error message text