Properties

Methods

Events

Config Options

Direct Link

Action
  Action.Submit
    SlingSubmitAction
      UploadSubmitAction

Class CQ.form.UploadSubmitAction

Package:	CQ.form
Class:	UploadSubmitAction
Extends:	CQ.form.SlingSubmitAction
Clientlib:	cq.widgets

A class which handles submission of data from Forms using plain HTTP, SWFUpload, Google Gears or XHR (FF3) for better file upload handling

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
	errorReader : CQ.Ext.data.DataReader Optional. JSON is interpreted with no need for an errorReader. A Reader which reads a single record from the returned... Optional. JSON is interpreted with no need for an errorReader. A Reader which reads a single record from the returned data. The DataReader's success property specifies how submission success is determined. The Record's data provides the error messages to apply to any invalid form Fields.	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 : CQ.Ext.form.BasicForm The form that requested the action action : CQ.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 CQ.Ext.form.BasicForm's method, or if that is not... The HTTP method to use to access the requested URL. Defaults to the CQ.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 CQ.Ext.form.BasicForm.baseParams and passed to the spec... Extra parameter values to pass. These are added to the Form's CQ.Ext.form.BasicForm.baseParams and passed to the specified URL along with the Form's input fields. Parameters are encoded as standard HTTP parameters using CQ.Ext.urlEncode.	Action
	reset : Boolean When set to true, causes the Form to be reset on Action success. If specified, this happens before the success callba... When set to `true`, causes the Form to be reset on Action success. If specified, this happens before the success callback is called and before the Form's actioncomplete event fires.	Action
	scope : Object The scope in which to call the callback functions (The this reference for the callback functions). 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. If set to `true`, the emptyText value will be sent with the form when it is submitted. Defaults to `true`.	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 : CQ.Ext.form.BasicForm The form that requested the action action : CQ.Ext.form.Action The Action class. The result property of this object may be examined to perform custom postprocessing.	Action
	timeout : Number The number of seconds to wait for a server response before failing with the failureType as Action.CONNECT_FAILURE. If... The number of seconds to wait for a server response before failing with the failureType as Action.CONNECT_FAILURE. If not specified, defaults to the configured `timeout` of the form.	Action
	url : String The URL that the Action is to invoke.	Action
	waitMsg : String The message to be displayed by a call to CQ.Ext.MessageBox.wait during the time the action is being processed. The message to be displayed by a call to CQ.Ext.MessageBox.wait during the time the action is being processed.	Action
	waitTitle : String The title to be displayed by a call to CQ.Ext.MessageBox.wait during the time the action is being processed. The title to be displayed by a call to CQ.Ext.MessageBox.wait during the time the action is being processed.	Action

Public Properties

Property		Defined By
	failureType : String The type of failure detected will be one of these: CLIENT_INVALID, SERVER_INVALID, CONNECT_FAILURE, or LOAD_FAILURE. ... The type of failure detected will be one of these: CLIENT_INVALID, SERVER_INVALID, CONNECT_FAILURE, or LOAD_FAILURE. Usage: var fp = new CQ.Ext.form.FormPanel({ ... buttons: [{ text: 'Save', formBind: true, handler: function(){ if(fp.getForm().isValid()){ fp.getForm().submit({ url: 'form-submit.php', waitMsg: 'Submitting your data...', success: function(form, action){ // server responded with success = true var result = action.result; }, failure: function(form, action){ if (action.failureType === CQ.Ext.form.Action.CONNECT_FAILURE) { CQ.Ext.Msg.alert('Error', 'Status:'+action.response.status+': '+ action.response.statusText); } if (action.failureType === CQ.Ext.form.Action.SERVER_INVALID){ // server responded with success = false CQ.Ext.Msg.alert('Invalid', action.result.errormsg); } } }); } } },{ text: 'Reset', handler: function(){ fp.getForm().reset(); } }]	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 Upload Submit Action instance performs. The value is "uploadsubmit".	UploadSubmitAction

Public Methods

This class has no public methods.

Public Events

This class has no public events.