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.