Upgrade to ExtJS 4.0.1 - Released 05/18/2011
[extjs.git] / docs / source / Manager.html
1 <!DOCTYPE html>
2 <html>
3 <head>
4   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5   <title>The source code</title>
6   <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
7   <script type="text/javascript" src="../prettify/prettify.js"></script>
8   <style type="text/css">
9     .highlight { display: block; background-color: #ddd; }
10   </style>
11   <script type="text/javascript">
12     function highlight() {
13       document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
14     }
15   </script>
16 </head>
17 <body onload="prettyPrint(); highlight();">
18   <pre class="prettyprint lang-js"><span id='Ext-menu-Manager'>/**
19 </span> * @class Ext.menu.Manager
20  * Provides a common registry of all menus on a page.
21  * @singleton
22  */
23 Ext.define('Ext.menu.Manager', {
24     singleton: true,
25     requires: [
26         'Ext.util.MixedCollection',
27         'Ext.util.KeyMap'
28     ],
29     alternateClassName: 'Ext.menu.MenuMgr',
30
31     uses: ['Ext.menu.Menu'],
32
33     menus: {},
34     groups: {},
35     attached: false,
36     lastShow: new Date(),
37
38     init: function() {
39         var me = this;
40         
41         me.active = Ext.create('Ext.util.MixedCollection');
42         Ext.getDoc().addKeyListener(27, function() {
43             if (me.active.length &gt; 0) {
44                 me.hideAll();
45             }
46         }, me);
47     },
48
49 <span id='Ext-menu-Manager-method-hideAll'>    /**
50 </span>     * Hides all menus that are currently visible
51      * @return {Boolean} success True if any active menus were hidden.
52      */
53     hideAll: function() {
54         var active = this.active,
55             c;
56         if (active &amp;&amp; active.length &gt; 0) {
57             c = active.clone();
58             c.each(function(m) {
59                 m.hide();
60             });
61             return true;
62         }
63         return false;
64     },
65
66     onHide: function(m) {
67         var me = this,
68             active = me.active;
69         active.remove(m);
70         if (active.length &lt; 1) {
71             Ext.getDoc().un('mousedown', me.onMouseDown, me);
72             me.attached = false;
73         }
74     },
75
76     onShow: function(m) {
77         var me = this,
78             active   = me.active,
79             last     = active.last(),
80             attached = me.attached,
81             menuEl   = m.getEl(),
82             zIndex;
83
84         me.lastShow = new Date();
85         active.add(m);
86         if (!attached) {
87             Ext.getDoc().on('mousedown', me.onMouseDown, me);
88             me.attached = true;
89         }
90         m.toFront();
91     },
92
93     onBeforeHide: function(m) {
94         if (m.activeChild) {
95             m.activeChild.hide();
96         }
97         if (m.autoHideTimer) {
98             clearTimeout(m.autoHideTimer);
99             delete m.autoHideTimer;
100         }
101     },
102
103     onBeforeShow: function(m) {
104         var active = this.active,
105             parentMenu = m.parentMenu;
106             
107         active.remove(m);
108         if (!parentMenu &amp;&amp; !m.allowOtherMenus) {
109             this.hideAll();
110         }
111         else if (parentMenu &amp;&amp; parentMenu.activeChild &amp;&amp; m != parentMenu.activeChild) {
112             parentMenu.activeChild.hide();
113         }
114     },
115
116     // private
117     onMouseDown: function(e) {
118         var me = this,
119             active = me.active,
120             lastShow = me.lastShow;
121
122         if (Ext.Date.getElapsed(lastShow) &gt; 50 &amp;&amp; active.length &gt; 0 &amp;&amp; !e.getTarget('.' + Ext.baseCSSPrefix + 'menu')) {
123             me.hideAll();
124         }
125     },
126
127     // private
128     register: function(menu) {
129         var me = this;
130
131         if (!me.active) {
132             me.init();
133         }
134
135         if (menu.floating) {
136             me.menus[menu.id] = menu;
137             menu.on({
138                 beforehide: me.onBeforeHide,
139                 hide: me.onHide,
140                 beforeshow: me.onBeforeShow,
141                 show: me.onShow,
142                 scope: me
143             });
144         }
145     },
146
147 <span id='Ext-menu-Manager-method-get'>    /**
148 </span>     * Returns a {@link Ext.menu.Menu} object
149      * @param {String/Object} menu The string menu id, an existing menu object reference, or a Menu config that will
150      * be used to generate and return a new Menu this.
151      * @return {Ext.menu.Menu} The specified menu, or null if none are found
152      */
153     get: function(menu) {
154         var menus = this.menus;
155         
156         if (typeof menu == 'string') { // menu id
157             if (!menus) {  // not initialized, no menus to return
158                 return null;
159             }
160             return menus[menu];
161         } else if (menu.isMenu) {  // menu instance
162             return menu;
163         } else if (Ext.isArray(menu)) { // array of menu items
164             return Ext.create('Ext.menu.Menu', {items:menu});
165         } else { // otherwise, must be a config
166             return Ext.ComponentManager.create(menu, 'menu');
167         }
168     },
169
170     // private
171     unregister: function(menu) {
172         var me = this,
173             menus = me.menus,
174             active = me.active;
175
176         delete menus[menu.id];
177         active.remove(menu);
178         menu.un({
179             beforehide: me.onBeforeHide,
180             hide: me.onHide,
181             beforeshow: me.onBeforeShow,
182             show: me.onShow,
183             scope: me
184         });
185     },
186
187     // private
188     registerCheckable: function(menuItem) {
189         var groups  = this.groups,
190             groupId = menuItem.group;
191
192         if (groupId) {
193             if (!groups[groupId]) {
194                 groups[groupId] = [];
195             }
196
197             groups[groupId].push(menuItem);
198         }
199     },
200
201     // private
202     unregisterCheckable: function(menuItem) {
203         var groups  = this.groups,
204             groupId = menuItem.group;
205
206         if (groupId) {
207             Ext.Array.remove(groups[groupId], menuItem);
208         }
209     },
210
211     onCheckChange: function(menuItem, state) {
212         var groups  = this.groups,
213             groupId = menuItem.group,
214             i       = 0,
215             group, ln, curr;
216
217         if (groupId &amp;&amp; state) {
218             group = groups[groupId];
219             ln = group.length;
220             for (; i &lt; ln; i++) {
221                 curr = group[i];
222                 if (curr != menuItem) {
223                     curr.setChecked(false);
224                 }
225             }
226         }
227     }
228 });</pre>
229 </body>
230 </html>