Upgrade to ExtJS 4.0.7 - Released 10/19/2011

[extjs.git] / src / ComponentLoader.js

diff --git a/src/ComponentLoader.js b/src/ComponentLoader.js
index 12390fb..1f30271 100644 (file)
--- a/src/ComponentLoader.js
+++ b/src/ComponentLoader.js
@@ -1,35 +1,49 @@
+/*
+
+This file is part of Ext JS 4
+
+Copyright (c) 2011 Sencha Inc
+
+Contact:  http://www.sencha.com/contact
+
+GNU General Public License Usage
+This file may be used under the terms of the GNU General Public License version 3.0 as published by the Free Software Foundation and appearing in the file LICENSE included in the packaging of this file.  Please review the following information to ensure the GNU General Public License version 3.0 requirements will be met: http://www.gnu.org/copyleft/gpl.html.
+
+If you are unsure which license is appropriate for your use, please contact the sales department at http://www.sencha.com/contact.
+
+*/
 /**
  * @class Ext.ComponentLoader
  * @extends Ext.ElementLoader
- * 
- * This class is used to load content via Ajax into a {@link Ext.Component}. In general 
+ *
+ * This class is used to load content via Ajax into a {@link Ext.Component}. In general
  * this class will not be instanced directly, rather a loader configuration will be passed to the
  * constructor of the {@link Ext.Component}.
- * 
+ *
  * ## HTML Renderer
  * By default, the content loaded will be processed as raw html. The response text
  * from the request is taken and added to the component. This can be used in
  * conjunction with the {@link #scripts} option to execute any inline scripts in
  * the resulting content. Using this renderer has the same effect as passing the
  * {@link Ext.Component#html} configuration option.
- * 
+ *
  * ## Data Renderer
  * This renderer allows content to be added by using JSON data and a {@link Ext.XTemplate}.
  * The content received from the response is passed to the {@link Ext.Component#update} method.
  * This content is run through the attached {@link Ext.Component#tpl} and the data is added to
  * the Component. Using this renderer has the same effect as using the {@link Ext.Component#data}
  * configuration in conjunction with a {@link Ext.Component#tpl}.
- * 
+ *
  * ## Component Renderer
- * This renderer can only be used with a {@link Ext.Container} and subclasses. It allows for
+ * This renderer can only be used with a {@link Ext.container.Container} and subclasses. It allows for
  * Components to be loaded remotely into a Container. The response is expected to be a single/series of
  * {@link Ext.Component} configuration objects. When the response is received, the data is decoded
- * and then passed to {@link Ext.Container#add}. Using this renderer has the same effect as specifying
- * the {@link Ext.Container#items} configuration on a Container. 
- * 
+ * and then passed to {@link Ext.container.Container#add}. Using this renderer has the same effect as specifying
+ * the {@link Ext.container.Container#items} configuration on a Container.
+ *
  * ## Custom Renderer
  * A custom function can be passed to handle any other special case, see the {@link #renderer} option.
- * 
+ *
  * ## Example Usage
  *     new Ext.Component({
  *         tpl: '{firstName} - {lastName}',
@@ -45,7 +59,7 @@
 Ext.define('Ext.ComponentLoader', {
 
     /* Begin Definitions */
-    
+
     extend: 'Ext.ElementLoader',
 
     statics: {
@@ -94,16 +108,16 @@ Ext.define('Ext.ComponentLoader', {
     /* End Definitions */
 
     /**
-     * @cfg {Ext.Component/String} target The target {@link Ext.Component} for the loader. Defaults to <tt>null</tt>.
+     * @cfg {Ext.Component/String} target The target {@link Ext.Component} for the loader.
      * If a string is passed it will be looked up via the id.
      */
     target: null,
 
     /**
-     * @cfg {Mixed} loadMask True or a {@link Ext.LoadMask} configuration to enable masking during loading. Defaults to <tt>false</tt>.
+     * @cfg {Boolean/Object} loadMask True or a {@link Ext.LoadMask} configuration to enable masking during loading.
      */
     loadMask: false,
-    
+
     /**
      * @cfg {Boolean} scripts True to parse any inline script tags in the response. This only used when using the html
      * {@link #renderer}.
@@ -118,8 +132,6 @@ The type of content that is to be loaded into, which can be one of 3 types:
 + **data** : Loads raw html content, see {@link Ext.Component#data}
 + **component** : Loads child {Ext.Component} instances. This option is only valid when used with a Container.
 
-Defaults to `html`.
-
 Alternatively, you can pass a function which is called with the following parameters.
 
 + loader - Loader instance
@@ -138,7 +150,6 @@ The function must return false is loading is not successful. Below is a sample o
             }
         }
     });
-     * @markdown
      */
     renderer: 'html',
 
@@ -150,7 +161,7 @@ The function must return false is loading is not successful. Below is a sample o
      */
     setTarget: function(target){
         var me = this;
-        
+
         if (Ext.isString(target)) {
             target = Ext.getCmp(target);
         }
@@ -160,16 +171,16 @@ The function must return false is loading is not successful. Below is a sample o
         }
         me.target = target;
     },
-    
+
     // inherit docs
     removeMask: function(){
         this.target.setLoading(false);
     },
-    
+
     /**
      * Add the mask on the target
      * @private
-     * @param {Mixed} mask The mask configuration
+     * @param {Boolean/Object} mask The mask configuration
      */
     addMask: function(mask){
         this.target.setLoading(mask);
@@ -179,7 +190,7 @@ The function must return false is loading is not successful. Below is a sample o
      * Get the target of this loader.
      * @return {Ext.Component} target The target, null if none exists.
      */
-    
+
     setOptions: function(active, options){
         active.removeAll = Ext.isDefined(options.removeAll) ? options.removeAll : this.removeAll;
     },
@@ -206,3 +217,4 @@ The function must return false is loading is not successful. Below is a sample o
         }
     }
 });
+