X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/25ef3491bd9ae007ff1fc2b0d7943e6eaaccf775..92c2b89db26be16707f4a805d3303ab2531006e1:/src/util/UpdateManager.js?ds=inline
diff --git a/src/util/UpdateManager.js b/src/util/UpdateManager.js
index 046c4c63..ab048f17 100644
--- a/src/util/UpdateManager.js
+++ b/src/util/UpdateManager.js
@@ -1,6 +1,6 @@
/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
+ * Ext JS Library 3.1.1
+ * Copyright(c) 2006-2010 Ext JS, LLC
* licensing@extjs.com
* http://www.extjs.com/license
*/
@@ -229,17 +229,17 @@ function() {
* If params are specified it uses POST, otherwise it uses GET.
* Note: 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 update event handler.
+ * data, use the callback option, or an update
event handler.
* @param {Object} options A config object containing any of the following options:
The URL to request or a function which * returns the URL (defaults to the value of {@link Ext.Ajax#url} if not specified).
The HTTP method to - * use. Defaults to POST if the params argument is present, otherwise GET.
params
argument is present, otherwise GET.
* 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.
If true + *
If true
* 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 after the execution of the scripts.
The config object passed to the update call.
The scope in which - * to execute the callback (The callback's this reference.) If the - * params argument is a function, this scope is used for that function also.
this
reference.) If the
+ * params
argument is a function, this scope is used for that function also.
* 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 discardUrl:true (defaults to false).
discardUrl:true
(defaults to false).
* The number of seconds to wait for a response before * timing out (defaults to {@link Ext.Updater.defaults#timeout}).
The text to use as the innerHTML of the @@ -332,14 +332,14 @@ function() { }, /** - *
Performs an async form post, updating this element with the response. If the form has the attribute + *
Performs an asynchronous form post, updating this element with the response. If the form has the attribute * enctype="multipart/form-data", it assumes it's a file upload. * Uses this.sslBlankUrl for SSL file uploads to prevent IE security warning.
*File uploads are not performed using normal "Ajax" techniques, that is they are not
* performed using XMLHttpRequests. Instead the form is submitted in the standard manner with the
- * DOM <form> element temporarily modified to have its
+ * DOM <form>
element temporarily modified to have its
* target set to refer
- * to a dynamically generated, hidden <iframe> which is inserted into the document
+ * to a dynamically generated, hidden <iframe>
which is inserted into the document
* but removed after the return data has been gathered.
Be aware that file upload packets, sent with the content type multipart/form-data * and some server technologies (notably JEE) may require some custom processing in order to @@ -516,17 +516,17 @@ Ext.Updater.updateElement = function(el, url, params, options){ /** * @class Ext.Updater.BasicRenderer - * Default Content renderer. Updates the elements innerHTML with the responseText. + *
This class is a base class implementing a simple render method which updates an element using results from an Ajax request.
+ *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.
*/ Ext.Updater.BasicRenderer = function(){}; Ext.Updater.BasicRenderer.prototype = { /** - * 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 */