TreeNode.js
上传用户:shuoshiled
上传日期:2018-01-28
资源大小:10124k
文件大小:18k
源码类别:

中间件编程

开发平台:

JavaScript

  1. /*!  * Ext JS Library 3.0.0  * Copyright(c) 2006-2009 Ext JS, LLC  * licensing@extjs.com  * http://www.extjs.com/license  */ /**
  2.  * @class Ext.tree.TreeNode
  3.  * @extends Ext.data.Node
  4.  * @cfg {String} text The text for this node
  5.  * @cfg {Boolean} expanded true to start the node expanded
  6.  * @cfg {Boolean} allowDrag False to make this node undraggable if {@link #draggable} = true (defaults to true)
  7.  * @cfg {Boolean} allowDrop False if this node cannot have child nodes dropped on it (defaults to true)
  8.  * @cfg {Boolean} disabled true to start the node disabled
  9.  * @cfg {String} icon The path to an icon for the node. The preferred way to do this
  10.  * is to use the cls or iconCls attributes and add the icon via a CSS background image.
  11.  * @cfg {String} cls A css class to be added to the node
  12.  * @cfg {String} iconCls A css class to be added to the nodes icon element for applying css background images
  13.  * @cfg {String} href URL of the link used for the node (defaults to #)
  14.  * @cfg {String} hrefTarget target frame for the link
  15.  * @cfg {Boolean} hidden True to render hidden. (Defaults to false).
  16.  * @cfg {String} qtip An Ext QuickTip for the node
  17.  * @cfg {Boolean} expandable If set to true, the node will always show a plus/minus icon, even when empty
  18.  * @cfg {String} qtipCfg An Ext QuickTip config for the node (used instead of qtip)
  19.  * @cfg {Boolean} singleClickExpand True for single click expand on this node
  20.  * @cfg {Function} uiProvider A UI <b>class</b> to use for this node (defaults to Ext.tree.TreeNodeUI)
  21.  * @cfg {Boolean} checked True to render a checked checkbox for this node, false to render an unchecked checkbox
  22.  * (defaults to undefined with no checkbox rendered)
  23.  * @cfg {Boolean} draggable True to make this node draggable (defaults to false)
  24.  * @cfg {Boolean} isTarget False to not allow this node to act as a drop target (defaults to true)
  25.  * @cfg {Boolean} allowChildren False to not allow this node to have child nodes (defaults to true)
  26.  * @cfg {Boolean} editable False to not allow this node to be edited by an (@link Ext.tree.TreeEditor} (defaults to true)
  27.  * @constructor
  28.  * @param {Object/String} attributes The attributes/config for the node or just a string with the text for the node
  29.  */
  30. Ext.tree.TreeNode = function(attributes){
  31.     attributes = attributes || {};
  32.     if(typeof attributes == "string"){
  33.         attributes = {text: attributes};
  34.     }
  35.     this.childrenRendered = false;
  36.     this.rendered = false;
  37.     Ext.tree.TreeNode.superclass.constructor.call(this, attributes);
  38.     this.expanded = attributes.expanded === true;
  39.     this.isTarget = attributes.isTarget !== false;
  40.     this.draggable = attributes.draggable !== false && attributes.allowDrag !== false;
  41.     this.allowChildren = attributes.allowChildren !== false && attributes.allowDrop !== false;
  42.     /**
  43.      * Read-only. The text for this node. To change it use setText().
  44.      * @type String
  45.      */
  46.     this.text = attributes.text;
  47.     /**
  48.      * True if this node is disabled.
  49.      * @type Boolean
  50.      */
  51.     this.disabled = attributes.disabled === true;
  52.     /**
  53.      * True if this node is hidden.
  54.      * @type Boolean
  55.      */
  56.     this.hidden = attributes.hidden === true;
  57.     this.addEvents(
  58.         /**
  59.         * @event textchange
  60.         * Fires when the text for this node is changed
  61.         * @param {Node} this This node
  62.         * @param {String} text The new text
  63.         * @param {String} oldText The old text
  64.         */
  65.         "textchange",
  66.         /**
  67.         * @event beforeexpand
  68.         * Fires before this node is expanded, return false to cancel.
  69.         * @param {Node} this This node
  70.         * @param {Boolean} deep
  71.         * @param {Boolean} anim
  72.         */
  73.         "beforeexpand",
  74.         /**
  75.         * @event beforecollapse
  76.         * Fires before this node is collapsed, return false to cancel.
  77.         * @param {Node} this This node
  78.         * @param {Boolean} deep
  79.         * @param {Boolean} anim
  80.         */
  81.         "beforecollapse",
  82.         /**
  83.         * @event expand
  84.         * Fires when this node is expanded
  85.         * @param {Node} this This node
  86.         */
  87.         "expand",
  88.         /**
  89.         * @event disabledchange
  90.         * Fires when the disabled status of this node changes
  91.         * @param {Node} this This node
  92.         * @param {Boolean} disabled
  93.         */
  94.         "disabledchange",
  95.         /**
  96.         * @event collapse
  97.         * Fires when this node is collapsed
  98.         * @param {Node} this This node
  99.         */
  100.         "collapse",
  101.         /**
  102.         * @event beforeclick
  103.         * Fires before click processing. Return false to cancel the default action.
  104.         * @param {Node} this This node
  105.         * @param {Ext.EventObject} e The event object
  106.         */
  107.         "beforeclick",
  108.         /**
  109.         * @event click
  110.         * Fires when this node is clicked
  111.         * @param {Node} this This node
  112.         * @param {Ext.EventObject} e The event object
  113.         */
  114.         "click",
  115.         /**
  116.         * @event checkchange
  117.         * Fires when a node with a checkbox's checked property changes
  118.         * @param {Node} this This node
  119.         * @param {Boolean} checked
  120.         */
  121.         "checkchange",
  122.         /**
  123.         * @event dblclick
  124.         * Fires when this node is double clicked
  125.         * @param {Node} this This node
  126.         * @param {Ext.EventObject} e The event object
  127.         */
  128.         "dblclick",
  129.         /**
  130.         * @event contextmenu
  131.         * Fires when this node is right clicked
  132.         * @param {Node} this This node
  133.         * @param {Ext.EventObject} e The event object
  134.         */
  135.         "contextmenu",
  136.         /**
  137.         * @event beforechildrenrendered
  138.         * Fires right before the child nodes for this node are rendered
  139.         * @param {Node} this This node
  140.         */
  141.         "beforechildrenrendered"
  142.     );
  143.     var uiClass = this.attributes.uiProvider || this.defaultUI || Ext.tree.TreeNodeUI;
  144.     /**
  145.      * Read-only. The UI for this node
  146.      * @type TreeNodeUI
  147.      */
  148.     this.ui = new uiClass(this);
  149. };
  150. Ext.extend(Ext.tree.TreeNode, Ext.data.Node, {
  151.     preventHScroll: true,
  152.     /**
  153.      * Returns true if this node is expanded
  154.      * @return {Boolean}
  155.      */
  156.     isExpanded : function(){
  157.         return this.expanded;
  158.     },
  159. /**
  160.  * Returns the UI object for this node.
  161.  * @return {TreeNodeUI} The object which is providing the user interface for this tree
  162.  * node. Unless otherwise specified in the {@link #uiProvider}, this will be an instance
  163.  * of {@link Ext.tree.TreeNodeUI}
  164.  */
  165.     getUI : function(){
  166.         return this.ui;
  167.     },
  168.     getLoader : function(){
  169.         var owner;
  170.         return this.loader || ((owner = this.getOwnerTree()) && owner.loader ? owner.loader : new Ext.tree.TreeLoader());
  171.     },
  172.     // private override
  173.     setFirstChild : function(node){
  174.         var of = this.firstChild;
  175.         Ext.tree.TreeNode.superclass.setFirstChild.call(this, node);
  176.         if(this.childrenRendered && of && node != of){
  177.             of.renderIndent(true, true);
  178.         }
  179.         if(this.rendered){
  180.             this.renderIndent(true, true);
  181.         }
  182.     },
  183.     // private override
  184.     setLastChild : function(node){
  185.         var ol = this.lastChild;
  186.         Ext.tree.TreeNode.superclass.setLastChild.call(this, node);
  187.         if(this.childrenRendered && ol && node != ol){
  188.             ol.renderIndent(true, true);
  189.         }
  190.         if(this.rendered){
  191.             this.renderIndent(true, true);
  192.         }
  193.     },
  194.     // these methods are overridden to provide lazy rendering support
  195.     // private override
  196.     appendChild : function(n){
  197.         if(!n.render && !Ext.isArray(n)){
  198.             n = this.getLoader().createNode(n);
  199.         }
  200.         var node = Ext.tree.TreeNode.superclass.appendChild.call(this, n);
  201.         if(node && this.childrenRendered){
  202.             node.render();
  203.         }
  204.         this.ui.updateExpandIcon();
  205.         return node;
  206.     },
  207.     // private override
  208.     removeChild : function(node){
  209.         this.ownerTree.getSelectionModel().unselect(node);
  210.         Ext.tree.TreeNode.superclass.removeChild.apply(this, arguments);
  211.         // if it's been rendered remove dom node
  212.         if(this.childrenRendered){
  213.             node.ui.remove();
  214.         }
  215.         if(this.childNodes.length < 1){
  216.             this.collapse(false, false);
  217.         }else{
  218.             this.ui.updateExpandIcon();
  219.         }
  220.         if(!this.firstChild && !this.isHiddenRoot()) {
  221.             this.childrenRendered = false;
  222.         }
  223.         return node;
  224.     },
  225.     // private override
  226.     insertBefore : function(node, refNode){
  227.         if(!node.render){ 
  228.             node = this.getLoader().createNode(node);
  229.         }
  230.         var newNode = Ext.tree.TreeNode.superclass.insertBefore.call(this, node, refNode);
  231.         if(newNode && refNode && this.childrenRendered){
  232.             node.render();
  233.         }
  234.         this.ui.updateExpandIcon();
  235.         return newNode;
  236.     },
  237.     /**
  238.      * Sets the text for this node
  239.      * @param {String} text
  240.      */
  241.     setText : function(text){
  242.         var oldText = this.text;
  243.         this.text = text;
  244.         this.attributes.text = text;
  245.         if(this.rendered){ // event without subscribing
  246.             this.ui.onTextChange(this, text, oldText);
  247.         }
  248.         this.fireEvent("textchange", this, text, oldText);
  249.     },
  250.     /**
  251.      * Triggers selection of this node
  252.      */
  253.     select : function(){
  254.         this.getOwnerTree().getSelectionModel().select(this);
  255.     },
  256.     /**
  257.      * Triggers deselection of this node
  258.      */
  259.     unselect : function(){
  260.         this.getOwnerTree().getSelectionModel().unselect(this);
  261.     },
  262.     /**
  263.      * Returns true if this node is selected
  264.      * @return {Boolean}
  265.      */
  266.     isSelected : function(){
  267.         return this.getOwnerTree().getSelectionModel().isSelected(this);
  268.     },
  269.     /**
  270.      * Expand this node.
  271.      * @param {Boolean} deep (optional) True to expand all children as well
  272.      * @param {Boolean} anim (optional) false to cancel the default animation
  273.      * @param {Function} callback (optional) A callback to be called when
  274.      * expanding this node completes (does not wait for deep expand to complete).
  275.      * Called with 1 parameter, this node.
  276.      * @param {Object} scope (optional) The scope in which to execute the callback.
  277.      */
  278.     expand : function(deep, anim, callback, scope){
  279.         if(!this.expanded){
  280.             if(this.fireEvent("beforeexpand", this, deep, anim) === false){
  281.                 return;
  282.             }
  283.             if(!this.childrenRendered){
  284.                 this.renderChildren();
  285.             }
  286.             this.expanded = true;
  287.             if(!this.isHiddenRoot() && (this.getOwnerTree().animate && anim !== false) || anim){
  288.                 this.ui.animExpand(function(){
  289.                     this.fireEvent("expand", this);
  290.                     this.runCallback(callback, scope || this, [this]);
  291.                     if(deep === true){
  292.                         this.expandChildNodes(true);
  293.                     }
  294.                 }.createDelegate(this));
  295.                 return;
  296.             }else{
  297.                 this.ui.expand();
  298.                 this.fireEvent("expand", this);
  299.                 this.runCallback(callback, scope || this, [this]);
  300.             }
  301.         }else{
  302.            this.runCallback(callback, scope || this, [this]);
  303.         }
  304.         if(deep === true){
  305.             this.expandChildNodes(true);
  306.         }
  307.     },
  308.     
  309.     runCallback: function(cb, scope, args){
  310.         if(Ext.isFunction(cb)){
  311.             cb.apply(scope, args);
  312.         }
  313.     },
  314.     isHiddenRoot : function(){
  315.         return this.isRoot && !this.getOwnerTree().rootVisible;
  316.     },
  317.     /**
  318.      * Collapse this node.
  319.      * @param {Boolean} deep (optional) True to collapse all children as well
  320.      * @param {Boolean} anim (optional) false to cancel the default animation
  321.      * @param {Function} callback (optional) A callback to be called when
  322.      * expanding this node completes (does not wait for deep expand to complete).
  323.      * Called with 1 parameter, this node.
  324.      * @param {Object} scope (optional) The scope in which to execute the callback.
  325.      */
  326.     collapse : function(deep, anim, callback, scope){
  327.         if(this.expanded && !this.isHiddenRoot()){
  328.             if(this.fireEvent("beforecollapse", this, deep, anim) === false){
  329.                 return;
  330.             }
  331.             this.expanded = false;
  332.             if((this.getOwnerTree().animate && anim !== false) || anim){
  333.                 this.ui.animCollapse(function(){
  334.                     this.fireEvent("collapse", this);
  335.                     this.runCallback(callback, scope || this, [this]);
  336.                     if(deep === true){
  337.                         this.collapseChildNodes(true);
  338.                     }
  339.                 }.createDelegate(this));
  340.                 return;
  341.             }else{
  342.                 this.ui.collapse();
  343.                 this.fireEvent("collapse", this);
  344.                 this.runCallback(callback, scope || this, [this]);
  345.             }
  346.         }else if(!this.expanded){
  347.             this.runCallback(callback, scope || this, [this]);
  348.         }
  349.         if(deep === true){
  350.             var cs = this.childNodes;
  351.             for(var i = 0, len = cs.length; i < len; i++) {
  352.              cs[i].collapse(true, false);
  353.             }
  354.         }
  355.     },
  356.     // private
  357.     delayedExpand : function(delay){
  358.         if(!this.expandProcId){
  359.             this.expandProcId = this.expand.defer(delay, this);
  360.         }
  361.     },
  362.     // private
  363.     cancelExpand : function(){
  364.         if(this.expandProcId){
  365.             clearTimeout(this.expandProcId);
  366.         }
  367.         this.expandProcId = false;
  368.     },
  369.     /**
  370.      * Toggles expanded/collapsed state of the node
  371.      */
  372.     toggle : function(){
  373.         if(this.expanded){
  374.             this.collapse();
  375.         }else{
  376.             this.expand();
  377.         }
  378.     },
  379.     /**
  380.      * Ensures all parent nodes are expanded, and if necessary, scrolls
  381.      * the node into view.
  382.      * @param {Function} callback (optional) A function to call when the node has been made visible.
  383.      * @param {Object} scope (optional) The scope in which to execute the callback.
  384.      */
  385.     ensureVisible : function(callback, scope){
  386.         var tree = this.getOwnerTree();
  387.         tree.expandPath(this.parentNode ? this.parentNode.getPath() : this.getPath(), false, function(){
  388.             var node = tree.getNodeById(this.id);  // Somehow if we don't do this, we lose changes that happened to node in the meantime
  389.             tree.getTreeEl().scrollChildIntoView(node.ui.anchor);
  390.             this.runCallback(callback, scope || this, [this]);
  391.         }.createDelegate(this));
  392.     },
  393.     /**
  394.      * Expand all child nodes
  395.      * @param {Boolean} deep (optional) true if the child nodes should also expand their child nodes
  396.      */
  397.     expandChildNodes : function(deep){
  398.         var cs = this.childNodes;
  399.         for(var i = 0, len = cs.length; i < len; i++) {
  400.          cs[i].expand(deep);
  401.         }
  402.     },
  403.     /**
  404.      * Collapse all child nodes
  405.      * @param {Boolean} deep (optional) true if the child nodes should also collapse their child nodes
  406.      */
  407.     collapseChildNodes : function(deep){
  408.         var cs = this.childNodes;
  409.         for(var i = 0, len = cs.length; i < len; i++) {
  410.          cs[i].collapse(deep);
  411.         }
  412.     },
  413.     /**
  414.      * Disables this node
  415.      */
  416.     disable : function(){
  417.         this.disabled = true;
  418.         this.unselect();
  419.         if(this.rendered && this.ui.onDisableChange){ // event without subscribing
  420.             this.ui.onDisableChange(this, true);
  421.         }
  422.         this.fireEvent("disabledchange", this, true);
  423.     },
  424.     /**
  425.      * Enables this node
  426.      */
  427.     enable : function(){
  428.         this.disabled = false;
  429.         if(this.rendered && this.ui.onDisableChange){ // event without subscribing
  430.             this.ui.onDisableChange(this, false);
  431.         }
  432.         this.fireEvent("disabledchange", this, false);
  433.     },
  434.     // private
  435.     renderChildren : function(suppressEvent){
  436.         if(suppressEvent !== false){
  437.             this.fireEvent("beforechildrenrendered", this);
  438.         }
  439.         var cs = this.childNodes;
  440.         for(var i = 0, len = cs.length; i < len; i++){
  441.             cs[i].render(true);
  442.         }
  443.         this.childrenRendered = true;
  444.     },
  445.     // private
  446.     sort : function(fn, scope){
  447.         Ext.tree.TreeNode.superclass.sort.apply(this, arguments);
  448.         if(this.childrenRendered){
  449.             var cs = this.childNodes;
  450.             for(var i = 0, len = cs.length; i < len; i++){
  451.                 cs[i].render(true);
  452.             }
  453.         }
  454.     },
  455.     // private
  456.     render : function(bulkRender){
  457.         this.ui.render(bulkRender);
  458.         if(!this.rendered){
  459.             // make sure it is registered
  460.             this.getOwnerTree().registerNode(this);
  461.             this.rendered = true;
  462.             if(this.expanded){
  463.                 this.expanded = false;
  464.                 this.expand(false, false);
  465.             }
  466.         }
  467.     },
  468.     // private
  469.     renderIndent : function(deep, refresh){
  470.         if(refresh){
  471.             this.ui.childIndent = null;
  472.         }
  473.         this.ui.renderIndent();
  474.         if(deep === true && this.childrenRendered){
  475.             var cs = this.childNodes;
  476.             for(var i = 0, len = cs.length; i < len; i++){
  477.                 cs[i].renderIndent(true, refresh);
  478.             }
  479.         }
  480.     },
  481.     beginUpdate : function(){
  482.         this.childrenRendered = false;
  483.     },
  484.     endUpdate : function(){
  485.         if(this.expanded && this.rendered){
  486.             this.renderChildren();
  487.         }
  488.     },
  489.     destroy : function(){
  490.         if(this.childNodes){
  491.             for(var i = 0,l = this.childNodes.length; i < l; i++){
  492.                 this.childNodes[i].destroy();
  493.             }
  494.             this.childNodes = null;
  495.         }
  496.         if(this.ui.destroy){
  497.             this.ui.destroy();
  498.         }
  499.     },
  500.     
  501.     // private
  502.     onIdChange: function(id){
  503.         this.ui.onIdChange(id);
  504.     }
  505. });
  506. Ext.tree.TreePanel.nodeTypes.node = Ext.tree.TreeNode;