开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Internet/网络编程 > Ftp客户端 > 查看源码
treeview.js
资源名称：Serv-UFTPServerV9.3.0.1.rar　[点击查看]
上传用户：q2283699q
上传日期：2022-05-17
资源大小：10704k
文件大小：66k
源码类别：

Ftp客户端

开发平台：

Visual C++

treeview.js：源码内容
  1. /*
  2. Copyright (c) 2007, Yahoo! Inc. All rights reserved.
  3. Code licensed under the BSD License:
  4. http://developer.yahoo.net/yui/license.txt
  5. version: 2.3.0
  6. */
  7. /**
  8.  * The treeview widget is a generic tree building tool.
  9.  * @module treeview
  10.  * @title TreeView Widget
  11.  * @requires yahoo, event
  12.  * @optional animation
  13.  * @namespace YAHOO.widget
  14.  */
  16. /**
  17.  * Contains the tree view state data and the root node.
  18.  *
  19.  * @class TreeView
  20.  * @uses YAHOO.util.EventProvider
  21.  * @constructor
  22.  * @param {string|HTMLElement} id The id of the element, or the element
  23.  * itself that the tree will be inserted into.
  24.  */
  25. YAHOO.widget.TreeView = function(id) {
  26.     if (id) { this.init(id); }
  27. };
  29. YAHOO.widget.TreeView.prototype = {
  31.     /**
  32.      * The id of tree container element
  33.      * @property id
  34.      * @type String
  35.      */
  36.     id: null,
  38.     /**
  39.      * The host element for this tree
  40.      * @property _el
  41.      * @private
  42.      */
  43.     _el: null,
  45.      /**
  46.      * Flat collection of all nodes in this tree.  This is a sparse
  47.      * array, so the length property can't be relied upon for a
  48.      * node count for the tree.
  49.      * @property _nodes
  50.      * @type Node[]
  51.      * @private
  52.      */
  53.     _nodes: null,
  55.     /**
  56.      * We lock the tree control while waiting for the dynamic loader to return
  57.      * @property locked
  58.      * @type boolean
  59.      */
  60.     locked: false,
  62.     /**
  63.      * The animation to use for expanding children, if any
  64.      * @property _expandAnim
  65.      * @type string
  66.      * @private
  67.      */
  68.     _expandAnim: null,
  70.     /**
  71.      * The animation to use for collapsing children, if any
  72.      * @property _collapseAnim
  73.      * @type string
  74.      * @private
  75.      */
  76.     _collapseAnim: null,
  78.     /**
  79.      * The current number of animations that are executing
  80.      * @property _animCount
  81.      * @type int
  82.      * @private
  83.      */
  84.     _animCount: 0,
  86.     /**
  87.      * The maximum number of animations to run at one time.
  88.      * @property maxAnim
  89.      * @type int
  90.      */
  91.     maxAnim: 2,
  93.     /**
  94.      * Sets up the animation for expanding children
  95.      * @method setExpandAnim
  96.      * @param {string} type the type of animation (acceptable values defined 
  97.      * in YAHOO.widget.TVAnim)
  98.      */
  99.     setExpandAnim: function(type) {
  100.         if (YAHOO.widget.TVAnim.isValid(type)) {
  101.             this._expandAnim = type;
  102.         }
  103.     },
  105.     /**
  106.      * Sets up the animation for collapsing children
  107.      * @method setCollapseAnim
  108.      * @param {string} the type of animation (acceptable values defined in 
  109.      * YAHOO.widget.TVAnim)
  110.      */
  111.     setCollapseAnim: function(type) {
  112.         if (YAHOO.widget.TVAnim.isValid(type)) {
  113.             this._collapseAnim = type;
  114.         }
  115.     },
  117.     /**
  118.      * Perform the expand animation if configured, or just show the
  119.      * element if not configured or too many animations are in progress
  120.      * @method animateExpand
  121.      * @param el {HTMLElement} the element to animate
  122.      * @param node {YAHOO.util.Node} the node that was expanded
  123.      * @return {boolean} true if animation could be invoked, false otherwise
  124.      */
  125.     animateExpand: function(el, node) {
  127.         if (this._expandAnim && this._animCount < this.maxAnim) {
  128.             // this.locked = true;
  129.             var tree = this;
  130.             var a = YAHOO.widget.TVAnim.getAnim(this._expandAnim, el, 
  131.                             function() { tree.expandComplete(node); });
  132.             if (a) { 
  133.                 ++this._animCount;
  134.                 this.fireEvent("animStart", {
  135.                         "node": node, 
  136.                         "type": "expand"
  137.                     });
  138.                 a.animate();
  139.             }
  141.             return true;
  142.         }
  144.         return false;
  145.     },
  147.     /**
  148.      * Perform the collapse animation if configured, or just show the
  149.      * element if not configured or too many animations are in progress
  150.      * @method animateCollapse
  151.      * @param el {HTMLElement} the element to animate
  152.      * @param node {YAHOO.util.Node} the node that was expanded
  153.      * @return {boolean} true if animation could be invoked, false otherwise
  154.      */
  155.     animateCollapse: function(el, node) {
  157.         if (this._collapseAnim && this._animCount < this.maxAnim) {
  158.             // this.locked = true;
  159.             var tree = this;
  160.             var a = YAHOO.widget.TVAnim.getAnim(this._collapseAnim, el, 
  161.                             function() { tree.collapseComplete(node); });
  162.             if (a) { 
  163.                 ++this._animCount;
  164.                 this.fireEvent("animStart", {
  165.                         "node": node, 
  166.                         "type": "collapse"
  167.                     });
  168.                 a.animate();
  169.             }
  171.             return true;
  172.         }
  174.         return false;
  175.     },
  177.     /**
  178.      * Function executed when the expand animation completes
  179.      * @method expandComplete
  180.      */
  181.     expandComplete: function(node) {
  182.         --this._animCount;
  183.         this.fireEvent("animComplete", {
  184.                 "node": node, 
  185.                 "type": "expand"
  186.             });
  187.         // this.locked = false;
  188.     },
  190.     /**
  191.      * Function executed when the collapse animation completes
  192.      * @method collapseComplete
  193.      */
  194.     collapseComplete: function(node) {
  195.         --this._animCount;
  196.         this.fireEvent("animComplete", {
  197.                 "node": node, 
  198.                 "type": "collapse"
  199.             });
  200.         // this.locked = false;
  201.     },
  203.     /**
  204.      * Initializes the tree
  205.      * @method init
  206.      * @parm {string|HTMLElement} id the id of the element that will hold the tree
  207.      * @private
  208.      */
  209.     init: function(id) {
  211.         this.id = id;
  213.         if ("string" !== typeof id) {
  214.             this._el = id;
  215.             this.id = this.generateId(id);
  216.         }
  218.         /**
  219.          * When animation is enabled, this event fires when the animation
  220.          * starts
  221.          * @event animStart
  222.          * @type CustomEvent
  223.          * @param {YAHOO.widget.Node} node the node that is expanding/collapsing
  224.          * @parm {String} type the type of animation ("expand" or "collapse")
  225.          */
  226.         this.createEvent("animStart", this);
  228.         /**
  229.          * When animation is enabled, this event fires when the animation
  230.          * completes
  231.          * @event animComplete
  232.          * @type CustomEvent
  233.          * @param {YAHOO.widget.Node} node the node that is expanding/collapsing
  234.          * @parm {String} type the type of animation ("expand" or "collapse")
  235.          */
  236.         this.createEvent("animComplete", this);
  238.         /**
  239.          * Fires when a node is going to be collapsed.  Return false to stop
  240.          * the collapse.
  241.          * @event collapse
  242.          * @type CustomEvent
  243.          * @param {YAHOO.widget.Node} node the node that is collapsing
  244.          */
  245.         this.createEvent("collapse", this);
  247.         /**
  248.          * Fires after a node is successfully collapsed.  This event will not fire
  249.          * if the "collapse" event was cancelled.
  250.          * @event collapseComplete
  251.          * @type CustomEvent
  252.          * @param {YAHOO.widget.Node} node the node that was collapsed
  253.          */
  254.         this.createEvent("collapseComplete", this);
  256.         /**
  257.          * Fires when a node is going to be expanded.  Return false to stop
  258.          * the collapse.
  259.          * @event expand
  260.          * @type CustomEvent
  261.          * @param {YAHOO.widget.Node} node the node that is expanding
  262.          */
  263.         this.createEvent("expand", this);
  265.         /**
  266.          * Fires after a node is successfully expanded.  This event will not fire
  267.          * if the "expand" event was cancelled.
  268.          * @event expandComplete
  269.          * @type CustomEvent
  270.          * @param {YAHOO.widget.Node} node the node that was expanded
  271.          */
  272.         this.createEvent("expandComplete", this);
  274.         this._nodes = [];
  276.         // store a global reference
  277.         YAHOO.widget.TreeView.trees[this.id] = this;
  279.         // Set up the root node
  280.         this.root = new YAHOO.widget.RootNode(this);
  282.         var LW = YAHOO.widget.LogWriter;
  286.         // YAHOO.util.Event.onContentReady(this.id, this.handleAvailable, this, true);
  287.         // YAHOO.util.Event.on(this.id, "click", this.handleClick, this, true);
  288.     },
  290.     //handleAvailable: function() {
  291.         //var Event = YAHOO.util.Event;
  292.         //Event.on(this.id, 
  293.     //},
  295.     /**
  296.      * Renders the tree boilerplate and visible nodes
  297.      * @method draw
  298.      */
  299.     draw: function() {
  300.         var html = this.root.getHtml();
  301.         this.getEl().innerHTML = html;
  302.         this.firstDraw = false;
  303.     },
  305.     /**
  306.      * Returns the tree's host element
  307.      * @method getEl
  308.      * @return {HTMLElement} the host element
  309.      */
  310.     getEl: function() {
  311.         if (! this._el) {
  312.             this._el = document.getElementById(this.id);
  313.         }
  314.         return this._el;
  315.     },
  317.     /**
  318.      * Nodes register themselves with the tree instance when they are created.
  319.      * @method regNode
  320.      * @param node {Node} the node to register
  321.      * @private
  322.      */
  323.     regNode: function(node) {
  324.         this._nodes[node.index] = node;
  325.     },
  327.     /**
  328.      * Returns the root node of this tree
  329.      * @method getRoot
  330.      * @return {Node} the root node
  331.      */
  332.     getRoot: function() {
  333.         return this.root;
  334.     },
  336.     /**
  337.      * Configures this tree to dynamically load all child data
  338.      * @method setDynamicLoad
  339.      * @param {function} fnDataLoader the function that will be called to get the data
  340.      * @param iconMode {int} configures the icon that is displayed when a dynamic
  341.      * load node is expanded the first time without children.  By default, the 
  342.      * "collapse" icon will be used.  If set to 1, the leaf node icon will be
  343.      * displayed.
  344.      */
  345.     setDynamicLoad: function(fnDataLoader, iconMode) { 
  346.         this.root.setDynamicLoad(fnDataLoader, iconMode);
  347.     },
  349.     /**
  350.      * Expands all child nodes.  Note: this conflicts with the "multiExpand"
  351.      * node property.  If expand all is called in a tree with nodes that
  352.      * do not allow multiple siblings to be displayed, only the last sibling
  353.      * will be expanded.
  354.      * @method expandAll
  355.      */
  356.     expandAll: function() { 
  357.         if (!this.locked) {
  358.             this.root.expandAll(); 
  359.         }
  360.     },
  362.     /**
  363.      * Collapses all expanded child nodes in the entire tree.
  364.      * @method collapseAll
  365.      */
  366.     collapseAll: function() { 
  367.         if (!this.locked) {
  368.             this.root.collapseAll(); 
  369.         }
  370.     },
  372.     /**
  373.      * Returns a node in the tree that has the specified index (this index
  374.      * is created internally, so this function probably will only be used
  375.      * in html generated for a given node.)
  376.      * @method getNodeByIndex
  377.      * @param {int} nodeIndex the index of the node wanted
  378.      * @return {Node} the node with index=nodeIndex, null if no match
  379.      */
  380.     getNodeByIndex: function(nodeIndex) {
  381.         var n = this._nodes[nodeIndex];
  382.         return (n) ? n : null;
  383.     },
  385.     /**
  386.      * Returns a node that has a matching property and value in the data
  387.      * object that was passed into its constructor.
  388.      * @method getNodeByProperty
  389.      * @param {object} property the property to search (usually a string)
  390.      * @param {object} value the value we want to find (usuall an int or string)
  391.      * @return {Node} the matching node, null if no match
  392.      */
  393.     getNodeByProperty: function(property, value) {
  394.         for (var i in this._nodes) {
  395.             var n = this._nodes[i];
  396.             if (n.data && value == n.data[property]) {
  397.                 return n;
  398.             }
  399.         }
  401.         return null;
  402.     },
  404.     /**
  405.      * Returns a collection of nodes that have a matching property 
  406.      * and value in the data object that was passed into its constructor.  
  407.      * @method getNodesByProperty
  408.      * @param {object} property the property to search (usually a string)
  409.      * @param {object} value the value we want to find (usuall an int or string)
  410.      * @return {Array} the matching collection of nodes, null if no match
  411.      */
  412.     getNodesByProperty: function(property, value) {
  413.         var values = [];
  414.         for (var i in this._nodes) {
  415.             var n = this._nodes[i];
  416.             if (n.data && value == n.data[property]) {
  417.                 values.push(n);
  418.             }
  419.         }
  421.         return (values.length) ? values : null;
  422.     },
  424.     /**
  425.      * Removes the node and its children, and optionally refreshes the 
  426.      * branch of the tree that was affected.
  427.      * @method removeNode
  428.      * @param {Node} The node to remove
  429.      * @param {boolean} autoRefresh automatically refreshes branch if true
  430.      * @return {boolean} False is there was a problem, true otherwise.
  431.      */
  432.     removeNode: function(node, autoRefresh) { 
  434.         // Don't delete the root node
  435.         if (node.isRoot()) {
  436.             return false;
  437.         }
  439.         // Get the branch that we may need to refresh
  440.         var p = node.parent;
  441.         if (p.parent) {
  442.             p = p.parent;
  443.         }
  445.         // Delete the node and its children
  446.         this._deleteNode(node);
  448.         // Refresh the parent of the parent
  449.         if (autoRefresh && p && p.childrenRendered) {
  450.             p.refresh();
  451.         }
  453.         return true;
  454.     },
  456.     /**
  457.      * Deletes this nodes child collection, recursively.  Also collapses
  458.      * the node, and resets the dynamic load flag.  The primary use for
  459.      * this method is to purge a node and allow it to fetch its data
  460.      * dynamically again.
  461.      * @method removeChildren
  462.      * @param {Node} node the node to purge
  463.      */
  464.     removeChildren: function(node) { 
  465.         while (node.children.length) {
  466.             this._deleteNode(node.children[0]);
  467.         }
  469.         node.childrenRendered = false;
  470.         node.dynamicLoadComplete = false;
  471.         if (node.expanded) {
  472.             node.collapse();
  473.         } else {
  474.             node.updateIcon();
  475.         }
  476.     },
  478.     /**
  479.      * Deletes the node and recurses children
  480.      * @method _deleteNode
  481.      * @private
  482.      */
  483.     _deleteNode: function(node) { 
  484.         // Remove all the child nodes first
  485.         this.removeChildren(node);
  487.         // Remove the node from the tree
  488.         this.popNode(node);
  489.     },
  491.     /**
  492.      * Removes the node from the tree, preserving the child collection 
  493.      * to make it possible to insert the branch into another part of the 
  494.      * tree, or another tree.
  495.      * @method popNode
  496.      * @param {Node} the node to remove
  497.      */
  498.     popNode: function(node) { 
  499.         var p = node.parent;
  501.         // Update the parent's collection of children
  502.         var a = [];
  504.         for (var i=0, len=p.children.length;i<len;++i) {
  505.             if (p.children[i] != node) {
  506.                 a[a.length] = p.children[i];
  507.             }
  508.         }
  510.         p.children = a;
  512.         // reset the childrenRendered flag for the parent
  513.         p.childrenRendered = false;
  515.          // Update the sibling relationship
  516.         if (node.previousSibling) {
  517.             node.previousSibling.nextSibling = node.nextSibling;
  518.         }
  520.         if (node.nextSibling) {
  521.             node.nextSibling.previousSibling = node.previousSibling;
  522.         }
  524.         node.parent = null;
  525.         node.previousSibling = null;
  526.         node.nextSibling = null;
  527.         node.tree = null;
  529.         // Update the tree's node collection 
  530.         delete this._nodes[node.index];
  531.     },
  534.     /**
  535.      * TreeView instance toString
  536.      * @method toString
  537.      * @return {string} string representation of the tree
  538.      */
  539.     toString: function() {
  540.         return "TreeView " + this.id;
  541.     },
  543.     /**
  544.      * Generates an unique id for an element if it doesn't yet have one
  545.      * @method generateId
  546.      * @private
  547.      */
  548.     generateId: function(el) {
  549.         var id = el.id;
  551.         if (!id) {
  552.             id = "yui-tv-auto-id-" + YAHOO.widget.TreeView.counter;
  553.             ++YAHOO.widget.TreeView.counter;
  554.         }
  556.         return id;
  557.     },
  559.     /**
  560.      * Abstract method that is executed when a node is expanded
  561.      * @method onExpand
  562.      * @param node {Node} the node that was expanded
  563.      * @deprecated use treeobj.subscribe("expand") instead
  564.      */
  565.     onExpand: function(node) { },
  567.     /**
  568.      * Abstract method that is executed when a node is collapsed.
  569.      * @method onCollapse
  570.      * @param node {Node} the node that was collapsed.
  571.      * @deprecated use treeobj.subscribe("collapse") instead
  572.      */
  573.     onCollapse: function(node) { }
  575. };
  577. YAHOO.augment(YAHOO.widget.TreeView, YAHOO.util.EventProvider);
  579. /**
  580.  * Running count of all nodes created in all trees.  This is 
  581.  * used to provide unique identifies for all nodes.  Deleting
  582.  * nodes does not change the nodeCount.
  583.  * @property YAHOO.widget.TreeView.nodeCount
  584.  * @type int
  585.  * @static
  586.  */
  587. YAHOO.widget.TreeView.nodeCount = 0;
  589. /**
  590.  * Global cache of tree instances
  591.  * @property YAHOO.widget.TreeView.trees
  592.  * @type Array
  593.  * @static
  594.  * @private
  595.  */
  596. YAHOO.widget.TreeView.trees = [];
  598. /**
  599.  * Counter for generating a new unique element id
  600.  * @property YAHOO.widget.TreeView.counter
  601.  * @static
  602.  * @private
  603.  */
  604. YAHOO.widget.TreeView.counter = 0;
  606. /**
  607.  * Global method for getting a tree by its id.  Used in the generated
  608.  * tree html.
  609.  * @method YAHOO.widget.TreeView.getTree
  610.  * @param treeId {String} the id of the tree instance
  611.  * @return {TreeView} the tree instance requested, null if not found.
  612.  * @static
  613.  */
  614. YAHOO.widget.TreeView.getTree = function(treeId) {
  615.     var t = YAHOO.widget.TreeView.trees[treeId];
  616.     return (t) ? t : null;
  617. };
  620. /**
  621.  * Global method for getting a node by its id.  Used in the generated
  622.  * tree html.
  623.  * @method YAHOO.widget.TreeView.getNode
  624.  * @param treeId {String} the id of the tree instance
  625.  * @param nodeIndex {String} the index of the node to return
  626.  * @return {Node} the node instance requested, null if not found
  627.  * @static
  628.  */
  629. YAHOO.widget.TreeView.getNode = function(treeId, nodeIndex) {
  630.     var t = YAHOO.widget.TreeView.getTree(treeId);
  631.     return (t) ? t.getNodeByIndex(nodeIndex) : null;
  632. };
  634. /**
  635.  * Add a DOM event
  636.  * @method YAHOO.widget.TreeView.addHandler
  637.  * @param el the elment to bind the handler to
  638.  * @param {string} sType the type of event handler
  639.  * @param {function} fn the callback to invoke
  640.  * @static
  641.  */
  642. YAHOO.widget.TreeView.addHandler = function (el, sType, fn) {
  643.     if (el.addEventListener) {
  644.         el.addEventListener(sType, fn, false);
  645.     } else if (el.attachEvent) {
  646.         el.attachEvent("on" + sType, fn);
  647.     }
  648. };
  650. /**
  651.  * Remove a DOM event
  652.  * @method YAHOO.widget.TreeView.removeHandler
  653.  * @param el the elment to bind the handler to
  654.  * @param {string} sType the type of event handler
  655.  * @param {function} fn the callback to invoke
  656.  * @static
  657.  */
  659. YAHOO.widget.TreeView.removeHandler = function (el, sType, fn) {
  660.     if (el.removeEventListener) {
  661.         el.removeEventListener(sType, fn, false);
  662.     } else if (el.detachEvent) {
  663.         el.detachEvent("on" + sType, fn);
  664.     }
  665. };
  667. /**
  668.  * Attempts to preload the images defined in the styles used to draw the tree by
  669.  * rendering off-screen elements that use the styles.
  670.  * @method YAHOO.widget.TreeView.preload
  671.  * @param {string} prefix the prefix to use to generate the names of the
  672.  * images to preload, default is ygtv
  673.  * @static
  674.  */
  675. YAHOO.widget.TreeView.preload = function(e, prefix) {
  676.     prefix = prefix || "ygtv";
  679.     var styles = ["tn","tm","tmh","tp","tph","ln","lm","lmh","lp","lph","loading"];
  680.     // var styles = ["tp"];
  682.     var sb = [];
  683.     
  684.     // save the first one for the outer container
  685.     for (var i=1; i < styles.length; i=i+1) { 
  686.         sb[sb.length] = '<span class="' + prefix + styles[i] + '">&#160;</span>';
  687.     }
  689.     var f = document.createElement("div");
  690.     var s = f.style;
  691.     s.className = prefix + styles[0];
  692.     s.position = "absolute";
  693.     s.height = "1px";
  694.     s.width = "1px";
  695.     s.top = "-1000px";
  696.     s.left = "-1000px";
  697.     f.innerHTML = sb.join("");
  699.     document.body.appendChild(f);
  701.     YAHOO.widget.TreeView.removeHandler(window, 
  702.                 "load", YAHOO.widget.TreeView.preload);
  704. };
  706. YAHOO.widget.TreeView.addHandler(window, 
  707.                 "load", YAHOO.widget.TreeView.preload);
  709. /**
  710.  * The base class for all tree nodes.  The node's presentation and behavior in
  711.  * response to mouse events is handled in Node subclasses.
  712.  * @namespace YAHOO.widget
  713.  * @class Node
  714.  * @uses YAHOO.util.EventProvider
  715.  * @param oData {object} a string or object containing the data that will
  716.  * be used to render this node
  717.  * @param oParent {Node} this node's parent node
  718.  * @param expanded {boolean} the initial expanded/collapsed state
  719.  * @constructor
  720.  */
  721. YAHOO.widget.Node = function(oData, oParent, expanded) {
  722.     if (oData) { this.init(oData, oParent, expanded); }
  723. };
  725. YAHOO.widget.Node.prototype = {
  727.     /**
  728.      * The index for this instance obtained from global counter in YAHOO.widget.TreeView.
  729.      * @property index
  730.      * @type int
  731.      */
  732.     index: 0,
  734.     /**
  735.      * This node's child node collection.
  736.      * @property children
  737.      * @type Node[] 
  738.      */
  739.     children: null,
  741.     /**
  742.      * Tree instance this node is part of
  743.      * @property tree
  744.      * @type TreeView
  745.      */
  746.     tree: null,
  748.     /**
  749.      * The data linked to this node.  This can be any object or primitive
  750.      * value, and the data can be used in getNodeHtml().
  751.      * @property data
  752.      * @type object
  753.      */
  754.     data: null,
  756.     /**
  757.      * Parent node
  758.      * @property parent
  759.      * @type Node
  760.      */
  761.     parent: null,
  763.     /**
  764.      * The depth of this node.  We start at -1 for the root node.
  765.      * @property depth
  766.      * @type int
  767.      */
  768.     depth: -1,
  770.     /**
  771.      * The href for the node's label.  If one is not specified, the href will
  772.      * be set so that it toggles the node.
  773.      * @property href
  774.      * @type string
  775.      */
  776.     href: null,
  778.     /**
  779.      * The label href target, defaults to current window
  780.      * @property target
  781.      * @type string
  782.      */
  783.     target: "_self",
  785.     /**
  786.      * The node's expanded/collapsed state
  787.      * @property expanded
  788.      * @type boolean
  789.      */
  790.     expanded: false,
  792.     /**
  793.      * Can multiple children be expanded at once?
  794.      * @property multiExpand
  795.      * @type boolean
  796.      */
  797.     multiExpand: true,
  799.     /**
  800.      * Should we render children for a collapsed node?  It is possible that the
  801.      * implementer will want to render the hidden data...  @todo verify that we 
  802.      * need this, and implement it if we do.
  803.      * @property renderHidden
  804.      * @type boolean
  805.      */
  806.     renderHidden: false,
  808.     /**
  809.      * This flag is set to true when the html is generated for this node's
  810.      * children, and set to false when new children are added.
  811.      * @property childrenRendered
  812.      * @type boolean
  813.      */
  814.     childrenRendered: false,
  816.     /**
  817.      * Dynamically loaded nodes only fetch the data the first time they are
  818.      * expanded.  This flag is set to true once the data has been fetched.
  819.      * @property dynamicLoadComplete
  820.      * @type boolean
  821.      */
  822.     dynamicLoadComplete: false,
  824.     /**
  825.      * This node's previous sibling
  826.      * @property previousSibling
  827.      * @type Node
  828.      */
  829.     previousSibling: null,
  831.     /**
  832.      * This node's next sibling
  833.      * @property nextSibling
  834.      * @type Node
  835.      */
  836.     nextSibling: null,
  838.     /**
  839.      * We can set the node up to call an external method to get the child
  840.      * data dynamically.
  841.      * @property _dynLoad
  842.      * @type boolean
  843.      * @private
  844.      */
  845.     _dynLoad: false,
  847.     /**
  848.      * Function to execute when we need to get this node's child data.
  849.      * @property dataLoader
  850.      * @type function
  851.      */
  852.     dataLoader: null,
  854.     /**
  855.      * This is true for dynamically loading nodes while waiting for the
  856.      * callback to return.
  857.      * @property isLoading
  858.      * @type boolean
  859.      */
  860.     isLoading: false,
  862.     /**
  863.      * The toggle/branch icon will not show if this is set to false.  This
  864.      * could be useful if the implementer wants to have the child contain
  865.      * extra info about the parent, rather than an actual node.
  866.      * @property hasIcon
  867.      * @type boolean
  868.      */
  869.     hasIcon: true,
  871.     /**
  872.      * Used to configure what happens when a dynamic load node is expanded
  873.      * and we discover that it does not have children.  By default, it is
  874.      * treated as if it still could have children (plus/minus icon).  Set
  875.      * iconMode to have it display like a leaf node instead.
  876.      * @property iconMode
  877.      * @type int
  878.      */
  879.     iconMode: 0,
  881.     /**
  882.      * Specifies whether or not the content area of the node should be allowed
  883.      * to wrap.
  884.      * @property nowrap
  885.      * @type boolean
  886.      * @default false
  887.      */
  888.     nowrap: false,
  890.     /**
  891.      * The node type
  892.      * @property _type
  893.      * @private
  894.      */
  895.     _type: "Node",
  897.     /*
  898.     spacerPath: "http://us.i1.yimg.com/us.yimg.com/i/space.gif",
  899.     expandedText: "Expanded",
  900.     collapsedText: "Collapsed",
  901.     loadingText: "Loading",
  902.     */
  904.     /**
  905.      * Initializes this node, gets some of the properties from the parent
  906.      * @method init
  907.      * @param oData {object} a string or object containing the data that will
  908.      * be used to render this node
  909.      * @param oParent {Node} this node's parent node
  910.      * @param expanded {boolean} the initial expanded/collapsed state
  911.      */
  912.     init: function(oData, oParent, expanded) {
  914.         this.data       = oData;
  915.         this.children   = [];
  916.         this.index      = YAHOO.widget.TreeView.nodeCount;
  917.         ++YAHOO.widget.TreeView.nodeCount;
  918.         this.expanded   = expanded;
  920.         /**
  921.          * The parentChange event is fired when a parent element is applied
  922.          * to the node.  This is useful if you need to apply tree-level
  923.          * properties to a tree that need to happen if a node is moved from
  924.          * one tree to another.
  925.          *
  926.          * @event parentChange
  927.          * @type CustomEvent
  928.          */
  929.         this.createEvent("parentChange", this);
  931.         // oParent should never be null except when we create the root node.
  932.         if (oParent) {
  933.             oParent.appendChild(this);
  934.         }
  935.     },
  937.     /**
  938.      * Certain properties for the node cannot be set until the parent
  939.      * is known. This is called after the node is inserted into a tree.
  940.      * the parent is also applied to this node's children in order to
  941.      * make it possible to move a branch from one tree to another.
  942.      * @method applyParent
  943.      * @param {Node} parentNode this node's parent node
  944.      * @return {boolean} true if the application was successful
  945.      */
  946.     applyParent: function(parentNode) {
  947.         if (!parentNode) {
  948.             return false;
  949.         }
  951.         this.tree   = parentNode.tree;
  952.         this.parent = parentNode;
  953.         this.depth  = parentNode.depth + 1;
  955.         if (!this.href) {
  956.             this.href = "javascript:" + this.getToggleLink();
  957.         }
  959.         // @todo why was this put here.  This causes new nodes added at the
  960.         // root level to lose the menu behavior.
  961.         // if (! this.multiExpand) {
  962.             // this.multiExpand = parentNode.multiExpand;
  963.         // }
  965.         this.tree.regNode(this);
  966.         parentNode.childrenRendered = false;
  968.         // cascade update existing children
  969.         for (var i=0, len=this.children.length;i<len;++i) {
  970.             this.children[i].applyParent(this);
  971.         }
  973.         this.fireEvent("parentChange");
  975.         return true;
  976.     },
  978.     /**
  979.      * Appends a node to the child collection.
  980.      * @method appendChild
  981.      * @param childNode {Node} the new node
  982.      * @return {Node} the child node
  983.      * @private
  984.      */
  985.     appendChild: function(childNode) {
  986.         if (this.hasChildren()) {
  987.             var sib = this.children[this.children.length - 1];
  988.             sib.nextSibling = childNode;
  989.             childNode.previousSibling = sib;
  990.         }
  991.         this.children[this.children.length] = childNode;
  992.         childNode.applyParent(this);
  994.         // part of the IE display issue workaround. If child nodes
  995.         // are added after the initial render, and the node was
  996.         // instantiated with expanded = true, we need to show the
  997.         // children div now that the node has a child.
  998.         if (this.childrenRendered && this.expanded) {
  999.             this.getChildrenEl().style.display = "";
  1000.         }
  1002.         return childNode;
  1003.     },
  1005.     /**
  1006.      * Appends this node to the supplied node's child collection
  1007.      * @method appendTo
  1008.      * @param parentNode {Node} the node to append to.
  1009.      * @return {Node} The appended node
  1010.      */
  1011.     appendTo: function(parentNode) {
  1012.         return parentNode.appendChild(this);
  1013.     },
  1015.     /**
  1016.     * Inserts this node before this supplied node
  1017.     * @method insertBefore
  1018.     * @param node {Node} the node to insert this node before
  1019.     * @return {Node} the inserted node
  1020.     */
  1021.     insertBefore: function(node) {
  1022.         var p = node.parent;
  1023.         if (p) {
  1025.             if (this.tree) {
  1026.                 this.tree.popNode(this);
  1027.             }
  1029.             var refIndex = node.isChildOf(p);
  1030.             p.children.splice(refIndex, 0, this);
  1031.             if (node.previousSibling) {
  1032.                 node.previousSibling.nextSibling = this;
  1033.             }
  1034.             this.previousSibling = node.previousSibling;
  1035.             this.nextSibling = node;
  1036.             node.previousSibling = this;
  1038.             this.applyParent(p);
  1039.         }
  1041.         return this;
  1042.     },
  1043.  
  1044.     /**
  1045.     * Inserts this node after the supplied node
  1046.     * @method insertAfter
  1047.     * @param node {Node} the node to insert after
  1048.     * @return {Node} the inserted node
  1049.     */
  1050.     insertAfter: function(node) {
  1051.         var p = node.parent;
  1052.         if (p) {
  1054.             if (this.tree) {
  1055.                 this.tree.popNode(this);
  1056.             }
  1058.             var refIndex = node.isChildOf(p);
  1060.             if (!node.nextSibling) {
  1061.                 this.nextSibling = null;
  1062.                 return this.appendTo(p);
  1063.             }
  1065.             p.children.splice(refIndex + 1, 0, this);
  1067.             node.nextSibling.previousSibling = this;
  1068.             this.previousSibling = node;
  1069.             this.nextSibling = node.nextSibling;
  1070.             node.nextSibling = this;
  1072.             this.applyParent(p);
  1073.         }
  1075.         return this;
  1076.     },
  1078.     /**
  1079.     * Returns true if the Node is a child of supplied Node
  1080.     * @method isChildOf
  1081.     * @param parentNode {Node} the Node to check
  1082.     * @return {boolean} The node index if this Node is a child of 
  1083.     *                   supplied Node, else -1.
  1084.     * @private
  1085.     */
  1086.     isChildOf: function(parentNode) {
  1087.         if (parentNode && parentNode.children) {
  1088.             for (var i=0, len=parentNode.children.length; i<len ; ++i) {
  1089.                 if (parentNode.children[i] === this) {
  1090.                     return i;
  1091.                 }
  1092.             }
  1093.         }
  1095.         return -1;
  1096.     },
  1098.     /**
  1099.      * Returns a node array of this node's siblings, null if none.
  1100.      * @method getSiblings
  1101.      * @return Node[]
  1102.      */
  1103.     getSiblings: function() {
  1104.         return this.parent.children;
  1105.     },
  1107.     /**
  1108.      * Shows this node's children
  1109.      * @method showChildren
  1110.      */
  1111.     showChildren: function() {
  1112.         if (!this.tree.animateExpand(this.getChildrenEl(), this)) {
  1113.             if (this.hasChildren()) {
  1114.                 this.getChildrenEl().style.display = "";
  1115.             }
  1116.         }
  1117.     },
  1119.     /**
  1120.      * Hides this node's children
  1121.      * @method hideChildren
  1122.      */
  1123.     hideChildren: function() {
  1125.         if (!this.tree.animateCollapse(this.getChildrenEl(), this)) {
  1126.             this.getChildrenEl().style.display = "none";
  1127.         }
  1128.     },
  1130.     /**
  1131.      * Returns the id for this node's container div
  1132.      * @method getElId
  1133.      * @return {string} the element id
  1134.      */
  1135.     getElId: function() {
  1136.         return "ygtv" + this.index;
  1137.     },
  1139.     /**
  1140.      * Returns the id for this node's children div
  1141.      * @method getChildrenElId
  1142.      * @return {string} the element id for this node's children div
  1143.      */
  1144.     getChildrenElId: function() {
  1145.         return "ygtvc" + this.index;
  1146.     },
  1148.     /**
  1149.      * Returns the id for this node's toggle element
  1150.      * @method getToggleElId
  1151.      * @return {string} the toggel element id
  1152.      */
  1153.     getToggleElId: function() {
  1154.         return "ygtvt" + this.index;
  1155.     },
  1158.     /*
  1159.      * Returns the id for this node's spacer image.  The spacer is positioned
  1160.      * over the toggle and provides feedback for screen readers.
  1161.      * @method getSpacerId
  1162.      * @return {string} the id for the spacer image
  1163.      */
  1164.     /*
  1165.     getSpacerId: function() {
  1166.         return "ygtvspacer" + this.index;
  1167.     }, 
  1168.     */
  1170.     /**
  1171.      * Returns this node's container html element
  1172.      * @method getEl
  1173.      * @return {HTMLElement} the container html element
  1174.      */
  1175.     getEl: function() {
  1176.         return document.getElementById(this.getElId());
  1177.     },
  1179.     /**
  1180.      * Returns the div that was generated for this node's children
  1181.      * @method getChildrenEl
  1182.      * @return {HTMLElement} this node's children div
  1183.      */
  1184.     getChildrenEl: function() {
  1185.         return document.getElementById(this.getChildrenElId());
  1186.     },
  1188.     /**
  1189.      * Returns the element that is being used for this node's toggle.
  1190.      * @method getToggleEl
  1191.      * @return {HTMLElement} this node's toggle html element
  1192.      */
  1193.     getToggleEl: function() {
  1194.         return document.getElementById(this.getToggleElId());
  1195.     },
  1197.     /*
  1198.      * Returns the element that is being used for this node's spacer.
  1199.      * @method getSpacer
  1200.      * @return {HTMLElement} this node's spacer html element
  1201.      */
  1202.     /*
  1203.     getSpacer: function() {
  1204.         return document.getElementById( this.getSpacerId() ) || {};
  1205.     },
  1206.     */
  1208.     /*
  1209.     getStateText: function() {
  1210.         if (this.isLoading) {
  1211.             return this.loadingText;
  1212.         } else if (this.hasChildren(true)) {
  1213.             if (this.expanded) {
  1214.                 return this.expandedText;
  1215.             } else {
  1216.                 return this.collapsedText;
  1217.             }
  1218.         } else {
  1219.             return "";
  1220.         }
  1221.     },
  1222.     */
  1224.     /**
  1225.      * Generates the link that will invoke this node's toggle method
  1226.      * @method getToggleLink
  1227.      * @return {string} the javascript url for toggling this node
  1228.      */
  1229.     getToggleLink: function() {
  1230.         return "YAHOO.widget.TreeView.getNode('" + this.tree.id + "'," + 
  1231.             this.index + ").toggle()";
  1232.     },
  1234.     /**
  1235.      * Hides this nodes children (creating them if necessary), changes the
  1236.      * @method collapse
  1237.      * toggle style.
  1238.      */
  1239.     collapse: function() {
  1240.         // Only collapse if currently expanded
  1241.         if (!this.expanded) { return; }
  1243.         // fire the collapse event handler
  1244.         var ret = this.tree.onCollapse(this);
  1246.         if (false === ret) {
  1247.             return;
  1248.         }
  1250.         ret = this.tree.fireEvent("collapse", this);
  1252.         if (false === ret) {
  1253.             return;
  1254.         }
  1257.         if (!this.getEl()) {
  1258.             this.expanded = false;
  1259.         } else {
  1260.             // hide the child div
  1261.             this.hideChildren();
  1262.             this.expanded = false;
  1264.             this.updateIcon();
  1265.         }
  1267.         // this.getSpacer().title = this.getStateText();
  1269.         ret = this.tree.fireEvent("collapseComplete", this);
  1271.     },
  1273.     /**
  1274.      * Shows this nodes children (creating them if necessary), changes the
  1275.      * toggle style, and collapses its siblings if multiExpand is not set.
  1276.      * @method expand
  1277.      */
  1278.     expand: function() {
  1279.         // Only expand if currently collapsed.
  1280.         if (this.expanded) { return; }
  1282.         // fire the expand event handler
  1283.         var ret = this.tree.onExpand(this);
  1285.         if (false === ret) {
  1286.             return;
  1287.         }
  1288.         
  1289.         ret = this.tree.fireEvent("expand", this);
  1291.         if (false === ret) {
  1292.             return;
  1293.         }
  1295.         if (!this.getEl()) {
  1296.             this.expanded = true;
  1297.             return;
  1298.         }
  1300.         if (! this.childrenRendered) {
  1301.             this.getChildrenEl().innerHTML = this.renderChildren();
  1302.         } else {
  1303.         }
  1305.         this.expanded = true;
  1307.         this.updateIcon();
  1309.         // this.getSpacer().title = this.getStateText();
  1311.         // We do an extra check for children here because the lazy
  1312.         // load feature can expose nodes that have no children.
  1314.         // if (!this.hasChildren()) {
  1315.         if (this.isLoading) {
  1316.             this.expanded = false;
  1317.             return;
  1318.         }
  1320.         if (! this.multiExpand) {
  1321.             var sibs = this.getSiblings();
  1322.             for (var i=0; i<sibs.length; ++i) {
  1323.                 if (sibs[i] != this && sibs[i].expanded) { 
  1324.                     sibs[i].collapse(); 
  1325.                 }
  1326.             }
  1327.         }
  1329.         this.showChildren();
  1331.         ret = this.tree.fireEvent("expandComplete", this);
  1332.     },
  1334.     updateIcon: function() {
  1335.         if (this.hasIcon) {
  1336.             var el = this.getToggleEl();
  1337.             if (el) {
  1338.                 el.className = this.getStyle();
  1339.             }
  1340.         }
  1341.     },
  1343.     /**
  1344.      * Returns the css style name for the toggle
  1345.      * @method getStyle
  1346.      * @return {string} the css class for this node's toggle
  1347.      */
  1348.     getStyle: function() {
  1349.         if (this.isLoading) {
  1350.             return "ygtvloading";
  1351.         } else {
  1352.             // location top or bottom, middle nodes also get the top style
  1353.             var loc = (this.nextSibling) ? "t" : "l";
  1355.             // type p=plus(expand), m=minus(collapase), n=none(no children)
  1356.             var type = "n";
  1357.             if (this.hasChildren(true) || (this.isDynamic() && !this.getIconMode())) {
  1358.             // if (this.hasChildren(true)) {
  1359.                 type = (this.expanded) ? "m" : "p";
  1360.             }
  1362.             return "ygtv" + loc + type;
  1363.         }
  1364.     },
  1366.     /**
  1367.      * Returns the hover style for the icon
  1368.      * @return {string} the css class hover state
  1369.      * @method getHoverStyle
  1370.      */
  1371.     getHoverStyle: function() { 
  1372.         var s = this.getStyle();
  1373.         if (this.hasChildren(true) && !this.isLoading) { 
  1374.             s += "h"; 
  1375.         }
  1376.         return s;
  1377.     },
  1379.     /**
  1380.      * Recursively expands all of this node's children.
  1381.      * @method expandAll
  1382.      */
  1383.     expandAll: function() { 
  1384.         for (var i=0;i<this.children.length;++i) {
  1385.             var c = this.children[i];
  1386.             if (c.isDynamic()) {
  1387.                 alert("Not supported (lazy load + expand all)");
  1388.                 break;
  1389.             } else if (! c.multiExpand) {
  1390.                 alert("Not supported (no multi-expand + expand all)");
  1391.                 break;
  1392.             } else {
  1393.                 c.expand();
  1394.                 c.expandAll();
  1395.             }
  1396.         }
  1397.     },
  1399.     /**
  1400.      * Recursively collapses all of this node's children.
  1401.      * @method collapseAll
  1402.      */
  1403.     collapseAll: function() { 
  1404.         for (var i=0;i<this.children.length;++i) {
  1405.             this.children[i].collapse();
  1406.             this.children[i].collapseAll();
  1407.         }
  1408.     },
  1410.     /**
  1411.      * Configures this node for dynamically obtaining the child data
  1412.      * when the node is first expanded.  Calling it without the callback
  1413.      * will turn off dynamic load for the node.
  1414.      * @method setDynamicLoad
  1415.      * @param fmDataLoader {function} the function that will be used to get the data.
  1416.      * @param iconMode {int} configures the icon that is displayed when a dynamic
  1417.      * load node is expanded the first time without children.  By default, the 
  1418.      * "collapse" icon will be used.  If set to 1, the leaf node icon will be
  1419.      * displayed.
  1420.      */
  1421.     setDynamicLoad: function(fnDataLoader, iconMode) { 
  1422.         if (fnDataLoader) {
  1423.             this.dataLoader = fnDataLoader;
  1424.             this._dynLoad = true;
  1425.         } else {
  1426.             this.dataLoader = null;
  1427.             this._dynLoad = false;
  1428.         }
  1430.         if (iconMode) {
  1431.             this.iconMode = iconMode;
  1432.         }
  1433.     },
  1435.     /**
  1436.      * Evaluates if this node is the root node of the tree
  1437.      * @method isRoot
  1438.      * @return {boolean} true if this is the root node
  1439.      */
  1440.     isRoot: function() { 
  1441.         return (this == this.tree.root);
  1442.     },
  1444.     /**
  1445.      * Evaluates if this node's children should be loaded dynamically.  Looks for
  1446.      * the property both in this instance and the root node.  If the tree is
  1447.      * defined to load all children dynamically, the data callback function is
  1448.      * defined in the root node
  1449.      * @method isDynamic
  1450.      * @return {boolean} true if this node's children are to be loaded dynamically
  1451.      */
  1452.     isDynamic: function() { 
  1453.         var lazy = (!this.isRoot() && (this._dynLoad || this.tree.root._dynLoad));
  1454.         return lazy;
  1455.     },
  1457.     /**
  1458.      * Returns the current icon mode.  This refers to the way childless dynamic
  1459.      * load nodes appear.
  1460.      * @method getIconMode
  1461.      * @return {int} 0 for collapse style, 1 for leaf node style
  1462.      */
  1463.     getIconMode: function() {
  1464.         return (this.iconMode || this.tree.root.iconMode);
  1465.     },
  1467.     /**
  1468.      * Checks if this node has children.  If this node is lazy-loading and the
  1469.      * children have not been rendered, we do not know whether or not there
  1470.      * are actual children.  In most cases, we need to assume that there are
  1471.      * children (for instance, the toggle needs to show the expandable 
  1472.      * presentation state).  In other times we want to know if there are rendered
  1473.      * children.  For the latter, "checkForLazyLoad" should be false.
  1474.      * @method hasChildren
  1475.      * @param checkForLazyLoad {boolean} should we check for unloaded children?
  1476.      * @return {boolean} true if this has children or if it might and we are
  1477.      * checking for this condition.
  1478.      */
  1479.     hasChildren: function(checkForLazyLoad) { 
  1480.         return ( this.children.length > 0 || 
  1481.                 (checkForLazyLoad && this.isDynamic() && !this.dynamicLoadComplete) );
  1482.     },
  1484.     /**
  1485.      * Expands if node is collapsed, collapses otherwise.
  1486.      * @method toggle
  1487.      */
  1488.     toggle: function() {
  1489.         if (!this.tree.locked && ( this.hasChildren(true) || this.isDynamic()) ) {
  1490.             if (this.expanded) { this.collapse(); } else { this.expand(); }
  1491.         }
  1492.     },
  1494.     /**
  1495.      * Returns the markup for this node and its children.
  1496.      * @method getHtml
  1497.      * @return {string} the markup for this node and its expanded children.
  1498.      */
  1499.     getHtml: function() {
  1501.         this.childrenRendered = false;
  1503.         var sb = [];
  1504.         sb[sb.length] = '<div class="ygtvitem" id="' + this.getElId() + '">';
  1505.         sb[sb.length] = this.getNodeHtml();
  1506.         sb[sb.length] = this.getChildrenHtml();
  1507.         sb[sb.length] = '</div>';
  1508.         return sb.join("");
  1509.     },
  1511.     /**
  1512.      * Called when first rendering the tree.  We always build the div that will
  1513.      * contain this nodes children, but we don't render the children themselves
  1514.      * unless this node is expanded.
  1515.      * @method getChildrenHtml
  1516.      * @return {string} the children container div html and any expanded children
  1517.      * @private
  1518.      */
  1519.     getChildrenHtml: function() {
  1522.         var sb = [];
  1523.         sb[sb.length] = '<div class="ygtvchildren"';
  1524.         sb[sb.length] = ' id="' + this.getChildrenElId() + '"';
  1526.         // This is a workaround for an IE rendering issue, the child div has layout
  1527.         // in IE, creating extra space if a leaf node is created with the expanded
  1528.         // property set to true.
  1529.         if (!this.expanded || !this.hasChildren()) {
  1530.             sb[sb.length] = ' style="display:none;"';
  1531.         }
  1532.         sb[sb.length] = '>';
  1534.         // Don't render the actual child node HTML unless this node is expanded.
  1535.         if ( (this.hasChildren(true) && this.expanded) ||
  1536.                 (this.renderHidden && !this.isDynamic()) ) {
  1537.             sb[sb.length] = this.renderChildren();
  1538.         }
  1540.         sb[sb.length] = '</div>';
  1542.         return sb.join("");
  1543.     },
  1545.     /**
  1546.      * Generates the markup for the child nodes.  This is not done until the node
  1547.      * is expanded.
  1548.      * @method renderChildren
  1549.      * @return {string} the html for this node's children
  1550.      * @private
  1551.      */
  1552.     renderChildren: function() {
  1555.         var node = this;
  1557.         if (this.isDynamic() && !this.dynamicLoadComplete) {
  1558.             this.isLoading = true;
  1559.             this.tree.locked = true;
  1561.             if (this.dataLoader) {
  1563.                 setTimeout( 
  1564.                     function() {
  1565.                         node.dataLoader(node, 
  1566.                             function() { 
  1567.                                 node.loadComplete(); 
  1568.                             });
  1569.                     }, 10);
  1570.                 
  1571.             } else if (this.tree.root.dataLoader) {
  1573.                 setTimeout( 
  1574.                     function() {
  1575.                         node.tree.root.dataLoader(node, 
  1576.                             function() { 
  1577.                                 node.loadComplete(); 
  1578.                             });
  1579.                     }, 10);
  1581.             } else {
  1582.                 return "Error: data loader not found or not specified.";
  1583.             }
  1585.             return "";
  1587.         } else {
  1588.             return this.completeRender();
  1589.         }
  1590.     },
  1592.     /**
  1593.      * Called when we know we have all the child data.
  1594.      * @method completeRender
  1595.      * @return {string} children html
  1596.      */
  1597.     completeRender: function() {
  1598.         var sb = [];
  1600.         for (var i=0; i < this.children.length; ++i) {
  1601.             // this.children[i].childrenRendered = false;
  1602.             sb[sb.length] = this.children[i].getHtml();
  1603.         }
  1604.         
  1605.         this.childrenRendered = true;
  1607.         return sb.join("");
  1608.     },
  1610.     /**
  1611.      * Load complete is the callback function we pass to the data provider
  1612.      * in dynamic load situations.
  1613.      * @method loadComplete
  1614.      */
  1615.     loadComplete: function() {
  1616.         this.getChildrenEl().innerHTML = this.completeRender();
  1617.         this.dynamicLoadComplete = true;
  1618.         this.isLoading = false;
  1619.         this.expand();
  1620.         this.tree.locked = false;
  1621.     },
  1623.     /**
  1624.      * Returns this node's ancestor at the specified depth.
  1625.      * @method getAncestor
  1626.      * @param {int} depth the depth of the ancestor.
  1627.      * @return {Node} the ancestor
  1628.      */
  1629.     getAncestor: function(depth) {
  1630.         if (depth >= this.depth || depth < 0)  {
  1631.             return null;
  1632.         }
  1634.         var p = this.parent;
  1635.         
  1636.         while (p.depth > depth) {
  1637.             p = p.parent;
  1638.         }
  1640.         return p;
  1641.     },
  1643.     /**
  1644.      * Returns the css class for the spacer at the specified depth for
  1645.      * this node.  If this node's ancestor at the specified depth
  1646.      * has a next sibling the presentation is different than if it
  1647.      * does not have a next sibling
  1648.      * @method getDepthStyle
  1649.      * @param {int} depth the depth of the ancestor.
  1650.      * @return {string} the css class for the spacer
  1651.      */
  1652.     getDepthStyle: function(depth) {
  1653.         return (this.getAncestor(depth).nextSibling) ? 
  1654.             "ygtvdepthcell" : "ygtvblankdepthcell";
  1655.     },
  1657.     /**
  1658.      * Get the markup for the node.  This is designed to be overrided so that we can
  1659.      * support different types of nodes.
  1660.      * @method getNodeHtml
  1661.      * @return {string} The HTML that will render this node.
  1662.      */
  1663.     getNodeHtml: function() { 
  1664.         return ""; 
  1665.     },
  1667.     /**
  1668.      * Regenerates the html for this node and its children.  To be used when the
  1669.      * node is expanded and new children have been added.
  1670.      * @method refresh
  1671.      */
  1672.     refresh: function() {
  1673.         // this.loadComplete();
  1674.         this.getChildrenEl().innerHTML = this.completeRender();
  1676.         if (this.hasIcon) {
  1677.             var el = this.getToggleEl();
  1678.             if (el) {
  1679.                 el.className = this.getStyle();
  1680.             }
  1681.         }
  1682.     },
  1684.     /**
  1685.      * Node toString
  1686.      * @method toString
  1687.      * @return {string} string representation of the node
  1688.      */
  1689.     toString: function() {
  1690.         return "Node (" + this.index + ")";
  1691.     }
  1693. };
  1695. YAHOO.augment(YAHOO.widget.Node, YAHOO.util.EventProvider);
  1697. /**
  1698.  * The default node presentation.  The first parameter should be
  1699.  * either a string that will be used as the node's label, or an object
  1700.  * that has a string propery called label.  By default, the clicking the
  1701.  * label will toggle the expanded/collapsed state of the node.  By
  1702.  * changing the href property of the instance, this behavior can be
  1703.  * changed so that the label will go to the specified href.
  1704.  * @namespace YAHOO.widget
  1705.  * @class TextNode
  1706.  * @extends YAHOO.widget.Node
  1707.  * @constructor
  1708.  * @param oData {object} a string or object containing the data that will
  1709.  * be used to render this node
  1710.  * @param oParent {YAHOO.widget.Node} this node's parent node
  1711.  * @param expanded {boolean} the initial expanded/collapsed state
  1712.  */
  1713. YAHOO.widget.TextNode = function(oData, oParent, expanded) {
  1715.     if (oData) { 
  1716.         this.init(oData, oParent, expanded);
  1717.         this.setUpLabel(oData);
  1718.     }
  1720. };
  1722. YAHOO.extend(YAHOO.widget.TextNode, YAHOO.widget.Node, {
  1723.     
  1724.     /**
  1725.      * The CSS class for the label href.  Defaults to ygtvlabel, but can be
  1726.      * overridden to provide a custom presentation for a specific node.
  1727.      * @property labelStyle
  1728.      * @type string
  1729.      */
  1730.     labelStyle: "ygtvlabel",
  1732.     /**
  1733.      * The derived element id of the label for this node
  1734.      * @property labelElId
  1735.      * @type string
  1736.      */
  1737.     labelElId: null,
  1739.     /**
  1740.      * The text for the label.  It is assumed that the oData parameter will
  1741.      * either be a string that will be used as the label, or an object that
  1742.      * has a property called "label" that we will use.
  1743.      * @property label
  1744.      * @type string
  1745.      */
  1746.     label: null,
  1748.     textNodeParentChange: function() {
  1749.  
  1750.         /**
  1751.          * Custom event that is fired when the text node label is clicked.  The
  1752.          * custom event is defined on the tree instance, so there is a single
  1753.          * event that handles all nodes in the tree.  The node clicked is 
  1754.          * provided as an argument
  1755.          *
  1756.          * @event labelClick
  1757.          * @for YAHOO.widget.TreeView
  1758.          * @param {YAHOO.widget.Node} node the node clicked
  1759.          */
  1760.         if (this.tree && !this.tree.hasEvent("labelClick")) {
  1761.             this.tree.createEvent("labelClick", this.tree);
  1762.         }
  1763.        
  1764.     },
  1766.     /**
  1767.      * Sets up the node label
  1768.      * @method setUpLabel
  1769.      * @param oData string containing the label, or an object with a label property
  1770.      */
  1771.     setUpLabel: function(oData) { 
  1772.         
  1773.         // set up the custom event on the tree
  1774.         this.textNodeParentChange();
  1775.         this.subscribe("parentChange", this.textNodeParentChange);
  1777.         if (typeof oData == "string") {
  1778.             oData = { label: oData };
  1779.         }
  1780.         this.label = oData.label;
  1781.         this.data.label = oData.label;
  1782.         
  1783.         // update the link
  1784.         if (oData.href) {
  1785.             this.href = oData.href;
  1786.         }
  1788.         // set the target
  1789.         if (oData.target) {
  1790.             this.target = oData.target;
  1791.         }
  1793.         if (oData.style) {
  1794.             this.labelStyle = oData.style;
  1795.         }
  1797.         this.labelElId = "ygtvlabelel" + this.index;
  1798.     },
  1800.     /**
  1801.      * Returns the label element
  1802.      * @for YAHOO.widget.TextNode
  1803.      * @method getLabelEl
  1804.      * @return {object} the element
  1805.      */
  1806.     getLabelEl: function() { 
  1807.         return document.getElementById(this.labelElId);
  1808.     },
  1810.     // overrides YAHOO.widget.Node
  1811.     getNodeHtml: function() { 
  1812.         var sb = [];
  1814.         sb[sb.length] = '<table border="0" cellpadding="0" cellspacing="0">';
  1815.         sb[sb.length] = '<tr>';
  1816.         
  1817.         for (var i=0;i<this.depth;++i) {
  1818.             //sb[sb.length] = '<td><div class="' + this.getDepthStyle(i) + '">&#160;</div></td>';
  1819.             //sb[sb.length] = '<td><div class="' + this.getDepthStyle(i) + '"></div></td>';
  1820.             sb[sb.length] = '<td class="' + this.getDepthStyle(i) + '"><div class="ygtvspacer"></div></td>';
  1821.         }
  1823.         var getNode = 'YAHOO.widget.TreeView.getNode('' +
  1824.                         this.tree.id + '',' + this.index + ')';
  1826.         sb[sb.length] = '<td';
  1827.         // sb[sb.length] = ' onselectstart="return false"';
  1828.         sb[sb.length] = ' id="' + this.getToggleElId() + '"';
  1829.         sb[sb.length] = ' class="' + this.getStyle() + '"';
  1830.         if (this.hasChildren(true)) {
  1831.             sb[sb.length] = ' onmouseover="javascript:this.className=';
  1832.             sb[sb.length] = getNode + '.getHoverStyle()"';
  1833.             sb[sb.length] = ' onmouseout="javascript:this.className=';
  1834.             sb[sb.length] = getNode + '.getStyle()"';
  1835.         }
  1836.         sb[sb.length] = ' onclick="javascript:' + this.getToggleLink() + '">';
  1838.         sb[sb.length] = '<div class="ygtvspacer">';
  1840.         /*
  1841.         sb[sb.length] = '<img id="' + this.getSpacerId() + '"';
  1842.         sb[sb.length] = ' alt=""';
  1843.         sb[sb.length] = ' tabindex=0';
  1844.         sb[sb.length] = ' src="' + this.spacerPath + '"';
  1845.         sb[sb.length] = ' title="' + this.getStateText() + '"';
  1846.         sb[sb.length] = ' class="ygtvspacer"';
  1847.         // sb[sb.length] = ' onkeypress="return ' + getNode + '".onKeyPress()"';
  1848.         sb[sb.length] = ' />';
  1849.         */
  1851.         //sb[sb.length] = '&#160;';
  1853.         sb[sb.length] = '</div>';
  1854.         sb[sb.length] = '</td>';
  1855.         sb[sb.length] = '<td ';
  1856.         sb[sb.length] = (this.nowrap) ? ' nowrap="nowrap" ' : '';
  1857.         sb[sb.length] = ' >';
  1858.         sb[sb.length] = '<a';
  1859.         sb[sb.length] = ' id="' + this.labelElId + '"';
  1860.         sb[sb.length] = ' class="' + this.labelStyle + '"';
  1861.         sb[sb.length] = ' href="' + this.href + '"';
  1862.         sb[sb.length] = ' target="' + this.target + '"';
  1863.         sb[sb.length] = ' onclick="javascript:return ' + getNode + '.onLabelClick(' + getNode +')"';
  1864.         if (this.hasChildren(true)) {
  1865.             sb[sb.length] = ' onmouseover="javascript:document.getElementById('';
  1866.             sb[sb.length] = this.getToggleElId() + '').className=';
  1867.             sb[sb.length] = getNode + '.getHoverStyle()"';
  1868.             sb[sb.length] = ' onmouseout="javascript:document.getElementById('';
  1869.             sb[sb.length] = this.getToggleElId() + '').className=';
  1870.             sb[sb.length] = getNode + '.getStyle()"';
  1871.         }
  1872.         sb[sb.length] = ' >';
  1873.         sb[sb.length] = this.label;
  1874.         sb[sb.length] = '</a>';
  1875.         sb[sb.length] = '</td>';
  1876.         sb[sb.length] = '</tr>';
  1877.         sb[sb.length] = '</table>';
  1879.         return sb.join("");
  1880.     },
  1883.     /**
  1884.      * Executed when the label is clicked.  Fires the labelClick custom event.
  1885.      * @method onLabelClick
  1886.      * @param me {Node} this node
  1887.      * @scope the anchor tag clicked
  1888.      * @return false to cancel the anchor click
  1889.      */
  1890.     onLabelClick: function(me) { 
  1891.         return me.tree.fireEvent("labelClick", me);
  1892.         //return true;
  1893.     },
  1895.     toString: function() { 
  1896.         return "TextNode (" + this.index + ") " + this.label;
  1897.     }
  1899. });
  1900. /**
  1901.  * A custom YAHOO.widget.Node that handles the unique nature of 
  1902.  * the virtual, presentationless root node.
  1903.  * @namespace YAHOO.widget
  1904.  * @class RootNode
  1905.  * @extends YAHOO.widget.Node
  1906.  * @param oTree {YAHOO.widget.TreeView} The tree instance this node belongs to
  1907.  * @constructor
  1908.  */
  1909. YAHOO.widget.RootNode = function(oTree) {
  1910. // Initialize the node with null params.  The root node is a
  1911. // special case where the node has no presentation.  So we have
  1912. // to alter the standard properties a bit.
  1913. this.init(null, null, true);
  1915. /*
  1916.  * For the root node, we get the tree reference from as a param
  1917.  * to the constructor instead of from the parent element.
  1918.  */
  1919. this.tree = oTree;
  1920. };
  1922. YAHOO.extend(YAHOO.widget.RootNode, YAHOO.widget.Node, {
  1923.     
  1924.     // overrides YAHOO.widget.Node
  1925.     getNodeHtml: function() { 
  1926.         return ""; 
  1927.     },
  1929.     toString: function() { 
  1930.         return "RootNode";
  1931.     },
  1933.     loadComplete: function() { 
  1934.         this.tree.draw();
  1935.     },
  1937.     collapse: function() {},
  1938.     expand: function() {}
  1940. });
  1941. /**
  1942.  * This implementation takes either a string or object for the
  1943.  * oData argument.  If is it a string, we will use it for the display
  1944.  * of this node (and it can contain any html code).  If the parameter
  1945.  * is an object, we look for a parameter called "html" that will be
  1946.  * used for this node's display.
  1947.  * @namespace YAHOO.widget
  1948.  * @class HTMLNode
  1949.  * @extends YAHOO.widget.Node
  1950.  * @constructor
  1951.  * @param oData {object} a string or object containing the data that will
  1952.  * be used to render this node
  1953.  * @param oParent {YAHOO.widget.Node} this node's parent node
  1954.  * @param expanded {boolean} the initial expanded/collapsed state
  1955.  * @param hasIcon {boolean} specifies whether or not leaf nodes should
  1956.  * have an icon
  1957.  */
  1958. YAHOO.widget.HTMLNode = function(oData, oParent, expanded, hasIcon) {
  1959.     if (oData) { 
  1960.         this.init(oData, oParent, expanded);
  1961.         this.initContent(oData, hasIcon);
  1962.     }
  1963. };
  1965. YAHOO.extend(YAHOO.widget.HTMLNode, YAHOO.widget.Node, {
  1967.     /**
  1968.      * The CSS class for the html content container.  Defaults to ygtvhtml, but 
  1969.      * can be overridden to provide a custom presentation for a specific node.
  1970.      * @property contentStyle
  1971.      * @type string
  1972.      */
  1973.     contentStyle: "ygtvhtml",
  1975.     /**
  1976.      * The generated id that will contain the data passed in by the implementer.
  1977.      * @property contentElId
  1978.      * @type string
  1979.      */
  1980.     contentElId: null,
  1982.     /**
  1983.      * The HTML content to use for this node's display
  1984.      * @property content
  1985.      * @type string
  1986.      */
  1987.     content: null,
  1989.     /**
  1990.      * Sets up the node label
  1991.      * @property initContent
  1992.      * @param {object} An html string or object containing an html property
  1993.      * @param {boolean} hasIcon determines if the node will be rendered with an
  1994.      * icon or not
  1995.      */
  1996.     initContent: function(oData, hasIcon) { 
  1997.         if (typeof oData == "string") {
  1998.             oData = { html: oData };
  1999.         }
  2001.         this.html = oData.html;
  2002.         this.contentElId = "ygtvcontentel" + this.index;
  2003.         this.hasIcon = hasIcon;
  2005.     },
  2007.     /**
  2008.      * Returns the outer html element for this node's content
  2009.      * @method getContentEl
  2010.      * @return {HTMLElement} the element
  2011.      */
  2012.     getContentEl: function() { 
  2013.         return document.getElementById(this.contentElId);
  2014.     },
  2016.     // overrides YAHOO.widget.Node
  2017.     getNodeHtml: function() { 
  2018.         var sb = [];
  2020.         sb[sb.length] = '<table border="0" cellpadding="0" cellspacing="0">';
  2021.         sb[sb.length] = '<tr>';
  2022.         
  2023.         for (var i=0;i<this.depth;++i) {
  2024.             //sb[sb.length] = '<td class="' + this.getDepthStyle(i) + '">&#160;</td>';
  2025.             sb[sb.length] = '<td class="' + this.getDepthStyle(i) + '"><div class="ygtvspacer"></div></td>';
  2026.         }
  2028.         if (this.hasIcon) {
  2029.             sb[sb.length] = '<td';
  2030.             sb[sb.length] = ' id="' + this.getToggleElId() + '"';
  2031.             sb[sb.length] = ' class="' + this.getStyle() + '"';
  2032.             sb[sb.length] = ' onclick="javascript:' + this.getToggleLink() + '"';
  2033.             if (this.hasChildren(true)) {
  2034.                 sb[sb.length] = ' onmouseover="javascript:this.className=';
  2035.                 sb[sb.length] = 'YAHOO.widget.TreeView.getNode('';
  2036.                 sb[sb.length] = this.tree.id + '',' + this.index +  ').getHoverStyle()"';
  2037.                 sb[sb.length] = ' onmouseout="javascript:this.className=';
  2038.                 sb[sb.length] = 'YAHOO.widget.TreeView.getNode('';
  2039.                 sb[sb.length] = this.tree.id + '',' + this.index +  ').getStyle()"';
  2040.             }
  2041.             //sb[sb.length] = '>&#160;</td>';
  2042.             sb[sb.length] = '><div class="ygtvspacer"></div></td>';
  2043.         }
  2045.         sb[sb.length] = '<td';
  2046.         sb[sb.length] = ' id="' + this.contentElId + '"';
  2047.         sb[sb.length] = ' class="' + this.contentStyle + '"';
  2048.         sb[sb.length] = (this.nowrap) ? ' nowrap="nowrap" ' : '';
  2049.         sb[sb.length] = ' >';
  2050.         sb[sb.length] = this.html;
  2051.         sb[sb.length] = '</td>';
  2052.         sb[sb.length] = '</tr>';
  2053.         sb[sb.length] = '</table>';
  2055.         return sb.join("");
  2056.     },
  2058.     toString: function() { 
  2059.         return "HTMLNode (" + this.index + ")";
  2060.     }
  2062. });
  2063. /**
  2064.  * A menu-specific implementation that differs from TextNode in that only 
  2065.  * one sibling can be expanded at a time.
  2066.  * @namespace YAHOO.widget
  2067.  * @class MenuNode
  2068.  * @extends YAHOO.widget.TextNode
  2069.  * @param oData {object} a string or object containing the data that will
  2070.  * be used to render this node
  2071.  * @param oParent {YAHOO.widget.Node} this node's parent node
  2072.  * @param expanded {boolean} the initial expanded/collapsed state
  2073.  * @constructor
  2074.  */
  2075. YAHOO.widget.MenuNode = function(oData, oParent, expanded) {
  2076. if (oData) { 
  2077. this.init(oData, oParent, expanded);
  2078. this.setUpLabel(oData);
  2079. }
  2081.     /*
  2082.      * Menus usually allow only one branch to be open at a time.
  2083.      */
  2084. this.multiExpand = false;
  2087. };
  2089. YAHOO.extend(YAHOO.widget.MenuNode, YAHOO.widget.TextNode, {
  2091.     toString: function() { 
  2092.         return "MenuNode (" + this.index + ") " + this.label;
  2093.     }
  2095. });
  2096. /**
  2097.  * A static factory class for tree view expand/collapse animations
  2098.  * @class TVAnim
  2099.  * @static
  2100.  */
  2101. YAHOO.widget.TVAnim = function() {
  2102.     return {
  2103.         /**
  2104.          * Constant for the fade in animation
  2105.          * @property FADE_IN
  2106.          * @type string
  2107.          * @static
  2108.          */
  2109.         FADE_IN: "TVFadeIn",
  2111.         /**
  2112.          * Constant for the fade out animation
  2113.          * @property FADE_OUT
  2114.          * @type string
  2115.          * @static
  2116.          */
  2117.         FADE_OUT: "TVFadeOut",
  2119.         /**
  2120.          * Returns a ygAnim instance of the given type
  2121.          * @method getAnim
  2122.          * @param type {string} the type of animation
  2123.          * @param el {HTMLElement} the element to element (probably the children div)
  2124.          * @param callback {function} function to invoke when the animation is done.
  2125.          * @return {YAHOO.util.Animation} the animation instance
  2126.          * @static
  2127.          */
  2128.         getAnim: function(type, el, callback) {
  2129.             if (YAHOO.widget[type]) {
  2130.                 return new YAHOO.widget[type](el, callback);
  2131.             } else {
  2132.                 return null;
  2133.             }
  2134.         },
  2136.         /**
  2137.          * Returns true if the specified animation class is available
  2138.          * @method isValid
  2139.          * @param type {string} the type of animation
  2140.          * @return {boolean} true if valid, false if not
  2141.          * @static
  2142.          */
  2143.         isValid: function(type) {
  2144.             return (YAHOO.widget[type]);
  2145.         }
  2146.     };
  2147. } ();
  2149. /**
  2150.  * A 1/2 second fade-in animation.
  2151.  * @class TVFadeIn
  2152.  * @constructor
  2153.  * @param el {HTMLElement} the element to animate
  2154.  * @param callback {function} function to invoke when the animation is finished
  2155.  */
  2156. YAHOO.widget.TVFadeIn = function(el, callback) {
  2157.     /**
  2158.      * The element to animate
  2159.      * @property el
  2160.      * @type HTMLElement
  2161.      */
  2162.     this.el = el;
  2164.     /**
  2165.      * the callback to invoke when the animation is complete
  2166.      * @property callback
  2167.      * @type function
  2168.      */
  2169.     this.callback = callback;
  2171. };
  2173. YAHOO.widget.TVFadeIn.prototype = {
  2174.     /**
  2175.      * Performs the animation
  2176.      * @method animate
  2177.      */
  2178.     animate: function() {
  2179.         var tvanim = this;
  2181.         var s = this.el.style;
  2182.         s.opacity = 0.1;
  2183.         s.filter = "alpha(opacity=10)";
  2184.         s.display = "";
  2186.         var dur = 0.4; 
  2187.         var a = new YAHOO.util.Anim(this.el, {opacity: {from: 0.1, to: 1, unit:""}}, dur);
  2188.         a.onComplete.subscribe( function() { tvanim.onComplete(); } );
  2189.         a.animate();
  2190.     },
  2192.     /**
  2193.      * Clean up and invoke callback
  2194.      * @method onComplete
  2195.      */
  2196.     onComplete: function() {
  2197.         this.callback();
  2198.     },
  2200.     /**
  2201.      * toString
  2202.      * @method toString
  2203.      * @return {string} the string representation of the instance
  2204.      */
  2205.     toString: function() {
  2206.         return "TVFadeIn";
  2207.     }
  2208. };
  2210. /**
  2211.  * A 1/2 second fade out animation.
  2212.  * @class TVFadeOut
  2213.  * @constructor
  2214.  * @param el {HTMLElement} the element to animate
  2215.  * @param callback {Function} function to invoke when the animation is finished
  2216.  */
  2217. YAHOO.widget.TVFadeOut = function(el, callback) {
  2218.     /**
  2219.      * The element to animate
  2220.      * @property el
  2221.      * @type HTMLElement
  2222.      */
  2223.     this.el = el;
  2225.     /**
  2226.      * the callback to invoke when the animation is complete
  2227.      * @property callback
  2228.      * @type function
  2229.      */
  2230.     this.callback = callback;
  2232. };
  2234. YAHOO.widget.TVFadeOut.prototype = {
  2235.     /**
  2236.      * Performs the animation
  2237.      * @method animate
  2238.      */
  2239.     animate: function() {
  2240.         var tvanim = this;
  2241.         var dur = 0.4;
  2242.         var a = new YAHOO.util.Anim(this.el, {opacity: {from: 1, to: 0.1, unit:""}}, dur);
  2243.         a.onComplete.subscribe( function() { tvanim.onComplete(); } );
  2244.         a.animate();
  2245.     },
  2247.     /**
  2248.      * Clean up and invoke callback
  2249.      * @method onComplete
  2250.      */
  2251.     onComplete: function() {
  2252.         var s = this.el.style;
  2253.         s.display = "none";
  2254.         // s.opacity = 1;
  2255.         s.filter = "alpha(opacity=100)";
  2256.         this.callback();
  2257.     },
  2259.     /**
  2260.      * toString
  2261.      * @method toString
  2262.      * @return {string} the string representation of the instance
  2263.      */
  2264.     toString: function() {
  2265.         return "TVFadeOut";
  2266.     }
  2267. };
  2269. YAHOO.register("treeview", YAHOO.widget.TreeView, {version: "2.3.0", build: "442"});