| dataUrl : StringThe URL from which to request a Json string which
-specifies an array of node definition objects representing the chi... The URL from which to request a Json string which
-specifies an array of node definition objects representing the child nodes
+ A TreeLoader provides for lazy loading of an Ext.tree.TreeNode's child
+nodes from a specified URL. The response must be a JavaScript Array definition
+whose elements are node definition objects. e.g.:
+ [{
+ id: 1,
+ text: 'A leaf Node',
+ leaf: true
+ },{
+ id: 2,
+ text: 'A folder Node',
+ children: [{
+ id: 3,
+ text: 'A child Node',
+ leaf: true
+ }]
+ }]
+
+A server request is sent, and child nodes are loaded only when a node is expanded.
+The loading node's id is passed to the server under the parameter name "node" to
+enable the server to produce the correct child nodes.
+
+To pass extra parameters, an event handler may be attached to the "beforeload"
+event, and the parameters specified in the TreeLoader's baseParams property:
+ myTreeLoader.on("beforeload", function(treeLoader, node) {
+ this.baseParams.category = node.attributes.category;
+ }, this);
+This would pass an HTTP parameter called "category" to the server containing
+the value of the Node's "category" attribute. Config Options|
| baseAttrs : ObjectAn object containing attributes to be added to all nodes
+created by this loader. If the attributes sent by the server... An object containing attributes to be added to all nodes
+created by this loader. If the attributes sent by the server have an attribute in this object,
+they take priority. | TreeLoader | | baseParams : Object An object containing properties which
+specify HTTP parameters to be passed to each request for child nodes. | TreeLoader | | clearOnLoad : Boolean Default to true. Remove previously existing
+child nodes before loading. | TreeLoader | | dataUrl : StringThe URL from which to request a Json string which
+specifies an array of node definition objects representing the chil... The URL from which to request a Json string which
+specifies an array of node definition objects representing the child nodes
to be loaded. | TreeLoader | | directFn : Function Function to call when executing a request. | TreeLoader | | listeners : ObjectA config object containing one or more event handlers to be added to this
object during initialization. This should ... A config object containing one or more event handlers to be added to this
object during initialization. This should be a valid listeners config object as specified in the
@@ -88,26 +88,26 @@ Ext.DomObserver = Ext.extend(Object, {
typeAhead: true,
mode: 'local',
triggerAction: 'all'
-}); | Observable | | nodeParameter : String The name of the parameter sent to the server which contains
-the identifier of the node. Defaults to 'node'. | TreeLoader | | paramOrder : Array/StringDefaults to undefined. Only used when using directFn.
-Specifies the params in the order in which they must be passed... Defaults to undefined. Only used when using directFn.
-Specifies the params in the order in which they must be passed to the server-side Direct method
-as either (1) an Array of String values, or (2) a String of params delimited by either whitespace,
-comma, or pipe. For example,
-any of the following would be acceptable: nodeParameter: 'node',
-paramOrder: ['param1','param2','param3']
-paramOrder: 'node param1 param2 param3'
-paramOrder: 'param1,node,param2,param3'
-paramOrder: 'param1|param2|param|node'
| TreeLoader | | paramsAsHash : BooleanOnly used when using directFn.
-Send parameters as a collection of named arguments (defaults to false). Providing a
-... Only used when using directFn.
-Send parameters as a collection of named arguments (defaults to false). Providing a
- paramOrder nullifies this configuration. | TreeLoader | | preloadChildren : Boolean If set to true, the loader recursively loads "children" attributes when doing the first load on nodes. | TreeLoader | | requestMethod : StringThe HTTP request method for loading data (defaults to the value of Ext.Ajax.method). | TreeLoader | | uiProviders : ObjectAn object containing properties which
-specify custom Ext.tree.TreeNodeUI implementations. If the optional
-uiProvide... An object containing properties which
-specify custom Ext.tree.TreeNodeUI implementations. If the optional
- uiProvider attribute of a returned child node is a string rather
-than a reference to a TreeNodeUI implementation, then that string value
+}); | Observable | | nodeParameter : String The name of the parameter sent to the server which contains
+the identifier of the node. Defaults to 'node'. | TreeLoader | | paramOrder : Array/StringDefaults to undefined. Only used when using directFn.
+Specifies the params in the order in which they must be passed ... Defaults to undefined. Only used when using directFn.
+Specifies the params in the order in which they must be passed to the server-side Direct method
+as either (1) an Array of String values, or (2) a String of params delimited by either whitespace,
+comma, or pipe. For example,
+any of the following would be acceptable: nodeParameter: 'node',
+paramOrder: ['param1','param2','param3']
+paramOrder: 'node param1 param2 param3'
+paramOrder: 'param1,node,param2,param3'
+paramOrder: 'param1|param2|param|node'
| TreeLoader | | paramsAsHash : BooleanOnly used when using directFn.
+Send parameters as a collection of named arguments (defaults to false). Providing a
+pa... Only used when using directFn.
+Send parameters as a collection of named arguments (defaults to false). Providing a
+ paramOrder nullifies this configuration. | TreeLoader | | preloadChildren : Boolean If set to true, the loader recursively loads "children" attributes when doing the first load on nodes. | TreeLoader | | requestMethod : StringThe HTTP request method for loading data (defaults to the value of Ext.Ajax.method). | TreeLoader | | uiProviders : ObjectAn object containing properties which
+specify custom Ext.tree.TreeNodeUI implementations. If the optional
+uiProvider ... An object containing properties which
+specify custom Ext.tree.TreeNodeUI implementations. If the optional
+ uiProvider attribute of a returned child node is a string rather
+than a reference to a TreeNodeUI implementation, then that string value
is used as a property name in the uiProviders object. | TreeLoader | | url : String | TreeLoader |
Public PropertiesThis class has no public properties. Public Methods|
| TreeLoader( Object config )
Creates a new Treeloader. Creates a new Treeloader. | TreeLoader | | addEvents( Object|String o , string Optional. )
:
@@ -166,59 +166,59 @@ Or a shorthand syntax:
scope: this
});Returns: | Observable | | createNode( attr {Object} )
:
- voidOverride this function for custom TreeNode node implementation, or to
-modify the attributes at creation time.
-Examp... Override this function for custom TreeNode node implementation, or to
-modify the attributes at creation time.
-Example: new Ext.tree.TreePanel({
- ...
- loader: new Ext.tree.TreeLoader({
- url: 'dataUrl',
- createNode: function(attr) {
-// Allow consolidation consignments to have
-// consignments dropped into them.
- if (attr.isConsolidation) {
- attr.iconCls = 'x-consol',
- attr.allowDrop = true;
- }
- return Ext.tree.TreeLoader.prototype.createNode.call(this, attr);
- }
- }),
- ...
+ voidOverride this function for custom TreeNode node implementation, or to
+modify the attributes at creation time.
+Example... Override this function for custom TreeNode node implementation, or to
+modify the attributes at creation time.
+Example: new Ext.tree.TreePanel({
+ ...
+ loader: new Ext.tree.TreeLoader({
+ url: 'dataUrl',
+ createNode: function(attr) {
+// Allow consolidation consignments to have
+// consignments dropped into them.
+ if (attr.isConsolidation) {
+ attr.iconCls = 'x-consol',
+ attr.allowDrop = true;
+ }
+ return Ext.tree.TreeLoader.prototype.createNode.call(this, attr);
+ }
+ }),
+ ...
});
| TreeLoader | | enableBubble( String/Array events )
:
- voidEnables events fired by this Observable to bubble up an owner hierarchy by calling
-this.getBubbleTarget() if present... Enables events fired by this Observable to bubble up an owner hierarchy by calling
-this.getBubbleTarget() if present. There is no implementation in the Observable base class.
- This is commonly used by Ext.Components to bubble events to owner Containers. See Ext.Component.getBubbleTarget. The default
-implementation in Ext.Component returns the Component's immediate owner. But if a known target is required, this can be overridden to
-access the required target more quickly.
- Example: Ext.override(Ext.form.Field, {
- // Add functionality to Field's initComponent to enable the change event to bubble
- initComponent : Ext.form.Field.prototype.initComponent.createSequence(function() {
- this.enableBubble('change');
- }),
-
- // We know that we want Field's events to bubble directly to the FormPanel.
- getBubbleTarget : function() {
- if (!this.formPanel) {
- this.formPanel = this.findParentByType('form');
- }
- return this.formPanel;
- }
-});
-
-var myForm = new Ext.formPanel({
- title: 'User Details',
- items: [{
- ...
- }],
- listeners: {
- change: function() {
- // Title goes red if form has been modified.
- myForm.header.setStyle('color', 'red');
- }
- }
+ voidEnables events fired by this Observable to bubble up an owner hierarchy by calling
+this.getBubbleTarget() if present.... Enables events fired by this Observable to bubble up an owner hierarchy by calling
+this.getBubbleTarget() if present. There is no implementation in the Observable base class.
+ This is commonly used by Ext.Components to bubble events to owner Containers. See Ext.Component.getBubbleTarget. The default
+implementation in Ext.Component returns the Component's immediate owner. But if a known target is required, this can be overridden to
+access the required target more quickly.
+ Example: Ext.override(Ext.form.Field, {
+ // Add functionality to Field's initComponent to enable the change event to bubble
+ initComponent : Ext.form.Field.prototype.initComponent.createSequence(function() {
+ this.enableBubble('change');
+ }),
+
+ // We know that we want Field's events to bubble directly to the FormPanel.
+ getBubbleTarget : function() {
+ if (!this.formPanel) {
+ this.formPanel = this.findParentByType('form');
+ }
+ return this.formPanel;
+ }
+});
+
+var myForm = new Ext.formPanel({
+ title: 'User Details',
+ items: [{
+ ...
+ }],
+ listeners: {
+ change: function() {
+ // Title goes red if form has been modified.
+ myForm.header.setStyle('color', 'red');
+ }
+ }
});
| Observable | | fireEvent( String eventName , Object... args )
:
BooleanFires the specified event with the passed parameters (minus the event name).
@@ -226,13 +226,13 @@ An event may be set to bubble up an Obse... | Observable | | hasListener( String eventName )
:
- BooleanChecks to see if this object has any listeners for a specified event Checks to see if this object has any listeners for a specified event | Observable | | load( Ext.tree.TreeNode node , Function callback , (Object) scope )
+ BooleanChecks to see if this object has any listeners for a specified event Checks to see if this object has any listeners for a specified event | Observable | | load( Ext.tree.TreeNode node , Function callback , Object scope )
:
- voidLoad an Ext.tree.TreeNode from the URL specified in the constructor.
-This is called automatically when a node is exp... Load an Ext.tree.TreeNode from the URL specified in the constructor.
-This is called automatically when a node is expanded, but may be used to reload
-a node (or append new children if the clearOnLoad option is false.) | TreeLoader | | on( String eventName , Function handler , [Object scope ], [Object options ] )
:
voidAppends an event handler to this object (shorthand for addListener.) Appends an event handler to this object (shorthand for addListener.) Parameters:eventName : StringThe type of event to listen for handler : FunctionThe method the event invokes scope : Object(optional) The scope (this reference) in which the handler function is executed.
|
|