Merge commit 'catalyst/MOODLE_19_STABLE' into mdl19-linuxchix
[moodle-linuxchix.git] / lib / yui / treeview / README
blobff281bd1a86a5129a25bd0e0a28449a17732ea99
1 TreeView - Release Notes
3 2.5.2
4   * Made CSS adjustments to work with base.css
6 2.5.1
7   * No change
9 2.5.0
10   * Added isLeaf property to Node that allows dynamically loaded trees to
11     have nodes that are not dynamically loaded (without configuring dynamic
12     load for each individual dynamic node, which was the requirement previously).  
13     If set to true, dynamic loading will be disabled for the node and it 
14     will always have the leaf node presentation (rather than the expand icon).
15   * Made CSS adjustments to work with base.css
16   * HTMLNode: removed unused property 'content', and documented the correct
17     property 'html'.
19 2.4.0
20   * added TreeView getNodeByElement, which will return a YAHOO.widget.Node 
21     reference for any ancestor HTML element of a node in the tree.
22   * Added 'title' property to TextNode
23   * Added treeview/tooltip example
24   * Passing a null or invalid animation type to setExpandAnim/setCollapseAnim
25     will turn off animation for the tree.
26   * Spacer style set to 12px width to fix layout inside overflow containers.
27   * Fixed removeAll() when executed on the root node.
28   * TextNode's href property is now escaped.
29   * The 'expanded' property in a node's constructor now works for dynamically
30     loaded nodes.
32 2.3.1
34   * The "expand" event no longer fires twice for dynamically loaded nodes.
36   * Added setHtml() to HTMLNode, which will synchronize the html and data
37     properties, as well as the content of the node if it has been rendered.
39 2.3.0
41   * The image preload feature was restored.
43   * Added the new skin
45   * Leaf nodes created with expanded=true have the child div hidden initially
46     to work around an IE rendering issue.
48 2.2.2
50   * No change
52 2.2.1
54   * Fixed the default value in the documentation for the nowrap property in Node
55     (the default value is false).
57 2.2.0
59   * Node::insertAfter properly nulls the nextSibling attribute when the
60     inserted before the firstChild.
62   * MenuNodes inserted at the root level will no longer lose the menu behavior.
64   * TextNode::setUpLabel sets the data.label property as well as the label property.
66   * TaskNode example: made the logger optional, and moved the creation of the logger
67     instance to the proper location.
69   * TaskNodes added to a node that is in a fully selected state will update the
70     parent to a partially selected state.
72   * TaskNode example fixed to propagate the labelClick event
75 0.12.2
77   * removeChildren will now work properly on the root node.
79 0.12.1
81   * Added custom events for expandComplete and collapseComplete.  These events are
82     needed in situations where the implementer needs to resize or reposition 
83     something based on the new offset.
85   * Added a "nowrap" property to Node, and set the default to false.  Specifies
86     whether or not the content area of the node should be allowed to wrap
87     naturally.
89   * Added additional HTML elements to preserve the tree presentation when constrained
90     by a parent element.
92 0.12.0
94   * TreeView now augments EventProvider, and has custom events for expand,
95     collapse, animStart, animComplete, and labelClick.  Existing implementations
96     using abstract methods for these events (if they exist) will still work.
97     New events can be plugged into the tree by the Node implementation.  For
98     example, TaskNode adds a checkClick event.  EventProvider makes it safe
99     to do this because implementing code can call subscribe() prior to the
100     event creation.
102   * YAHOO.util.Event is now a requirement for the widget
104   * TreeView::removeChildren no longer expands and collapses the node.
106   * Documented the moveComplete property
108   * createElement("DIV") changed to createElement("div")
110 0.11.4
112    * Fixed a javascript error on the HTML node example page.
114 0.11.3
116    * popNode now clears the tree, previousSibling, nextSibling, and parent
117      properties of the node that is being removed from the tree.
119    * Fixed the paths to the images in the tree.css file that is included in
120      build/assets.
122 0.11.0
124    * Added TreeView -> popNode, which differs from removeNode in that the
125      node's children are preserved so the entire branch can be re-inserted
126      into another part of the tree, or another tree.
128    * Added TreeView -> getNodesByProperty, which differs from 
129      getNodeByProperty by returning an array of all nodes that have the
130      specified property rather than just the first one.
132    * Added Node -> insertBefore, insertAfter, and appendTo.  These method
133      can be used to reorganize the tree.
135    * removeChildren properly resets the node icon when executed against a 
136      collpased node.
137      
138    * Moved depth assignment from the constructor to appendChild so that the
139      value is set properly if the node is moved within the tree.
141    * Fixed broken loop in removeChildren.
143    * RootNode -> loadComplete calls tree.draw for hot-wiring the dynamic load
144      feature for the top level nodes.
146    * The treeview constructor will accept an element instead of an id.
148 0.10.0
150    * If the child collection changes prior to a refresh(), the icon is now
151      changed appropriately.
153    * Added TreeView removeChildren(node).  This will recursively purge the node's
154      children, and reset its dynamic load state.  
156    * previousSibling and nextSibling are now adjusted correctly when a
157      node is deleted.
159    * expand()/collapse() now will not expand/collapse the node if false is
160      returned from the onExpand/onCollapse event handlers.
162    * The onExpand and onCollapse events now fire before the node is expanded
163      or collapsed so that the implementer can modify the node's child collection
164      prior to display.
166    * The childrenRendered property previous was used to indicate both that
167      a dynamically loaded node has received its data, and also to indicate
168      that the children html has been created.  This has been split into
169      two properties.  dynamicLoadComplete and childrenRendered.
171    * Implemented the renderHidden flag.  If set to true, the html for the entire
172      tree will be created when tree.draw() is called, not just the html for the
173      visible nodes.
175    * Added an onLabelClick listener to TextNode
177    * TreeView.removeNode no longer automatically refreshes the tree.  It has an
178      optional parameter to perform the refresh.
180    * removeNode can now be executed on nodes that have not been rendered.
182    * You can now delete top-level nodes.
184    * Added onCheckClick listener to the TaskNode example
186    * Added Node.iconMode, which is a property that configures the way 
187      dynamically loaded nodes are displayed when they are expanded and contain 
188      no children.
190    * TreeView/Node.setDynamicLoad now accepts an optional second parameter to 
191      set the iconMode property.
193    * Fixed an issue in the TaskNode.js example that prevented setting the checked
194      state of a node through the constructor.
196    * Fixed an issue in HTMLNode that caused rendering issues when hasIcon was 
197      set to true.
199    * Added TreeView.removeNode
201    * Added Node.refresh