ColdFusion.Ajax.submitForm
Submits form data without refreshing the page when the results are returned.
ColdFusion.Ajax.submitForm(formId,URL[,callbackhandler,errorhandler,httpMethod,asynch])
cfajaxproxy, ColdFusion.navigate, "Using the ColdFusion.Ajax.submitForm function" in the ColdFusion Developer's Guide
ColdFusion 8: Added this function
|
Parameter |
Description |
|---|---|
| formId |
The ID or name attribute of the form. |
| URL |
The URL to which to submit the form. |
| callbackhandler |
The JavaScript function to handle a normal response. The function must take a single argument, that contains the response body. This method is used only if the form submission is asynchronous. |
| errorhandler |
The JavaScript function to handle an HTTP error response. The function must take two arguments: the HTTP status code, and the error message. This method is used only if the form submission is asynchronous. |
| httpMethod |
The HTTP method to use for the submission, must be one of the following:
|
| asynch |
A Boolean value specifying whether to submit the form asynchronously. The default value is true. |
If the asynch argument is false, returns the response body. Otherwise, the function does not return a value.
If the page that calls this function does not have any ColdFusion AJAX-based controls, you must use a cfajaximport tag on the page to ensure that the page includes the JavaScript definition for this function.
See "Using the ColdFusion.Ajax.submitForm function" in the ColdFusion Developer's Guide.