Properties Methods Events Config Options Direct Link
Action
  Action.Load

Class Ext.form.Action.Load

Package:Ext.form
Defined In:Action.js
Class:Action.Load
Subclasses:Action.DirectLoad
Extends:Action

A class which handles loading of data from a server into the Fields of an Ext.form.BasicForm.

Instances of this class are only created by a Form when loading.

Response Packet Criteria

A response packet must contain:

  • success property : Boolean
  • data property : Object
  • The data property contains the values of Fields to load. The individual value object for each Field is passed to the Field's setValue method.

JSON Packets

By default, response packets are assumed to be JSON, so for the following form load call:

var myFormPanel = new Ext.form.FormPanel({
    title: 'Client and routing info',
    items: [{
        fieldLabel: 'Client',
        name: 'clientName'
    }, {
        fieldLabel: 'Port of loading',
        name: 'portOfLoading'
    }, {
        fieldLabel: 'Port of discharge',
        name: 'portOfDischarge'
    }]
});
myFormPanel.getForm().load({
    url: '/getRoutingInfo.php',
    params: {
        consignmentRef: myConsignmentRef
    },
    failure: function(form, action) {
        Ext.Msg.alert("Load failed", action.result.errorMessage);
    }
});
a success response packet may look like this:

{
    success: true,
    data: {
        clientName: "Fred. Olsen Lines",
        portOfLoading: "FXT",
        portOfDischarge: "OSL"
    }
}
while a failure response packet may look like this:

{
    success: false,
    errorMessage: "Consignment reference not found"
}

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

Config Options

Config OptionsDefined By
 scope : Object
The scope in which to call the callback functions (The this reference for the callback functions).
Action
 submitEmptyText : Boolean
If set to true, the emptyText value will be sent with the form when it is submitted. Defaults to true.
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

PropertyDefined By
 response : Object
The XMLHttpRequest object used to perform the action.
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.