-<html>\r
-<head>\r
- <title>The source code</title>\r
- <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
- <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
-</head>\r
-<body onload="prettyPrint();">\r
- <pre class="prettyprint lang-js"><div id="cls-Ext.Updater"></div>/**
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+ <title>The source code</title>
+ <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+ <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+</head>
+<body onload="prettyPrint();">
+ <pre class="prettyprint lang-js">/*!
+ * Ext JS Library 3.2.1
+ * Copyright(c) 2006-2010 Ext JS, Inc.
+ * licensing@extjs.com
+ * http://www.extjs.com/license
+ */
+<div id="cls-Ext.Updater"></div>/**
* @class Ext.Updater
* @extends Ext.util.Observable
* Provides AJAX-style update capabilities for Element objects. Updater can be used to {@link #update}
* @param {Boolean} forceNew (optional) By default the constructor checks to see if the passed element already
* has an Updater and if it does it returns the same instance. This will skip that check (useful for extending this class).
*/
-Ext.UpdateManager = Ext.Updater = Ext.extend(Ext.util.Observable,
+Ext.UpdateManager = Ext.Updater = Ext.extend(Ext.util.Observable,
function() {
- var BEFOREUPDATE = "beforeupdate",
- UPDATE = "update",
- FAILURE = "failure";
-
- // private
- function processSuccess(response){
- var me = this;
+ var BEFOREUPDATE = "beforeupdate",
+ UPDATE = "update",
+ FAILURE = "failure";
+
+ // private
+ function processSuccess(response){
+ var me = this;
me.transaction = null;
if (response.argument.form && response.argument.reset) {
try { // put in try/catch since some older FF releases had problems with this
updateComplete.call(me, response);
}
}
-
+
// private
function updateComplete(response, type, success){
this.fireEvent(type || UPDATE, this.el, response);
}
// private
- function processFailure(response){
+ function processFailure(response){
updateComplete.call(this, response, FAILURE, !!(this.transaction = null));
}
-
- return {
- constructor: function(el, forceNew){
- var me = this;
- el = Ext.get(el);
- if(!forceNew && el.updateManager){
- return el.updateManager;
- }
-
<div id="prop-Ext.Updater-el"></div>/**
- * The Element object
- * @type Ext.Element
- */
- me.el = el;
-
<div id="prop-Ext.Updater-defaultUrl"></div>/**
- * Cached url to use for refreshes. Overwritten every time update() is called unless "discardUrl" param is set to true.
- * @type String
- */
- me.defaultUrl = null;
-
- me.addEvents(
-
<div id="event-Ext.Updater-beforeupdate"></div>/**
- * @event beforeupdate
- * Fired before an update is made, return false from your handler and the update is cancelled.
- * @param {Ext.Element} el
- * @param {String/Object/Function} url
- * @param {String/Object} params
- */
- BEFOREUPDATE,
-
<div id="event-Ext.Updater-update"></div>/**
- * @event update
- * Fired after successful update is made.
- * @param {Ext.Element} el
- * @param {Object} oResponseObject The response Object
- */
- UPDATE,
-
<div id="event-Ext.Updater-failure"></div>/**
- * @event failure
- * Fired on update failure.
- * @param {Ext.Element} el
- * @param {Object} oResponseObject The response Object
- */
- FAILURE
- );
-
- Ext.apply(me, Ext.Updater.defaults);
-
<div id="prop-Ext.Updater-sslBlankUrl"></div>/**
- * Blank page URL to use with SSL file uploads (defaults to {@link Ext.Updater.defaults#sslBlankUrl}).
- * @property sslBlankUrl
- * @type String
- */
-
<div id="prop-Ext.Updater-disableCaching"></div>/**
- * Whether to append unique parameter on get request to disable caching (defaults to {@link Ext.Updater.defaults#disableCaching}).
- * @property disableCaching
- * @type Boolean
- */
-
<div id="prop-Ext.Updater-indicatorText"></div>/**
- * Text for loading indicator (defaults to {@link Ext.Updater.defaults#indicatorText}).
- * @property indicatorText
- * @type String
- */
-
<div id="prop-Ext.Updater-showLoadIndicator"></div>/**
- * Whether to show indicatorText when loading (defaults to {@link Ext.Updater.defaults#showLoadIndicator}).
- * @property showLoadIndicator
- * @type String
- */
-
<div id="prop-Ext.Updater-timeout"></div>/**
- * Timeout for requests or form posts in seconds (defaults to {@link Ext.Updater.defaults#timeout}).
- * @property timeout
- * @type Number
- */
-
<div id="prop-Ext.Updater-loadScripts"></div>/**
- * True to process scripts in the output (defaults to {@link Ext.Updater.defaults#loadScripts}).
- * @property loadScripts
- * @type Boolean
- */
-
-
<div id="prop-Ext.Updater-transaction"></div>/**
- * Transaction object of the current executing transaction, or null if there is no active transaction.
- */
- me.transaction = null;
-
<div id="prop-Ext.Updater-refreshDelegate"></div>/**
- * Delegate for refresh() prebound to "this", use myUpdater.refreshDelegate.createCallback(arg1, arg2) to bind arguments
- * @type Function
- */
- me.refreshDelegate = me.refresh.createDelegate(me);
-
<div id="prop-Ext.Updater-updateDelegate"></div>/**
- * Delegate for update() prebound to "this", use myUpdater.updateDelegate.createCallback(arg1, arg2) to bind arguments
- * @type Function
- */
- me.updateDelegate = me.update.createDelegate(me);
-
<div id="prop-Ext.Updater-formUpdateDelegate"></div>/**
- * Delegate for formUpdate() prebound to "this", use myUpdater.formUpdateDelegate.createCallback(arg1, arg2) to bind arguments
- * @type Function
- */
- me.formUpdateDelegate = (me.formUpdate || function(){}).createDelegate(me);
-
-
<div id="prop-Ext.Updater-renderer"></div>/**
- * The renderer for this Updater (defaults to {@link Ext.Updater.BasicRenderer}).
- */
- me.renderer = me.renderer || me.getDefaultRenderer();
-
- Ext.Updater.superclass.constructor.call(me);
- },
-
-
<div id="method-Ext.Updater-setRenderer"></div>/**
- * Sets the content renderer for this Updater. See {@link Ext.Updater.BasicRenderer#render} for more details.
- * @param {Object} renderer The object implementing the render() method
- */
- setRenderer : function(renderer){
- this.renderer = renderer;
- },
-
-
<div id="method-Ext.Updater-getRenderer"></div>/**
- * Returns the current content renderer for this Updater. See {@link Ext.Updater.BasicRenderer#render} for more details.
- * @return {Object}
- */
- getRenderer : function(){
- return this.renderer;
- },
-
-
<div id="method-Ext.Updater-getDefaultRenderer"></div>/**
- * This is an overrideable method which returns a reference to a default
- * renderer class if none is specified when creating the Ext.Updater.
- * Defaults to {@link Ext.Updater.BasicRenderer}
- */
- getDefaultRenderer: function() {
- return new Ext.Updater.BasicRenderer();
- },
-
-
<div id="method-Ext.Updater-setDefaultUrl"></div>/**
- * Sets the default URL used for updates.
- * @param {String/Function} defaultUrl The url or a function to call to get the url
- */
- setDefaultUrl : function(defaultUrl){
- this.defaultUrl = defaultUrl;
- },
-
-
<div id="method-Ext.Updater-getEl"></div>/**
- * Get the Element this Updater is bound to
- * @return {Ext.Element} The element
- */
- getEl : function(){
- return this.el;
- },
-
-
<div id="method-Ext.Updater-update"></div>/**
- * Performs an <b>asynchronous</b> request, updating this element with the response.
- * If params are specified it uses POST, otherwise it uses GET.<br><br>
- * <b>Note:</b> Due to the asynchronous nature of remote server requests, the Element
- * will not have been fully updated when the function returns. To post-process the returned
- * data, use the callback option, or an <b><tt>update</tt></b> event handler.
-
* @param {Object} options A config object containing any of the following options:<ul>
-
* <li>url : <b>String/Function</b><p class="sub-desc">The URL to request or a function which
- * <i>returns</i> the URL (defaults to the value of {@link Ext.Ajax#url} if not specified).</p></li>
-
* <li>method : <b>String</b><p class="sub-desc">The HTTP method to
- * use. Defaults to POST if the <tt>params</tt> argument is present, otherwise GET.</p></li>
-
* <li>params : <b>String/Object/Function</b><p class="sub-desc">The
- * parameters to pass to the server (defaults to none). These may be specified as a url-encoded
- * string, or as an object containing properties which represent parameters,
- * or as a function, which returns such an object.</p></li>
- * <li>scripts : <b>Boolean</b><p class="sub-desc">If <tt>true</tt>
- * any <script> tags embedded in the response text will be extracted
- * and executed (defaults to {@link Ext.Updater.defaults#loadScripts}). If this option is specified,
- * the callback will be called <i>after</i> the execution of the scripts.</p></li>
-
* <li>callback : <b>Function</b><p class="sub-desc">A function to
- * be called when the response from the server arrives. The following
-
* parameters are passed:<ul>
-
* <li><b>el</b> : Ext.Element<p class="sub-desc">The Element being updated.</p></li>
-
* <li><b>success</b> : Boolean<p class="sub-desc">True for success, false for failure.</p></li>
-
* <li><b>response</b> : XMLHttpRequest<p class="sub-desc">The XMLHttpRequest which processed the update.</p></li>
-
* <li><b>options</b> : Object<p class="sub-desc">The config object passed to the update call.</p></li></ul>
- * </p></li>
-
* <li>scope : <b>Object</b><p class="sub-desc">The scope in which
- * to execute the callback (The callback's <tt>this</tt> reference.) If the
- * <tt>params</tt> argument is a function, this scope is used for that function also.</p></li>
-
* <li>discardUrl : <b>Boolean</b><p class="sub-desc">By default, the URL of this request becomes
- * the default URL for this Updater object, and will be subsequently used in {@link #refresh}
- * calls. To bypass this behavior, pass <tt>discardUrl:true</tt> (defaults to false).</p></li>
-
* <li>timeout : <b>Number</b><p class="sub-desc">The number of seconds to wait for a response before
- * timing out (defaults to {@link Ext.Updater.defaults#timeout}).</p></li>
-
* <li>text : <b>String</b><p class="sub-desc">The text to use as the innerHTML of the
- * {@link Ext.Updater.defaults#indicatorText} div (defaults to 'Loading...'). To replace the entire div, not
- * just the text, override {@link Ext.Updater.defaults#indicatorText} directly.</p></li>
-
* <li>nocache : <b>Boolean</b><p class="sub-desc">Only needed for GET
- * requests, this option causes an extra, auto-generated parameter to be appended to the request
- * to defeat caching (defaults to {@link Ext.Updater.defaults#disableCaching}).</p></li></ul>
- * For example:
- um.update({
- url: "your-url.php",
- params: {param1: "foo", param2: "bar"}, // or a URL encoded string
- callback: yourFunction,
- scope: yourObject, //(optional scope)
- discardUrl: true,
- nocache: true,
- text: "Loading...",
- timeout: 60,
- scripts: false // Save time by avoiding RegExp execution.
- });
- </code></pre>
- */
- update : function(url, params, callback, discardUrl){
- var me = this,
- cfg,
- callerScope;
-
- if(me.fireEvent(BEFOREUPDATE, me.el, url, params) !== false){
- if(Ext.isObject(url)){ // must be config object
- cfg = url;
- url = cfg.url;
- params = params || cfg.params;
- callback = callback || cfg.callback;
- discardUrl = discardUrl || cfg.discardUrl;
- callerScope = cfg.scope;
- if(!Ext.isEmpty(cfg.nocache)){me.disableCaching = cfg.nocache;};
-
if(!Ext.isEmpty(cfg.text)){me.indicatorText = '<div class="loading-indicator">'+cfg.text+"</div>";};
- if(!Ext.isEmpty(cfg.scripts)){me.loadScripts = cfg.scripts;};
- if(!Ext.isEmpty(cfg.timeout)){me.timeout = cfg.timeout;};
- }
- me.showLoading();
-
- if(!discardUrl){
- me.defaultUrl = url;
- }
- if(Ext.isFunction(url)){
- url = url.call(me);
- }
-
- var o = Ext.apply({}, {
- url : url,
- params: (Ext.isFunction(params) && callerScope) ? params.createDelegate(callerScope) : params,
- success: processSuccess,
- failure: processFailure,
- scope: me,
- callback: undefined,
- timeout: (me.timeout*1000),
- disableCaching: me.disableCaching,
- argument: {
- "options": cfg,
- "url": url,
- "form": null,
- "callback": callback,
- "scope": callerScope || window,
- "params": params
- }
- }, cfg);
-
- me.transaction = Ext.Ajax.request(o);
- }
- },
-
-
<div id="method-Ext.Updater-formUpdate"></div>/**
- * <p>Performs an async form post, updating this element with the response. If the form has the attribute
-
* enctype="<a href="http://www.faqs.org/rfcs/rfc2388.html">multipart/form-data</a>", it assumes it's a file upload.
- * Uses this.sslBlankUrl for SSL file uploads to prevent IE security warning.</p>
-
* <p>File uploads are not performed using normal "Ajax" techniques, that is they are <b>not</b>
- * performed using XMLHttpRequests. Instead the form is submitted in the standard manner with the
- * DOM <tt><form></tt> element temporarily modified to have its
-
* <a href="http://www.w3.org/TR/REC-html40/present/frames.html#adef-target">target</a> set to refer
- * to a dynamically generated, hidden <tt><iframe></tt> which is inserted into the document
- * but removed after the return data has been gathered.</p>
-
* <p>Be aware that file upload packets, sent with the content type <a href="http://www.faqs.org/rfcs/rfc2388.html">multipart/form-data</a>
- * and some server technologies (notably JEE) may require some custom processing in order to
- * retrieve parameter names and parameter values from the packet content.</p>
- * @param {String/HTMLElement} form The form Id or form element
- * @param {String} url (optional) The url to pass the form to. If omitted the action attribute on the form will be used.
- * @param {Boolean} reset (optional) Whether to try to reset the form after the update
- * @param {Function} callback (optional) Callback when transaction is complete. The following
-
* parameters are passed:<ul>
-
* <li><b>el</b> : Ext.Element<p class="sub-desc">The Element being updated.</p></li>
-
* <li><b>success</b> : Boolean<p class="sub-desc">True for success, false for failure.</p></li>
-
* <li><b>response</b> : XMLHttpRequest<p class="sub-desc">The XMLHttpRequest which processed the update.</p></li></ul>
- */
- formUpdate : function(form, url, reset, callback){
- var me = this;
- if(me.fireEvent(BEFOREUPDATE, me.el, form, url) !== false){
- if(Ext.isFunction(url)){
- url = url.call(me);
- }
- form = Ext.getDom(form)
- me.transaction = Ext.Ajax.request({
- form: form,
- url:url,
- success: processSuccess,
- failure: processFailure,
- scope: me,
- timeout: (me.timeout*1000),
- argument: {
- "url": url,
- "form": form,
- "callback": callback,
- "reset": reset
- }
- });
- me.showLoading.defer(1, me);
- }
- },
-
-
<div id="method-Ext.Updater-startAutoRefresh"></div>/**
- * Set this element to auto refresh. Can be canceled by calling {@link #stopAutoRefresh}.
- * @param {Number} interval How often to update (in seconds).
- * @param {String/Object/Function} url (optional) The url for this request, a config object in the same format
- * supported by {@link #load}, or a function to call to get the url (defaults to the last used url). Note that while
- * the url used in a load call can be reused by this method, other load config options will not be reused and must be
- * sepcified as part of a config object passed as this paramter if needed.
- * @param {String/Object} params (optional) The parameters to pass as either a url encoded string
- * "¶m1=1¶m2=2" or as an object {param1: 1, param2: 2}
- * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
- * @param {Boolean} refreshNow (optional) Whether to execute the refresh now, or wait the interval
- */
- startAutoRefresh : function(interval, url, params, callback, refreshNow){
- var me = this;
- if(refreshNow){
- me.update(url || me.defaultUrl, params, callback, true);
- }
- if(me.autoRefreshProcId){
- clearInterval(me.autoRefreshProcId);
- }
- me.autoRefreshProcId = setInterval(me.update.createDelegate(me, [url || me.defaultUrl, params, callback, true]), interval * 1000);
- },
-
-
<div id="method-Ext.Updater-stopAutoRefresh"></div>/**
- * Stop auto refresh on this element.
- */
- stopAutoRefresh : function(){
- if(this.autoRefreshProcId){
- clearInterval(this.autoRefreshProcId);
- delete this.autoRefreshProcId;
- }
- },
-
-
<div id="method-Ext.Updater-isAutoRefreshing"></div>/**
- * Returns true if the Updater is currently set to auto refresh its content (see {@link #startAutoRefresh}), otherwise false.
- */
- isAutoRefreshing : function(){
- return !!this.autoRefreshProcId;
- },
-
-
<div id="method-Ext.Updater-showLoading"></div>/**
- * Display the element's "loading" state. By default, the element is updated with {@link #indicatorText}. This
- * method may be overridden to perform a custom action while this Updater is actively updating its contents.
- */
- showLoading : function(){
- if(this.showLoadIndicator){
- this.el.dom.innerHTML = this.indicatorText;
- }
- },
-
-
<div id="method-Ext.Updater-abort"></div>/**
- * Aborts the currently executing transaction, if any.
- */
- abort : function(){
- if(this.transaction){
- Ext.Ajax.abort(this.transaction);
- }
- },
-
-
<div id="method-Ext.Updater-isUpdating"></div>/**
- * Returns true if an update is in progress, otherwise false.
- * @return {Boolean}
- */
- isUpdating : function(){
- return this.transaction ? Ext.Ajax.isLoading(this.transaction) : false;
- },
-
-
<div id="method-Ext.Updater-refresh"></div>/**
- * Refresh the element with the last used url or defaultUrl. If there is no url, it returns immediately
- * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
- */
- refresh : function(callback){
- if(this.defaultUrl){
- this.update(this.defaultUrl, null, callback, true);
- }
- }
+
+ return {
+ constructor: function(el, forceNew){
+ var me = this;
+ el = Ext.get(el);
+ if(!forceNew && el.updateManager){
+ return el.updateManager;
+ }
+ <div id="prop-Ext.Updater-el"></div>/**
+ * The Element object
+ * @type Ext.Element
+ */
+ me.el = el;
+ <div id="prop-Ext.Updater-defaultUrl"></div>/**
+ * Cached url to use for refreshes. Overwritten every time update() is called unless "discardUrl" param is set to true.
+ * @type String
+ */
+ me.defaultUrl = null;
+
+ me.addEvents(
+ <div id="event-Ext.Updater-beforeupdate"></div>/**
+ * @event beforeupdate
+ * Fired before an update is made, return false from your handler and the update is cancelled.
+ * @param {Ext.Element} el
+ * @param {String/Object/Function} url
+ * @param {String/Object} params
+ */
+ BEFOREUPDATE,
+ <div id="event-Ext.Updater-update"></div>/**
+ * @event update
+ * Fired after successful update is made.
+ * @param {Ext.Element} el
+ * @param {Object} oResponseObject The response Object
+ */
+ UPDATE,
+ <div id="event-Ext.Updater-failure"></div>/**
+ * @event failure
+ * Fired on update failure.
+ * @param {Ext.Element} el
+ * @param {Object} oResponseObject The response Object
+ */
+ FAILURE
+ );
+
+ Ext.apply(me, Ext.Updater.defaults);
+ <div id="prop-Ext.Updater-sslBlankUrl"></div>/**
+ * Blank page URL to use with SSL file uploads (defaults to {@link Ext.Updater.defaults#sslBlankUrl}).
+ * @property sslBlankUrl
+ * @type String
+ */
+ <div id="prop-Ext.Updater-disableCaching"></div>/**
+ * Whether to append unique parameter on get request to disable caching (defaults to {@link Ext.Updater.defaults#disableCaching}).
+ * @property disableCaching
+ * @type Boolean
+ */
+ <div id="prop-Ext.Updater-indicatorText"></div>/**
+ * Text for loading indicator (defaults to {@link Ext.Updater.defaults#indicatorText}).
+ * @property indicatorText
+ * @type String
+ */
+ <div id="prop-Ext.Updater-showLoadIndicator"></div>/**
+ * Whether to show indicatorText when loading (defaults to {@link Ext.Updater.defaults#showLoadIndicator}).
+ * @property showLoadIndicator
+ * @type String
+ */
+ <div id="prop-Ext.Updater-timeout"></div>/**
+ * Timeout for requests or form posts in seconds (defaults to {@link Ext.Updater.defaults#timeout}).
+ * @property timeout
+ * @type Number
+ */
+ <div id="prop-Ext.Updater-loadScripts"></div>/**
+ * True to process scripts in the output (defaults to {@link Ext.Updater.defaults#loadScripts}).
+ * @property loadScripts
+ * @type Boolean
+ */
+
+ <div id="prop-Ext.Updater-transaction"></div>/**
+ * Transaction object of the current executing transaction, or null if there is no active transaction.
+ */
+ me.transaction = null;
+ <div id="prop-Ext.Updater-refreshDelegate"></div>/**
+ * Delegate for refresh() prebound to "this", use myUpdater.refreshDelegate.createCallback(arg1, arg2) to bind arguments
+ * @type Function
+ */
+ me.refreshDelegate = me.refresh.createDelegate(me);
+ <div id="prop-Ext.Updater-updateDelegate"></div>/**
+ * Delegate for update() prebound to "this", use myUpdater.updateDelegate.createCallback(arg1, arg2) to bind arguments
+ * @type Function
+ */
+ me.updateDelegate = me.update.createDelegate(me);
+ <div id="prop-Ext.Updater-formUpdateDelegate"></div>/**
+ * Delegate for formUpdate() prebound to "this", use myUpdater.formUpdateDelegate.createCallback(arg1, arg2) to bind arguments
+ * @type Function
+ */
+ me.formUpdateDelegate = (me.formUpdate || function(){}).createDelegate(me);
+
+ <div id="prop-Ext.Updater-renderer"></div>/**
+ * The renderer for this Updater (defaults to {@link Ext.Updater.BasicRenderer}).
+ */
+ me.renderer = me.renderer || me.getDefaultRenderer();
+
+ Ext.Updater.superclass.constructor.call(me);
+ },
+
+ <div id="method-Ext.Updater-setRenderer"></div>/**
+ * Sets the content renderer for this Updater. See {@link Ext.Updater.BasicRenderer#render} for more details.
+ * @param {Object} renderer The object implementing the render() method
+ */
+ setRenderer : function(renderer){
+ this.renderer = renderer;
+ },
+
+ <div id="method-Ext.Updater-getRenderer"></div>/**
+ * Returns the current content renderer for this Updater. See {@link Ext.Updater.BasicRenderer#render} for more details.
+ * @return {Object}
+ */
+ getRenderer : function(){
+ return this.renderer;
+ },
+
+ <div id="method-Ext.Updater-getDefaultRenderer"></div>/**
+ * This is an overrideable method which returns a reference to a default
+ * renderer class if none is specified when creating the Ext.Updater.
+ * Defaults to {@link Ext.Updater.BasicRenderer}
+ */
+ getDefaultRenderer: function() {
+ return new Ext.Updater.BasicRenderer();
+ },
+
+ <div id="method-Ext.Updater-setDefaultUrl"></div>/**
+ * Sets the default URL used for updates.
+ * @param {String/Function} defaultUrl The url or a function to call to get the url
+ */
+ setDefaultUrl : function(defaultUrl){
+ this.defaultUrl = defaultUrl;
+ },
+
+ <div id="method-Ext.Updater-getEl"></div>/**
+ * Get the Element this Updater is bound to
+ * @return {Ext.Element} The element
+ */
+ getEl : function(){
+ return this.el;
+ },
+
+ <div id="method-Ext.Updater-update"></div>/**
+ * Performs an <b>asynchronous</b> request, updating this element with the response.
+ * If params are specified it uses POST, otherwise it uses GET.<br><br>
+ * <b>Note:</b> Due to the asynchronous nature of remote server requests, the Element
+ * will not have been fully updated when the function returns. To post-process the returned
+ * data, use the callback option, or an <b><code>update</code></b> event handler.
+ * @param {Object} options A config object containing any of the following options:<ul>
+ * <li>url : <b>String/Function</b><p class="sub-desc">The URL to request or a function which
+ * <i>returns</i> the URL (defaults to the value of {@link Ext.Ajax#url} if not specified).</p></li>
+ * <li>method : <b>String</b><p class="sub-desc">The HTTP method to
+ * use. Defaults to POST if the <code>params</code> argument is present, otherwise GET.</p></li>
+ * <li>params : <b>String/Object/Function</b><p class="sub-desc">The
+ * parameters to pass to the server (defaults to none). These may be specified as a url-encoded
+ * string, or as an object containing properties which represent parameters,
+ * or as a function, which returns such an object.</p></li>
+ * <li>scripts : <b>Boolean</b><p class="sub-desc">If <code>true</code>
+ * any <script> tags embedded in the response text will be extracted
+ * and executed (defaults to {@link Ext.Updater.defaults#loadScripts}). If this option is specified,
+ * the callback will be called <i>after</i> the execution of the scripts.</p></li>
+ * <li>callback : <b>Function</b><p class="sub-desc">A function to
+ * be called when the response from the server arrives. The following
+ * parameters are passed:<ul>
+ * <li><b>el</b> : Ext.Element<p class="sub-desc">The Element being updated.</p></li>
+ * <li><b>success</b> : Boolean<p class="sub-desc">True for success, false for failure.</p></li>
+ * <li><b>response</b> : XMLHttpRequest<p class="sub-desc">The XMLHttpRequest which processed the update.</p></li>
+ * <li><b>options</b> : Object<p class="sub-desc">The config object passed to the update call.</p></li></ul>
+ * </p></li>
+ * <li>scope : <b>Object</b><p class="sub-desc">The scope in which
+ * to execute the callback (The callback's <code>this</code> reference.) If the
+ * <code>params</code> argument is a function, this scope is used for that function also.</p></li>
+ * <li>discardUrl : <b>Boolean</b><p class="sub-desc">By default, the URL of this request becomes
+ * the default URL for this Updater object, and will be subsequently used in {@link #refresh}
+ * calls. To bypass this behavior, pass <code>discardUrl:true</code> (defaults to false).</p></li>
+ * <li>timeout : <b>Number</b><p class="sub-desc">The number of seconds to wait for a response before
+ * timing out (defaults to {@link Ext.Updater.defaults#timeout}).</p></li>
+ * <li>text : <b>String</b><p class="sub-desc">The text to use as the innerHTML of the
+ * {@link Ext.Updater.defaults#indicatorText} div (defaults to 'Loading...'). To replace the entire div, not
+ * just the text, override {@link Ext.Updater.defaults#indicatorText} directly.</p></li>
+ * <li>nocache : <b>Boolean</b><p class="sub-desc">Only needed for GET
+ * requests, this option causes an extra, auto-generated parameter to be appended to the request
+ * to defeat caching (defaults to {@link Ext.Updater.defaults#disableCaching}).</p></li></ul>
+ * <p>
+ * For example:
+ <pre><code>
+ um.update({
+ url: "your-url.php",
+ params: {param1: "foo", param2: "bar"}, // or a URL encoded string
+ callback: yourFunction,
+ scope: yourObject, //(optional scope)
+ discardUrl: true,
+ nocache: true,
+ text: "Loading...",
+ timeout: 60,
+ scripts: false // Save time by avoiding RegExp execution.
+ });
+ </code></pre>
+ */
+ update : function(url, params, callback, discardUrl){
+ var me = this,
+ cfg,
+ callerScope;
+
+ if(me.fireEvent(BEFOREUPDATE, me.el, url, params) !== false){
+ if(Ext.isObject(url)){ // must be config object
+ cfg = url;
+ url = cfg.url;
+ params = params || cfg.params;
+ callback = callback || cfg.callback;
+ discardUrl = discardUrl || cfg.discardUrl;
+ callerScope = cfg.scope;
+ if(!Ext.isEmpty(cfg.nocache)){me.disableCaching = cfg.nocache;};
+ if(!Ext.isEmpty(cfg.text)){me.indicatorText = '<div class="loading-indicator">'+cfg.text+"</div>";};
+ if(!Ext.isEmpty(cfg.scripts)){me.loadScripts = cfg.scripts;};
+ if(!Ext.isEmpty(cfg.timeout)){me.timeout = cfg.timeout;};
+ }
+ me.showLoading();
+
+ if(!discardUrl){
+ me.defaultUrl = url;
+ }
+ if(Ext.isFunction(url)){
+ url = url.call(me);
+ }
+
+ var o = Ext.apply({}, {
+ url : url,
+ params: (Ext.isFunction(params) && callerScope) ? params.createDelegate(callerScope) : params,
+ success: processSuccess,
+ failure: processFailure,
+ scope: me,
+ callback: undefined,
+ timeout: (me.timeout*1000),
+ disableCaching: me.disableCaching,
+ argument: {
+ "options": cfg,
+ "url": url,
+ "form": null,
+ "callback": callback,
+ "scope": callerScope || window,
+ "params": params
+ }
+ }, cfg);
+
+ me.transaction = Ext.Ajax.request(o);
+ }
+ },
+
+ <div id="method-Ext.Updater-formUpdate"></div>/**
+ * <p>Performs an asynchronous form post, updating this element with the response. If the form has the attribute
+ * enctype="<a href="http://www.faqs.org/rfcs/rfc2388.html">multipart/form-data</a>", it assumes it's a file upload.
+ * Uses this.sslBlankUrl for SSL file uploads to prevent IE security warning.</p>
+ * <p>File uploads are not performed using normal "Ajax" techniques, that is they are <b>not</b>
+ * performed using XMLHttpRequests. Instead the form is submitted in the standard manner with the
+ * DOM <code><form></code> element temporarily modified to have its
+ * <a href="http://www.w3.org/TR/REC-html40/present/frames.html#adef-target">target</a> set to refer
+ * to a dynamically generated, hidden <code><iframe></code> which is inserted into the document
+ * but removed after the return data has been gathered.</p>
+ * <p>Be aware that file upload packets, sent with the content type <a href="http://www.faqs.org/rfcs/rfc2388.html">multipart/form-data</a>
+ * and some server technologies (notably JEE) may require some custom processing in order to
+ * retrieve parameter names and parameter values from the packet content.</p>
+ * @param {String/HTMLElement} form The form Id or form element
+ * @param {String} url (optional) The url to pass the form to. If omitted the action attribute on the form will be used.
+ * @param {Boolean} reset (optional) Whether to try to reset the form after the update
+ * @param {Function} callback (optional) Callback when transaction is complete. The following
+ * parameters are passed:<ul>
+ * <li><b>el</b> : Ext.Element<p class="sub-desc">The Element being updated.</p></li>
+ * <li><b>success</b> : Boolean<p class="sub-desc">True for success, false for failure.</p></li>
+ * <li><b>response</b> : XMLHttpRequest<p class="sub-desc">The XMLHttpRequest which processed the update.</p></li></ul>
+ */
+ formUpdate : function(form, url, reset, callback){
+ var me = this;
+ if(me.fireEvent(BEFOREUPDATE, me.el, form, url) !== false){
+ if(Ext.isFunction(url)){
+ url = url.call(me);
+ }
+ form = Ext.getDom(form);
+ me.transaction = Ext.Ajax.request({
+ form: form,
+ url:url,
+ success: processSuccess,
+ failure: processFailure,
+ scope: me,
+ timeout: (me.timeout*1000),
+ argument: {
+ "url": url,
+ "form": form,
+ "callback": callback,
+ "reset": reset
+ }
+ });
+ me.showLoading.defer(1, me);
+ }
+ },
+
+ <div id="method-Ext.Updater-startAutoRefresh"></div>/**
+ * Set this element to auto refresh. Can be canceled by calling {@link #stopAutoRefresh}.
+ * @param {Number} interval How often to update (in seconds).
+ * @param {String/Object/Function} url (optional) The url for this request, a config object in the same format
+ * supported by {@link #load}, or a function to call to get the url (defaults to the last used url). Note that while
+ * the url used in a load call can be reused by this method, other load config options will not be reused and must be
+ * sepcified as part of a config object passed as this paramter if needed.
+ * @param {String/Object} params (optional) The parameters to pass as either a url encoded string
+ * "¶m1=1¶m2=2" or as an object {param1: 1, param2: 2}
+ * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
+ * @param {Boolean} refreshNow (optional) Whether to execute the refresh now, or wait the interval
+ */
+ startAutoRefresh : function(interval, url, params, callback, refreshNow){
+ var me = this;
+ if(refreshNow){
+ me.update(url || me.defaultUrl, params, callback, true);
+ }
+ if(me.autoRefreshProcId){
+ clearInterval(me.autoRefreshProcId);
+ }
+ me.autoRefreshProcId = setInterval(me.update.createDelegate(me, [url || me.defaultUrl, params, callback, true]), interval * 1000);
+ },
+
+ <div id="method-Ext.Updater-stopAutoRefresh"></div>/**
+ * Stop auto refresh on this element.
+ */
+ stopAutoRefresh : function(){
+ if(this.autoRefreshProcId){
+ clearInterval(this.autoRefreshProcId);
+ delete this.autoRefreshProcId;
+ }
+ },
+
+ <div id="method-Ext.Updater-isAutoRefreshing"></div>/**
+ * Returns true if the Updater is currently set to auto refresh its content (see {@link #startAutoRefresh}), otherwise false.
+ */
+ isAutoRefreshing : function(){
+ return !!this.autoRefreshProcId;
+ },
+
+ <div id="method-Ext.Updater-showLoading"></div>/**
+ * Display the element's "loading" state. By default, the element is updated with {@link #indicatorText}. This
+ * method may be overridden to perform a custom action while this Updater is actively updating its contents.
+ */
+ showLoading : function(){
+ if(this.showLoadIndicator){
+ this.el.dom.innerHTML = this.indicatorText;
+ }
+ },
+
+ <div id="method-Ext.Updater-abort"></div>/**
+ * Aborts the currently executing transaction, if any.
+ */
+ abort : function(){
+ if(this.transaction){
+ Ext.Ajax.abort(this.transaction);
+ }
+ },
+
+ <div id="method-Ext.Updater-isUpdating"></div>/**
+ * Returns true if an update is in progress, otherwise false.
+ * @return {Boolean}
+ */
+ isUpdating : function(){
+ return this.transaction ? Ext.Ajax.isLoading(this.transaction) : false;
+ },
+
+ <div id="method-Ext.Updater-refresh"></div>/**
+ * Refresh the element with the last used url or defaultUrl. If there is no url, it returns immediately
+ * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
+ */
+ refresh : function(callback){
+ if(this.defaultUrl){
+ this.update(this.defaultUrl, null, callback, true);
+ }
+ }
}
}());
* Timeout for requests or form posts in seconds (defaults to 30 seconds).
* @type Number
*/
- timeout : 30,
+ timeout : 30,
<div id="prop-Ext.Updater.defaults-disableCaching"></div>/**
* True to append a unique parameter to GET requests to disable caching (defaults to false).
* @type Boolean
* Blank page URL to use with SSL file uploads (defaults to {@link Ext#SSL_SECURE_URL} if set, or "javascript:false").
* @type String
*/
- sslBlankUrl : (Ext.SSL_SECURE_URL || "javascript:false")
+ sslBlankUrl : Ext.SSL_SECURE_URL
};
<div id="cls-Ext.Updater.BasicRenderer"></div>/**
* @class Ext.Updater.BasicRenderer
- * Default Content renderer. Updates the elements innerHTML with the responseText.
+ * <p>This class is a base class implementing a simple render method which updates an element using results from an Ajax request.</p>
+ * <p>The BasicRenderer updates the element's innerHTML with the responseText. To perform a custom render (i.e. XML or JSON processing),
+ * create an object with a conforming {@link #render} method and pass it to setRenderer on the Updater.</p>
*/
Ext.Updater.BasicRenderer = function(){};
Ext.Updater.BasicRenderer.prototype = {
<div id="method-Ext.Updater.BasicRenderer-render"></div>/**
- * This is called when the transaction is completed and it's time to update the element - The BasicRenderer
- * updates the elements innerHTML with the responseText - To perform a custom render (i.e. XML or JSON processing),
- * create an object with a "render(el, response)" method and pass it to setRenderer on the Updater.
+ * This method is called when an Ajax response is received, and an Element needs updating.
* @param {Ext.Element} el The element being rendered
- * @param {Object} response The XMLHttpRequest object
+ * @param {Object} xhr The XMLHttpRequest object
* @param {Updater} updateManager The calling update manager
* @param {Function} callback A callback that will need to be called if loadScripts is true on the Updater
*/
- render : function(el, response, updateManager, callback){
+ render : function(el, response, updateManager, callback){
el.update(response.responseText, updateManager.loadScripts, callback);
}
-};</pre> \r
-</body>\r
+};</pre>
+</body>
</html>
\ No newline at end of file
git.ithinksw.org / extjs.git / blobdiff