3 * Copyright(c) 2006-2009 Ext JS, LLC
5 * http://www.extjs.com/license
8 * @class Ext.tree.DefaultSelectionModel
\r
9 * @extends Ext.util.Observable
\r
10 * The default single selection for a TreePanel.
\r
12 Ext.tree.DefaultSelectionModel = function(config){
\r
13 this.selNode = null;
\r
17 * @event selectionchange
\r
18 * Fires when the selected node changes
\r
19 * @param {DefaultSelectionModel} this
\r
20 * @param {TreeNode} node the new selection
\r
25 * @event beforeselect
\r
26 * Fires before the selected node changes, return false to cancel the change
\r
27 * @param {DefaultSelectionModel} this
\r
28 * @param {TreeNode} node the new selection
\r
29 * @param {TreeNode} node the old selection
\r
34 Ext.apply(this, config);
\r
35 Ext.tree.DefaultSelectionModel.superclass.constructor.call(this);
\r
38 Ext.extend(Ext.tree.DefaultSelectionModel, Ext.util.Observable, {
\r
39 init : function(tree){
\r
41 tree.mon(tree.getTreeEl(), 'keydown', this.onKeyDown, this);
\r
42 tree.on("click", this.onNodeClick, this);
\r
45 onNodeClick : function(node, e){
\r
51 * @param {TreeNode} node The node to select
\r
52 * @return {TreeNode} The selected node
\r
54 select : function(node, /* private*/ selectNextNode){
\r
55 // If node is hidden, select the next node in whatever direction was being moved in.
\r
56 if (!Ext.fly(node.ui.wrap).isVisible() && selectNextNode) {
\r
57 return selectNextNode.call(this, node);
\r
59 var last = this.selNode;
\r
61 node.ui.onSelectedChange(true);
\r
62 }else if(this.fireEvent('beforeselect', this, node, last) !== false){
\r
64 last.ui.onSelectedChange(false);
\r
66 this.selNode = node;
\r
67 node.ui.onSelectedChange(true);
\r
68 this.fireEvent("selectionchange", this, node, last);
\r
75 * @param {TreeNode} node The node to unselect
\r
77 unselect : function(node){
\r
78 if(this.selNode == node){
\r
79 this.clearSelections();
\r
84 * Clear all selections
\r
86 clearSelections : function(){
\r
87 var n = this.selNode;
\r
89 n.ui.onSelectedChange(false);
\r
90 this.selNode = null;
\r
91 this.fireEvent("selectionchange", this, null);
\r
97 * Get the selected node
\r
98 * @return {TreeNode} The selected node
\r
100 getSelectedNode : function(){
\r
101 return this.selNode;
\r
105 * Returns true if the node is selected
\r
106 * @param {TreeNode} node The node to check
\r
107 * @return {Boolean}
\r
109 isSelected : function(node){
\r
110 return this.selNode == node;
\r
114 * Selects the node above the selected node in the tree, intelligently walking the nodes
\r
115 * @return TreeNode The new selection
\r
117 selectPrevious : function(/* private */ s){
\r
118 if(!(s = s || this.selNode || this.lastSelNode)){
\r
121 // Here we pass in the current function to select to indicate the direction we're moving
\r
122 var ps = s.previousSibling;
\r
124 if(!ps.isExpanded() || ps.childNodes.length < 1){
\r
125 return this.select(ps, this.selectPrevious);
\r
127 var lc = ps.lastChild;
\r
128 while(lc && lc.isExpanded() && Ext.fly(lc.ui.wrap).isVisible() && lc.childNodes.length > 0){
\r
131 return this.select(lc, this.selectPrevious);
\r
133 } else if(s.parentNode && (this.tree.rootVisible || !s.parentNode.isRoot)){
\r
134 return this.select(s.parentNode, this.selectPrevious);
\r
140 * Selects the node above the selected node in the tree, intelligently walking the nodes
\r
141 * @return TreeNode The new selection
\r
143 selectNext : function(/* private */ s){
\r
144 if(!(s = s || this.selNode || this.lastSelNode)){
\r
147 // Here we pass in the current function to select to indicate the direction we're moving
\r
148 if(s.firstChild && s.isExpanded() && Ext.fly(s.ui.wrap).isVisible()){
\r
149 return this.select(s.firstChild, this.selectNext);
\r
150 }else if(s.nextSibling){
\r
151 return this.select(s.nextSibling, this.selectNext);
\r
152 }else if(s.parentNode){
\r
154 s.parentNode.bubble(function(){
\r
155 if(this.nextSibling){
\r
156 newS = this.getOwnerTree().selModel.select(this.nextSibling, this.selectNext);
\r
165 onKeyDown : function(e){
\r
166 var s = this.selNode || this.lastSelNode;
\r
167 // undesirable, but required
\r
172 var k = e.getKey();
\r
180 this.selectPrevious();
\r
183 e.preventDefault();
\r
184 if(s.hasChildNodes()){
\r
185 if(!s.isExpanded()){
\r
187 }else if(s.firstChild){
\r
188 this.select(s.firstChild, e);
\r
193 e.preventDefault();
\r
194 if(s.hasChildNodes() && s.isExpanded()){
\r
196 }else if(s.parentNode && (this.tree.rootVisible || s.parentNode != this.tree.getRootNode())){
\r
197 this.select(s.parentNode, e);
\r
205 * @class Ext.tree.MultiSelectionModel
\r
206 * @extends Ext.util.Observable
\r
207 * Multi selection for a TreePanel.
\r
209 Ext.tree.MultiSelectionModel = function(config){
\r
210 this.selNodes = [];
\r
214 * @event selectionchange
\r
215 * Fires when the selected nodes change
\r
216 * @param {MultiSelectionModel} this
\r
217 * @param {Array} nodes Array of the selected nodes
\r
221 Ext.apply(this, config);
\r
222 Ext.tree.MultiSelectionModel.superclass.constructor.call(this);
\r
225 Ext.extend(Ext.tree.MultiSelectionModel, Ext.util.Observable, {
\r
226 init : function(tree){
\r
228 tree.mon(tree.getTreeEl(), 'keydown', this.onKeyDown, this);
\r
229 tree.on("click", this.onNodeClick, this);
\r
232 onNodeClick : function(node, e){
\r
233 if(e.ctrlKey && this.isSelected(node)){
\r
234 this.unselect(node);
\r
236 this.select(node, e, e.ctrlKey);
\r
242 * @param {TreeNode} node The node to select
\r
243 * @param {EventObject} e (optional) An event associated with the selection
\r
244 * @param {Boolean} keepExisting True to retain existing selections
\r
245 * @return {TreeNode} The selected node
\r
247 select : function(node, e, keepExisting){
\r
248 if(keepExisting !== true){
\r
249 this.clearSelections(true);
\r
251 if(this.isSelected(node)){
\r
252 this.lastSelNode = node;
\r
255 this.selNodes.push(node);
\r
256 this.selMap[node.id] = node;
\r
257 this.lastSelNode = node;
\r
258 node.ui.onSelectedChange(true);
\r
259 this.fireEvent("selectionchange", this, this.selNodes);
\r
265 * @param {TreeNode} node The node to unselect
\r
267 unselect : function(node){
\r
268 if(this.selMap[node.id]){
\r
269 node.ui.onSelectedChange(false);
\r
270 var sn = this.selNodes;
\r
271 var index = sn.indexOf(node);
\r
273 this.selNodes.splice(index, 1);
\r
275 delete this.selMap[node.id];
\r
276 this.fireEvent("selectionchange", this, this.selNodes);
\r
281 * Clear all selections
\r
283 clearSelections : function(suppressEvent){
\r
284 var sn = this.selNodes;
\r
286 for(var i = 0, len = sn.length; i < len; i++){
\r
287 sn[i].ui.onSelectedChange(false);
\r
289 this.selNodes = [];
\r
291 if(suppressEvent !== true){
\r
292 this.fireEvent("selectionchange", this, this.selNodes);
\r
298 * Returns true if the node is selected
\r
299 * @param {TreeNode} node The node to check
\r
300 * @return {Boolean}
\r
302 isSelected : function(node){
\r
303 return this.selMap[node.id] ? true : false;
\r
307 * Returns an array of the selected nodes
\r
310 getSelectedNodes : function(){
\r
311 return this.selNodes;
\r
314 onKeyDown : Ext.tree.DefaultSelectionModel.prototype.onKeyDown,
\r
316 selectNext : Ext.tree.DefaultSelectionModel.prototype.selectNext,
\r
318 selectPrevious : Ext.tree.DefaultSelectionModel.prototype.selectPrevious
\r