Properties Methods Events Config Options Direct Link

    Action
      Action.Submit

# Class Ext.form.Action.Submit

Package: | Ext.form
Defined In: | Action.js
Class: | Action.Submit
Extends: | Action

A class which handles submission of data from Forms and processes the returned response.
Instances of this class are only created by a Form when submitting.
A response packet must contain a boolean `success` property, and, optionally an `errors` property. The `errors` property contains error messages for invalid fields.
By default, response packets are assumed to be JSON, so a typical response packet may look like this:

    {
        success: false,
        errors: {
            clientCode: "Client not found",
            portOfLoading: "This field must not be null"
        }
    }

Other data may be placed into the response for processing the the Ext.form.BasicForm's callback or event handler methods. The object decoded from this JSON is available in the result property.

## Config Options

Config Options | Defined By
--- | ---
| clientValidation : boolean Determines whether a Form's fields are validated in a final call to isValid prior to submission. Pass false in the Fo... Determines whether a Form's fields are validated in a final call to isValid prior to submission. Pass `false` in the Form's submit options to prevent this. If not defined, pre-submission field validation is performed. | Action.Submit
| failure : Function The function to call when a failure packet was recieved, or when an error ocurred in the Ajax communication. The func... The function to call when a failure packet was recieved, or when an error ocurred in the Ajax communication. The function is passed the following parameters: form : Ext.form.BasicForm The form that requested the action action : Ext.form.Action The Action class. If an Ajax error ocurred, the failure type will be in failureType. The result property of this object may be examined to perform custom postprocessing. | Action
| method : String The HTTP method to use to access the requested URL. Defaults to the Ext.form.BasicForm's method, or if that is not sp... The HTTP method to use to access the requested URL. Defaults to the Ext.form.BasicForm's method, or if that is not specified, the underlying DOM form's method. | Action
| params : Mixed Extra parameter values to pass. These are added to the Form's Ext.form.BasicForm.baseParams and passed to the specifi... Extra parameter values to pass. These are added to the Form's Ext.form.BasicForm.baseParams and passed to the specified URL along with the Form's input fields. | Action
| scope : Object The scope in which to call the callback functions (The `this` reference for the callback functions). | Action
| success : Function The function to call when a valid success return packet is recieved. The function is passed the following parameters:... The function to call when a valid success return packet is recieved. The function is passed the following parameters: form : Ext.form.BasicForm The form that requested the action action : Ext.form.Action The Action class. The result property of this object may be examined to perform custom postprocessing. | Action
| url : String The URL that the Action is to invoke. | Action
| waitMsg : String The message to be displayed by a call to Ext.MessageBox.wait during the time the action is being processed. | Action
| waitTitle : String The title to be displayed by a call to Ext.MessageBox.wait during the time the action is being processed. | Action

## Public Properties

Property | Defined By
--- | ---
| failureType : String The type of failure detected. See CLIENT_INVALID, SERVER_INVALID, CONNECT_FAILURE, LOAD_FAILURE | Action
| response : Object The XMLHttpRequest object used to perform the action. | Action
| result : Object The decoded response object containing a boolean `success` property and other, action-specific properties. | Action
| type : String The type of action this Action instance performs. Currently only "submit" and "load" are supported. | Action

## Public Methods

This class has no public methods.

## Public Events

This class has no public events.