[76] | 1 | /*! |
---|
| 2 | * Ext JS Library 3.4.0 |
---|
| 3 | * Copyright(c) 2006-2011 Sencha Inc. |
---|
| 4 | * licensing@sencha.com |
---|
| 5 | * http://www.sencha.com/license |
---|
| 6 | */ |
---|
| 7 | /** |
---|
| 8 | * @class Ext.EventManager |
---|
| 9 | * Registers event handlers that want to receive a normalized EventObject instead of the standard browser event and provides |
---|
| 10 | * several useful events directly. |
---|
| 11 | * See {@link Ext.EventObject} for more details on normalized event objects. |
---|
| 12 | * @singleton |
---|
| 13 | */ |
---|
| 14 | Ext.EventManager = function(){ |
---|
| 15 | var docReadyEvent, |
---|
| 16 | docReadyProcId, |
---|
| 17 | docReadyState = false, |
---|
| 18 | DETECT_NATIVE = Ext.isGecko || Ext.isWebKit || Ext.isSafari, |
---|
| 19 | E = Ext.lib.Event, |
---|
| 20 | D = Ext.lib.Dom, |
---|
| 21 | DOC = document, |
---|
| 22 | WINDOW = window, |
---|
| 23 | DOMCONTENTLOADED = "DOMContentLoaded", |
---|
| 24 | COMPLETE = 'complete', |
---|
| 25 | propRe = /^(?:scope|delay|buffer|single|stopEvent|preventDefault|stopPropagation|normalized|args|delegate)$/, |
---|
| 26 | /* |
---|
| 27 | * This cache is used to hold special js objects, the document and window, that don't have an id. We need to keep |
---|
| 28 | * a reference to them so we can look them up at a later point. |
---|
| 29 | */ |
---|
| 30 | specialElCache = []; |
---|
| 31 | |
---|
| 32 | function getId(el){ |
---|
| 33 | var id = false, |
---|
| 34 | i = 0, |
---|
| 35 | len = specialElCache.length, |
---|
| 36 | skip = false, |
---|
| 37 | o; |
---|
| 38 | |
---|
| 39 | if (el) { |
---|
| 40 | if (el.getElementById || el.navigator) { |
---|
| 41 | // look up the id |
---|
| 42 | for(; i < len; ++i){ |
---|
| 43 | o = specialElCache[i]; |
---|
| 44 | if(o.el === el){ |
---|
| 45 | id = o.id; |
---|
| 46 | break; |
---|
| 47 | } |
---|
| 48 | } |
---|
| 49 | if(!id){ |
---|
| 50 | // for browsers that support it, ensure that give the el the same id |
---|
| 51 | id = Ext.id(el); |
---|
| 52 | specialElCache.push({ |
---|
| 53 | id: id, |
---|
| 54 | el: el |
---|
| 55 | }); |
---|
| 56 | skip = true; |
---|
| 57 | } |
---|
| 58 | }else{ |
---|
| 59 | id = Ext.id(el); |
---|
| 60 | } |
---|
| 61 | if(!Ext.elCache[id]){ |
---|
| 62 | Ext.Element.addToCache(new Ext.Element(el), id); |
---|
| 63 | if(skip){ |
---|
| 64 | Ext.elCache[id].skipGC = true; |
---|
| 65 | } |
---|
| 66 | } |
---|
| 67 | } |
---|
| 68 | return id; |
---|
| 69 | } |
---|
| 70 | |
---|
| 71 | /// There is some jquery work around stuff here that isn't needed in Ext Core. |
---|
| 72 | function addListener(el, ename, fn, task, wrap, scope){ |
---|
| 73 | el = Ext.getDom(el); |
---|
| 74 | var id = getId(el), |
---|
| 75 | es = Ext.elCache[id].events, |
---|
| 76 | wfn; |
---|
| 77 | |
---|
| 78 | wfn = E.on(el, ename, wrap); |
---|
| 79 | es[ename] = es[ename] || []; |
---|
| 80 | |
---|
| 81 | /* 0 = Original Function, |
---|
| 82 | 1 = Event Manager Wrapped Function, |
---|
| 83 | 2 = Scope, |
---|
| 84 | 3 = Adapter Wrapped Function, |
---|
| 85 | 4 = Buffered Task |
---|
| 86 | */ |
---|
| 87 | es[ename].push([fn, wrap, scope, wfn, task]); |
---|
| 88 | |
---|
| 89 | // this is a workaround for jQuery and should somehow be removed from Ext Core in the future |
---|
| 90 | // without breaking ExtJS. |
---|
| 91 | |
---|
| 92 | // workaround for jQuery |
---|
| 93 | if(el.addEventListener && ename == "mousewheel"){ |
---|
| 94 | var args = ["DOMMouseScroll", wrap, false]; |
---|
| 95 | el.addEventListener.apply(el, args); |
---|
| 96 | Ext.EventManager.addListener(WINDOW, 'unload', function(){ |
---|
| 97 | el.removeEventListener.apply(el, args); |
---|
| 98 | }); |
---|
| 99 | } |
---|
| 100 | |
---|
| 101 | // fix stopped mousedowns on the document |
---|
| 102 | if(el == DOC && ename == "mousedown"){ |
---|
| 103 | Ext.EventManager.stoppedMouseDownEvent.addListener(wrap); |
---|
| 104 | } |
---|
| 105 | } |
---|
| 106 | |
---|
| 107 | function doScrollChk(){ |
---|
| 108 | /* Notes: |
---|
| 109 | 'doScroll' will NOT work in a IFRAME/FRAMESET. |
---|
| 110 | The method succeeds but, a DOM query done immediately after -- FAILS. |
---|
| 111 | */ |
---|
| 112 | if(window != top){ |
---|
| 113 | return false; |
---|
| 114 | } |
---|
| 115 | |
---|
| 116 | try{ |
---|
| 117 | DOC.documentElement.doScroll('left'); |
---|
| 118 | }catch(e){ |
---|
| 119 | return false; |
---|
| 120 | } |
---|
| 121 | |
---|
| 122 | fireDocReady(); |
---|
| 123 | return true; |
---|
| 124 | } |
---|
| 125 | /** |
---|
| 126 | * @return {Boolean} True if the document is in a 'complete' state (or was determined to |
---|
| 127 | * be true by other means). If false, the state is evaluated again until canceled. |
---|
| 128 | */ |
---|
| 129 | function checkReadyState(e){ |
---|
| 130 | |
---|
| 131 | if(Ext.isIE && doScrollChk()){ |
---|
| 132 | return true; |
---|
| 133 | } |
---|
| 134 | if(DOC.readyState == COMPLETE){ |
---|
| 135 | fireDocReady(); |
---|
| 136 | return true; |
---|
| 137 | } |
---|
| 138 | docReadyState || (docReadyProcId = setTimeout(arguments.callee, 2)); |
---|
| 139 | return false; |
---|
| 140 | } |
---|
| 141 | |
---|
| 142 | var styles; |
---|
| 143 | function checkStyleSheets(e){ |
---|
| 144 | styles || (styles = Ext.query('style, link[rel=stylesheet]')); |
---|
| 145 | if(styles.length == DOC.styleSheets.length){ |
---|
| 146 | fireDocReady(); |
---|
| 147 | return true; |
---|
| 148 | } |
---|
| 149 | docReadyState || (docReadyProcId = setTimeout(arguments.callee, 2)); |
---|
| 150 | return false; |
---|
| 151 | } |
---|
| 152 | |
---|
| 153 | function OperaDOMContentLoaded(e){ |
---|
| 154 | DOC.removeEventListener(DOMCONTENTLOADED, arguments.callee, false); |
---|
| 155 | checkStyleSheets(); |
---|
| 156 | } |
---|
| 157 | |
---|
| 158 | function fireDocReady(e){ |
---|
| 159 | if(!docReadyState){ |
---|
| 160 | docReadyState = true; //only attempt listener removal once |
---|
| 161 | |
---|
| 162 | if(docReadyProcId){ |
---|
| 163 | clearTimeout(docReadyProcId); |
---|
| 164 | } |
---|
| 165 | if(DETECT_NATIVE) { |
---|
| 166 | DOC.removeEventListener(DOMCONTENTLOADED, fireDocReady, false); |
---|
| 167 | } |
---|
| 168 | if(Ext.isIE && checkReadyState.bindIE){ //was this was actually set ?? |
---|
| 169 | DOC.detachEvent('onreadystatechange', checkReadyState); |
---|
| 170 | } |
---|
| 171 | E.un(WINDOW, "load", arguments.callee); |
---|
| 172 | } |
---|
| 173 | if(docReadyEvent && !Ext.isReady){ |
---|
| 174 | Ext.isReady = true; |
---|
| 175 | docReadyEvent.fire(); |
---|
| 176 | docReadyEvent.listeners = []; |
---|
| 177 | } |
---|
| 178 | |
---|
| 179 | } |
---|
| 180 | |
---|
| 181 | function initDocReady(){ |
---|
| 182 | docReadyEvent || (docReadyEvent = new Ext.util.Event()); |
---|
| 183 | if (DETECT_NATIVE) { |
---|
| 184 | DOC.addEventListener(DOMCONTENTLOADED, fireDocReady, false); |
---|
| 185 | } |
---|
| 186 | /* |
---|
| 187 | * Handle additional (exceptional) detection strategies here |
---|
| 188 | */ |
---|
| 189 | if (Ext.isIE){ |
---|
| 190 | //Use readystatechange as a backup AND primary detection mechanism for a FRAME/IFRAME |
---|
| 191 | //See if page is already loaded |
---|
| 192 | if(!checkReadyState()){ |
---|
| 193 | checkReadyState.bindIE = true; |
---|
| 194 | DOC.attachEvent('onreadystatechange', checkReadyState); |
---|
| 195 | } |
---|
| 196 | |
---|
| 197 | }else if(Ext.isOpera ){ |
---|
| 198 | /* Notes: |
---|
| 199 | Opera needs special treatment needed here because CSS rules are NOT QUITE |
---|
| 200 | available after DOMContentLoaded is raised. |
---|
| 201 | */ |
---|
| 202 | |
---|
| 203 | //See if page is already loaded and all styleSheets are in place |
---|
| 204 | (DOC.readyState == COMPLETE && checkStyleSheets()) || |
---|
| 205 | DOC.addEventListener(DOMCONTENTLOADED, OperaDOMContentLoaded, false); |
---|
| 206 | |
---|
| 207 | }else if (Ext.isWebKit){ |
---|
| 208 | //Fallback for older Webkits without DOMCONTENTLOADED support |
---|
| 209 | checkReadyState(); |
---|
| 210 | } |
---|
| 211 | // no matter what, make sure it fires on load |
---|
| 212 | E.on(WINDOW, "load", fireDocReady); |
---|
| 213 | } |
---|
| 214 | |
---|
| 215 | function createTargeted(h, o){ |
---|
| 216 | return function(){ |
---|
| 217 | var args = Ext.toArray(arguments); |
---|
| 218 | if(o.target == Ext.EventObject.setEvent(args[0]).target){ |
---|
| 219 | h.apply(this, args); |
---|
| 220 | } |
---|
| 221 | }; |
---|
| 222 | } |
---|
| 223 | |
---|
| 224 | function createBuffered(h, o, task){ |
---|
| 225 | return function(e){ |
---|
| 226 | // create new event object impl so new events don't wipe out properties |
---|
| 227 | task.delay(o.buffer, h, null, [new Ext.EventObjectImpl(e)]); |
---|
| 228 | }; |
---|
| 229 | } |
---|
| 230 | |
---|
| 231 | function createSingle(h, el, ename, fn, scope){ |
---|
| 232 | return function(e){ |
---|
| 233 | Ext.EventManager.removeListener(el, ename, fn, scope); |
---|
| 234 | h(e); |
---|
| 235 | }; |
---|
| 236 | } |
---|
| 237 | |
---|
| 238 | function createDelayed(h, o, fn){ |
---|
| 239 | return function(e){ |
---|
| 240 | var task = new Ext.util.DelayedTask(h); |
---|
| 241 | if(!fn.tasks) { |
---|
| 242 | fn.tasks = []; |
---|
| 243 | } |
---|
| 244 | fn.tasks.push(task); |
---|
| 245 | task.delay(o.delay || 10, h, null, [new Ext.EventObjectImpl(e)]); |
---|
| 246 | }; |
---|
| 247 | } |
---|
| 248 | |
---|
| 249 | function listen(element, ename, opt, fn, scope){ |
---|
| 250 | var o = (!opt || typeof opt == "boolean") ? {} : opt, |
---|
| 251 | el = Ext.getDom(element), task; |
---|
| 252 | |
---|
| 253 | fn = fn || o.fn; |
---|
| 254 | scope = scope || o.scope; |
---|
| 255 | |
---|
| 256 | if(!el){ |
---|
| 257 | throw "Error listening for \"" + ename + '\". Element "' + element + '" doesn\'t exist.'; |
---|
| 258 | } |
---|
| 259 | function h(e){ |
---|
| 260 | // prevent errors while unload occurring |
---|
| 261 | if(!Ext){// !window[xname]){ ==> can't we do this? |
---|
| 262 | return; |
---|
| 263 | } |
---|
| 264 | e = Ext.EventObject.setEvent(e); |
---|
| 265 | var t; |
---|
| 266 | if (o.delegate) { |
---|
| 267 | if(!(t = e.getTarget(o.delegate, el))){ |
---|
| 268 | return; |
---|
| 269 | } |
---|
| 270 | } else { |
---|
| 271 | t = e.target; |
---|
| 272 | } |
---|
| 273 | if (o.stopEvent) { |
---|
| 274 | e.stopEvent(); |
---|
| 275 | } |
---|
| 276 | if (o.preventDefault) { |
---|
| 277 | e.preventDefault(); |
---|
| 278 | } |
---|
| 279 | if (o.stopPropagation) { |
---|
| 280 | e.stopPropagation(); |
---|
| 281 | } |
---|
| 282 | if (o.normalized === false) { |
---|
| 283 | e = e.browserEvent; |
---|
| 284 | } |
---|
| 285 | |
---|
| 286 | fn.call(scope || el, e, t, o); |
---|
| 287 | } |
---|
| 288 | if(o.target){ |
---|
| 289 | h = createTargeted(h, o); |
---|
| 290 | } |
---|
| 291 | if(o.delay){ |
---|
| 292 | h = createDelayed(h, o, fn); |
---|
| 293 | } |
---|
| 294 | if(o.single){ |
---|
| 295 | h = createSingle(h, el, ename, fn, scope); |
---|
| 296 | } |
---|
| 297 | if(o.buffer){ |
---|
| 298 | task = new Ext.util.DelayedTask(h); |
---|
| 299 | h = createBuffered(h, o, task); |
---|
| 300 | } |
---|
| 301 | |
---|
| 302 | addListener(el, ename, fn, task, h, scope); |
---|
| 303 | return h; |
---|
| 304 | } |
---|
| 305 | |
---|
| 306 | var pub = { |
---|
| 307 | /** |
---|
| 308 | * Appends an event handler to an element. The shorthand version {@link #on} is equivalent. Typically you will |
---|
| 309 | * use {@link Ext.Element#addListener} directly on an Element in favor of calling this version. |
---|
| 310 | * @param {String/HTMLElement} el The html element or id to assign the event handler to. |
---|
| 311 | * @param {String} eventName The name of the event to listen for. |
---|
| 312 | * @param {Function} handler The handler function the event invokes. This function is passed |
---|
| 313 | * the following parameters:<ul> |
---|
| 314 | * <li>evt : EventObject<div class="sub-desc">The {@link Ext.EventObject EventObject} describing the event.</div></li> |
---|
| 315 | * <li>t : Element<div class="sub-desc">The {@link Ext.Element Element} which was the target of the event. |
---|
| 316 | * Note that this may be filtered by using the <tt>delegate</tt> option.</div></li> |
---|
| 317 | * <li>o : Object<div class="sub-desc">The options object from the addListener call.</div></li> |
---|
| 318 | * </ul> |
---|
| 319 | * @param {Object} scope (optional) The scope (<b><code>this</code></b> reference) in which the handler function is executed. <b>Defaults to the Element</b>. |
---|
| 320 | * @param {Object} options (optional) An object containing handler configuration properties. |
---|
| 321 | * This may contain any of the following properties:<ul> |
---|
| 322 | * <li>scope : Object<div class="sub-desc">The scope (<b><code>this</code></b> reference) in which the handler function is executed. <b>Defaults to the Element</b>.</div></li> |
---|
| 323 | * <li>delegate : String<div class="sub-desc">A simple selector to filter the target or look for a descendant of the target</div></li> |
---|
| 324 | * <li>stopEvent : Boolean<div class="sub-desc">True to stop the event. That is stop propagation, and prevent the default action.</div></li> |
---|
| 325 | * <li>preventDefault : Boolean<div class="sub-desc">True to prevent the default action</div></li> |
---|
| 326 | * <li>stopPropagation : Boolean<div class="sub-desc">True to prevent event propagation</div></li> |
---|
| 327 | * <li>normalized : Boolean<div class="sub-desc">False to pass a browser event to the handler function instead of an Ext.EventObject</div></li> |
---|
| 328 | * <li>delay : Number<div class="sub-desc">The number of milliseconds to delay the invocation of the handler after te event fires.</div></li> |
---|
| 329 | * <li>single : Boolean<div class="sub-desc">True to add a handler to handle just the next firing of the event, and then remove itself.</div></li> |
---|
| 330 | * <li>buffer : Number<div class="sub-desc">Causes the handler to be scheduled to run in an {@link Ext.util.DelayedTask} delayed |
---|
| 331 | * by the specified number of milliseconds. If the event fires again within that time, the original |
---|
| 332 | * handler is <em>not</em> invoked, but the new handler is scheduled in its place.</div></li> |
---|
| 333 | * <li>target : Element<div class="sub-desc">Only call the handler if the event was fired on the target Element, <i>not</i> if the event was bubbled up from a child node.</div></li> |
---|
| 334 | * </ul><br> |
---|
| 335 | * <p>See {@link Ext.Element#addListener} for examples of how to use these options.</p> |
---|
| 336 | */ |
---|
| 337 | addListener : function(element, eventName, fn, scope, options){ |
---|
| 338 | if(typeof eventName == 'object'){ |
---|
| 339 | var o = eventName, e, val; |
---|
| 340 | for(e in o){ |
---|
| 341 | val = o[e]; |
---|
| 342 | if(!propRe.test(e)){ |
---|
| 343 | if(Ext.isFunction(val)){ |
---|
| 344 | // shared options |
---|
| 345 | listen(element, e, o, val, o.scope); |
---|
| 346 | }else{ |
---|
| 347 | // individual options |
---|
| 348 | listen(element, e, val); |
---|
| 349 | } |
---|
| 350 | } |
---|
| 351 | } |
---|
| 352 | } else { |
---|
| 353 | listen(element, eventName, options, fn, scope); |
---|
| 354 | } |
---|
| 355 | }, |
---|
| 356 | |
---|
| 357 | /** |
---|
| 358 | * Removes an event handler from an element. The shorthand version {@link #un} is equivalent. Typically |
---|
| 359 | * you will use {@link Ext.Element#removeListener} directly on an Element in favor of calling this version. |
---|
| 360 | * @param {String/HTMLElement} el The id or html element from which to remove the listener. |
---|
| 361 | * @param {String} eventName The name of the event. |
---|
| 362 | * @param {Function} fn The handler function to remove. <b>This must be a reference to the function passed into the {@link #addListener} call.</b> |
---|
| 363 | * @param {Object} scope If a scope (<b><code>this</code></b> reference) was specified when the listener was added, |
---|
| 364 | * then this must refer to the same object. |
---|
| 365 | */ |
---|
| 366 | removeListener : function(el, eventName, fn, scope){ |
---|
| 367 | el = Ext.getDom(el); |
---|
| 368 | var id = getId(el), |
---|
| 369 | f = el && (Ext.elCache[id].events)[eventName] || [], |
---|
| 370 | wrap, i, l, k, len, fnc; |
---|
| 371 | |
---|
| 372 | for (i = 0, len = f.length; i < len; i++) { |
---|
| 373 | |
---|
| 374 | /* 0 = Original Function, |
---|
| 375 | 1 = Event Manager Wrapped Function, |
---|
| 376 | 2 = Scope, |
---|
| 377 | 3 = Adapter Wrapped Function, |
---|
| 378 | 4 = Buffered Task |
---|
| 379 | */ |
---|
| 380 | if (Ext.isArray(fnc = f[i]) && fnc[0] == fn && (!scope || fnc[2] == scope)) { |
---|
| 381 | if(fnc[4]) { |
---|
| 382 | fnc[4].cancel(); |
---|
| 383 | } |
---|
| 384 | k = fn.tasks && fn.tasks.length; |
---|
| 385 | if(k) { |
---|
| 386 | while(k--) { |
---|
| 387 | fn.tasks[k].cancel(); |
---|
| 388 | } |
---|
| 389 | delete fn.tasks; |
---|
| 390 | } |
---|
| 391 | wrap = fnc[1]; |
---|
| 392 | E.un(el, eventName, E.extAdapter ? fnc[3] : wrap); |
---|
| 393 | |
---|
| 394 | // jQuery workaround that should be removed from Ext Core |
---|
| 395 | if(wrap && el.addEventListener && eventName == "mousewheel"){ |
---|
| 396 | el.removeEventListener("DOMMouseScroll", wrap, false); |
---|
| 397 | } |
---|
| 398 | |
---|
| 399 | // fix stopped mousedowns on the document |
---|
| 400 | if(wrap && el == DOC && eventName == "mousedown"){ |
---|
| 401 | Ext.EventManager.stoppedMouseDownEvent.removeListener(wrap); |
---|
| 402 | } |
---|
| 403 | |
---|
| 404 | f.splice(i, 1); |
---|
| 405 | if (f.length === 0) { |
---|
| 406 | delete Ext.elCache[id].events[eventName]; |
---|
| 407 | } |
---|
| 408 | for (k in Ext.elCache[id].events) { |
---|
| 409 | return false; |
---|
| 410 | } |
---|
| 411 | Ext.elCache[id].events = {}; |
---|
| 412 | return false; |
---|
| 413 | } |
---|
| 414 | } |
---|
| 415 | }, |
---|
| 416 | |
---|
| 417 | /** |
---|
| 418 | * Removes all event handers from an element. Typically you will use {@link Ext.Element#removeAllListeners} |
---|
| 419 | * directly on an Element in favor of calling this version. |
---|
| 420 | * @param {String/HTMLElement} el The id or html element from which to remove all event handlers. |
---|
| 421 | */ |
---|
| 422 | removeAll : function(el){ |
---|
| 423 | el = Ext.getDom(el); |
---|
| 424 | var id = getId(el), |
---|
| 425 | ec = Ext.elCache[id] || {}, |
---|
| 426 | es = ec.events || {}, |
---|
| 427 | f, i, len, ename, fn, k, wrap; |
---|
| 428 | |
---|
| 429 | for(ename in es){ |
---|
| 430 | if(es.hasOwnProperty(ename)){ |
---|
| 431 | f = es[ename]; |
---|
| 432 | /* 0 = Original Function, |
---|
| 433 | 1 = Event Manager Wrapped Function, |
---|
| 434 | 2 = Scope, |
---|
| 435 | 3 = Adapter Wrapped Function, |
---|
| 436 | 4 = Buffered Task |
---|
| 437 | */ |
---|
| 438 | for (i = 0, len = f.length; i < len; i++) { |
---|
| 439 | fn = f[i]; |
---|
| 440 | if(fn[4]) { |
---|
| 441 | fn[4].cancel(); |
---|
| 442 | } |
---|
| 443 | if(fn[0].tasks && (k = fn[0].tasks.length)) { |
---|
| 444 | while(k--) { |
---|
| 445 | fn[0].tasks[k].cancel(); |
---|
| 446 | } |
---|
| 447 | delete fn.tasks; |
---|
| 448 | } |
---|
| 449 | wrap = fn[1]; |
---|
| 450 | E.un(el, ename, E.extAdapter ? fn[3] : wrap); |
---|
| 451 | |
---|
| 452 | // jQuery workaround that should be removed from Ext Core |
---|
| 453 | if(el.addEventListener && wrap && ename == "mousewheel"){ |
---|
| 454 | el.removeEventListener("DOMMouseScroll", wrap, false); |
---|
| 455 | } |
---|
| 456 | |
---|
| 457 | // fix stopped mousedowns on the document |
---|
| 458 | if(wrap && el == DOC && ename == "mousedown"){ |
---|
| 459 | Ext.EventManager.stoppedMouseDownEvent.removeListener(wrap); |
---|
| 460 | } |
---|
| 461 | } |
---|
| 462 | } |
---|
| 463 | } |
---|
| 464 | if (Ext.elCache[id]) { |
---|
| 465 | Ext.elCache[id].events = {}; |
---|
| 466 | } |
---|
| 467 | }, |
---|
| 468 | |
---|
| 469 | getListeners : function(el, eventName) { |
---|
| 470 | el = Ext.getDom(el); |
---|
| 471 | var id = getId(el), |
---|
| 472 | ec = Ext.elCache[id] || {}, |
---|
| 473 | es = ec.events || {}, |
---|
| 474 | results = []; |
---|
| 475 | if (es && es[eventName]) { |
---|
| 476 | return es[eventName]; |
---|
| 477 | } else { |
---|
| 478 | return null; |
---|
| 479 | } |
---|
| 480 | }, |
---|
| 481 | |
---|
| 482 | purgeElement : function(el, recurse, eventName) { |
---|
| 483 | el = Ext.getDom(el); |
---|
| 484 | var id = getId(el), |
---|
| 485 | ec = Ext.elCache[id] || {}, |
---|
| 486 | es = ec.events || {}, |
---|
| 487 | i, f, len; |
---|
| 488 | if (eventName) { |
---|
| 489 | if (es && es.hasOwnProperty(eventName)) { |
---|
| 490 | f = es[eventName]; |
---|
| 491 | for (i = 0, len = f.length; i < len; i++) { |
---|
| 492 | Ext.EventManager.removeListener(el, eventName, f[i][0]); |
---|
| 493 | } |
---|
| 494 | } |
---|
| 495 | } else { |
---|
| 496 | Ext.EventManager.removeAll(el); |
---|
| 497 | } |
---|
| 498 | if (recurse && el && el.childNodes) { |
---|
| 499 | for (i = 0, len = el.childNodes.length; i < len; i++) { |
---|
| 500 | Ext.EventManager.purgeElement(el.childNodes[i], recurse, eventName); |
---|
| 501 | } |
---|
| 502 | } |
---|
| 503 | }, |
---|
| 504 | |
---|
| 505 | _unload : function() { |
---|
| 506 | var el; |
---|
| 507 | for (el in Ext.elCache) { |
---|
| 508 | Ext.EventManager.removeAll(el); |
---|
| 509 | } |
---|
| 510 | delete Ext.elCache; |
---|
| 511 | delete Ext.Element._flyweights; |
---|
| 512 | |
---|
| 513 | // Abort any outstanding Ajax requests |
---|
| 514 | var c, |
---|
| 515 | conn, |
---|
| 516 | tid, |
---|
| 517 | ajax = Ext.lib.Ajax; |
---|
| 518 | (typeof ajax.conn == 'object') ? conn = ajax.conn : conn = {}; |
---|
| 519 | for (tid in conn) { |
---|
| 520 | c = conn[tid]; |
---|
| 521 | if (c) { |
---|
| 522 | ajax.abort({conn: c, tId: tid}); |
---|
| 523 | } |
---|
| 524 | } |
---|
| 525 | }, |
---|
| 526 | /** |
---|
| 527 | * Adds a listener to be notified when the document is ready (before onload and before images are loaded). Can be |
---|
| 528 | * accessed shorthanded as Ext.onReady(). |
---|
| 529 | * @param {Function} fn The method the event invokes. |
---|
| 530 | * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the handler function executes. Defaults to the browser window. |
---|
| 531 | * @param {boolean} options (optional) Options object as passed to {@link Ext.Element#addListener}. It is recommended that the options |
---|
| 532 | * <code>{single: true}</code> be used so that the handler is removed on first invocation. |
---|
| 533 | */ |
---|
| 534 | onDocumentReady : function(fn, scope, options){ |
---|
| 535 | if (Ext.isReady) { // if it already fired or document.body is present |
---|
| 536 | docReadyEvent || (docReadyEvent = new Ext.util.Event()); |
---|
| 537 | docReadyEvent.addListener(fn, scope, options); |
---|
| 538 | docReadyEvent.fire(); |
---|
| 539 | docReadyEvent.listeners = []; |
---|
| 540 | } else { |
---|
| 541 | if (!docReadyEvent) { |
---|
| 542 | initDocReady(); |
---|
| 543 | } |
---|
| 544 | options = options || {}; |
---|
| 545 | options.delay = options.delay || 1; |
---|
| 546 | docReadyEvent.addListener(fn, scope, options); |
---|
| 547 | } |
---|
| 548 | }, |
---|
| 549 | |
---|
| 550 | /** |
---|
| 551 | * Forces a document ready state transition for the framework. Used when Ext is loaded |
---|
| 552 | * into a DOM structure AFTER initial page load (Google API or other dynamic load scenario. |
---|
| 553 | * Any pending 'onDocumentReady' handlers will be fired (if not already handled). |
---|
| 554 | */ |
---|
| 555 | fireDocReady : fireDocReady |
---|
| 556 | }; |
---|
| 557 | /** |
---|
| 558 | * Appends an event handler to an element. Shorthand for {@link #addListener}. |
---|
| 559 | * @param {String/HTMLElement} el The html element or id to assign the event handler to |
---|
| 560 | * @param {String} eventName The name of the event to listen for. |
---|
| 561 | * @param {Function} handler The handler function the event invokes. |
---|
| 562 | * @param {Object} scope (optional) (<code>this</code> reference) in which the handler function executes. <b>Defaults to the Element</b>. |
---|
| 563 | * @param {Object} options (optional) An object containing standard {@link #addListener} options |
---|
| 564 | * @member Ext.EventManager |
---|
| 565 | * @method on |
---|
| 566 | */ |
---|
| 567 | pub.on = pub.addListener; |
---|
| 568 | /** |
---|
| 569 | * Removes an event handler from an element. Shorthand for {@link #removeListener}. |
---|
| 570 | * @param {String/HTMLElement} el The id or html element from which to remove the listener. |
---|
| 571 | * @param {String} eventName The name of the event. |
---|
| 572 | * @param {Function} fn The handler function to remove. <b>This must be a reference to the function passed into the {@link #on} call.</b> |
---|
| 573 | * @param {Object} scope If a scope (<b><code>this</code></b> reference) was specified when the listener was added, |
---|
| 574 | * then this must refer to the same object. |
---|
| 575 | * @member Ext.EventManager |
---|
| 576 | * @method un |
---|
| 577 | */ |
---|
| 578 | pub.un = pub.removeListener; |
---|
| 579 | |
---|
| 580 | pub.stoppedMouseDownEvent = new Ext.util.Event(); |
---|
| 581 | return pub; |
---|
| 582 | }(); |
---|
| 583 | /** |
---|
| 584 | * Adds a listener to be notified when the document is ready (before onload and before images are loaded). Shorthand of {@link Ext.EventManager#onDocumentReady}. |
---|
| 585 | * @param {Function} fn The method the event invokes. |
---|
| 586 | * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the handler function executes. Defaults to the browser window. |
---|
| 587 | * @param {boolean} options (optional) Options object as passed to {@link Ext.Element#addListener}. It is recommended that the options |
---|
| 588 | * <code>{single: true}</code> be used so that the handler is removed on first invocation. |
---|
| 589 | * @member Ext |
---|
| 590 | * @method onReady |
---|
| 591 | */ |
---|
| 592 | Ext.onReady = Ext.EventManager.onDocumentReady; |
---|
| 593 | |
---|
| 594 | |
---|
| 595 | //Initialize doc classes |
---|
| 596 | (function(){ |
---|
| 597 | var initExtCss = function() { |
---|
| 598 | // find the body element |
---|
| 599 | var bd = document.body || document.getElementsByTagName('body')[0]; |
---|
| 600 | if (!bd) { |
---|
| 601 | return false; |
---|
| 602 | } |
---|
| 603 | |
---|
| 604 | var cls = [' ', |
---|
| 605 | Ext.isIE ? "ext-ie " + (Ext.isIE6 ? 'ext-ie6' : (Ext.isIE7 ? 'ext-ie7' : (Ext.isIE8 ? 'ext-ie8' : 'ext-ie9'))) |
---|
| 606 | : Ext.isGecko ? "ext-gecko " + (Ext.isGecko2 ? 'ext-gecko2' : 'ext-gecko3') |
---|
| 607 | : Ext.isOpera ? "ext-opera" |
---|
| 608 | : Ext.isWebKit ? "ext-webkit" : ""]; |
---|
| 609 | |
---|
| 610 | if (Ext.isSafari) { |
---|
| 611 | cls.push("ext-safari " + (Ext.isSafari2 ? 'ext-safari2' : (Ext.isSafari3 ? 'ext-safari3' : 'ext-safari4'))); |
---|
| 612 | } else if(Ext.isChrome) { |
---|
| 613 | cls.push("ext-chrome"); |
---|
| 614 | } |
---|
| 615 | |
---|
| 616 | if (Ext.isMac) { |
---|
| 617 | cls.push("ext-mac"); |
---|
| 618 | } |
---|
| 619 | if (Ext.isLinux) { |
---|
| 620 | cls.push("ext-linux"); |
---|
| 621 | } |
---|
| 622 | |
---|
| 623 | // add to the parent to allow for selectors like ".ext-strict .ext-ie" |
---|
| 624 | if (Ext.isStrict || Ext.isBorderBox) { |
---|
| 625 | var p = bd.parentNode; |
---|
| 626 | if (p) { |
---|
| 627 | if (!Ext.isStrict) { |
---|
| 628 | Ext.fly(p, '_internal').addClass('x-quirks'); |
---|
| 629 | if (Ext.isIE && !Ext.isStrict) { |
---|
| 630 | Ext.isIEQuirks = true; |
---|
| 631 | } |
---|
| 632 | } |
---|
| 633 | Ext.fly(p, '_internal').addClass(((Ext.isStrict && Ext.isIE ) || (!Ext.enableForcedBoxModel && !Ext.isIE)) ? ' ext-strict' : ' ext-border-box'); |
---|
| 634 | } |
---|
| 635 | } |
---|
| 636 | // Forced border box model class applied to all elements. Bypassing javascript based box model adjustments |
---|
| 637 | // in favor of css. This is for non-IE browsers. |
---|
| 638 | if (Ext.enableForcedBoxModel && !Ext.isIE) { |
---|
| 639 | Ext.isForcedBorderBox = true; |
---|
| 640 | cls.push("ext-forced-border-box"); |
---|
| 641 | } |
---|
| 642 | |
---|
| 643 | Ext.fly(bd, '_internal').addClass(cls); |
---|
| 644 | return true; |
---|
| 645 | }; |
---|
| 646 | |
---|
| 647 | if (!initExtCss()) { |
---|
| 648 | Ext.onReady(initExtCss); |
---|
| 649 | } |
---|
| 650 | })(); |
---|
| 651 | |
---|
| 652 | /** |
---|
| 653 | * Code used to detect certain browser feature/quirks/bugs at startup. |
---|
| 654 | */ |
---|
| 655 | (function(){ |
---|
| 656 | var supports = Ext.apply(Ext.supports, { |
---|
| 657 | /** |
---|
| 658 | * In Webkit, there is an issue with getting the margin right property, see |
---|
| 659 | * https://bugs.webkit.org/show_bug.cgi?id=13343 |
---|
| 660 | */ |
---|
| 661 | correctRightMargin: true, |
---|
| 662 | |
---|
| 663 | /** |
---|
| 664 | * Webkit browsers return rgba(0, 0, 0) when a transparent color is used |
---|
| 665 | */ |
---|
| 666 | correctTransparentColor: true, |
---|
| 667 | |
---|
| 668 | /** |
---|
| 669 | * IE uses styleFloat, not cssFloat for the float property. |
---|
| 670 | */ |
---|
| 671 | cssFloat: true |
---|
| 672 | }); |
---|
| 673 | |
---|
| 674 | var supportTests = function(){ |
---|
| 675 | var div = document.createElement('div'), |
---|
| 676 | doc = document, |
---|
| 677 | view, |
---|
| 678 | last; |
---|
| 679 | |
---|
| 680 | div.innerHTML = '<div style="height:30px;width:50px;"><div style="height:20px;width:20px;"></div></div><div style="float:left;background-color:transparent;">'; |
---|
| 681 | doc.body.appendChild(div); |
---|
| 682 | last = div.lastChild; |
---|
| 683 | |
---|
| 684 | if((view = doc.defaultView)){ |
---|
| 685 | if(view.getComputedStyle(div.firstChild.firstChild, null).marginRight != '0px'){ |
---|
| 686 | supports.correctRightMargin = false; |
---|
| 687 | } |
---|
| 688 | if(view.getComputedStyle(last, null).backgroundColor != 'transparent'){ |
---|
| 689 | supports.correctTransparentColor = false; |
---|
| 690 | } |
---|
| 691 | } |
---|
| 692 | supports.cssFloat = !!last.style.cssFloat; |
---|
| 693 | doc.body.removeChild(div); |
---|
| 694 | }; |
---|
| 695 | |
---|
| 696 | if (Ext.isReady) { |
---|
| 697 | supportTests(); |
---|
| 698 | } else { |
---|
| 699 | Ext.onReady(supportTests); |
---|
| 700 | } |
---|
| 701 | })(); |
---|
| 702 | |
---|
| 703 | |
---|
| 704 | /** |
---|
| 705 | * @class Ext.EventObject |
---|
| 706 | * Just as {@link Ext.Element} wraps around a native DOM node, Ext.EventObject |
---|
| 707 | * wraps the browser's native event-object normalizing cross-browser differences, |
---|
| 708 | * such as which mouse button is clicked, keys pressed, mechanisms to stop |
---|
| 709 | * event-propagation along with a method to prevent default actions from taking place. |
---|
| 710 | * <p>For example:</p> |
---|
| 711 | * <pre><code> |
---|
| 712 | function handleClick(e, t){ // e is not a standard event object, it is a Ext.EventObject |
---|
| 713 | e.preventDefault(); |
---|
| 714 | var target = e.getTarget(); // same as t (the target HTMLElement) |
---|
| 715 | ... |
---|
| 716 | } |
---|
| 717 | var myDiv = {@link Ext#get Ext.get}("myDiv"); // get reference to an {@link Ext.Element} |
---|
| 718 | myDiv.on( // 'on' is shorthand for addListener |
---|
| 719 | "click", // perform an action on click of myDiv |
---|
| 720 | handleClick // reference to the action handler |
---|
| 721 | ); |
---|
| 722 | // other methods to do the same: |
---|
| 723 | Ext.EventManager.on("myDiv", 'click', handleClick); |
---|
| 724 | Ext.EventManager.addListener("myDiv", 'click', handleClick); |
---|
| 725 | </code></pre> |
---|
| 726 | * @singleton |
---|
| 727 | */ |
---|
| 728 | Ext.EventObject = function(){ |
---|
| 729 | var E = Ext.lib.Event, |
---|
| 730 | clickRe = /(dbl)?click/, |
---|
| 731 | // safari keypress events for special keys return bad keycodes |
---|
| 732 | safariKeys = { |
---|
| 733 | 3 : 13, // enter |
---|
| 734 | 63234 : 37, // left |
---|
| 735 | 63235 : 39, // right |
---|
| 736 | 63232 : 38, // up |
---|
| 737 | 63233 : 40, // down |
---|
| 738 | 63276 : 33, // page up |
---|
| 739 | 63277 : 34, // page down |
---|
| 740 | 63272 : 46, // delete |
---|
| 741 | 63273 : 36, // home |
---|
| 742 | 63275 : 35 // end |
---|
| 743 | }, |
---|
| 744 | // normalize button clicks |
---|
| 745 | btnMap = Ext.isIE ? {1:0,4:1,2:2} : {0:0,1:1,2:2}; |
---|
| 746 | |
---|
| 747 | Ext.EventObjectImpl = function(e){ |
---|
| 748 | if(e){ |
---|
| 749 | this.setEvent(e.browserEvent || e); |
---|
| 750 | } |
---|
| 751 | }; |
---|
| 752 | |
---|
| 753 | Ext.EventObjectImpl.prototype = { |
---|
| 754 | /** @private */ |
---|
| 755 | setEvent : function(e){ |
---|
| 756 | var me = this; |
---|
| 757 | if(e == me || (e && e.browserEvent)){ // already wrapped |
---|
| 758 | return e; |
---|
| 759 | } |
---|
| 760 | me.browserEvent = e; |
---|
| 761 | if(e){ |
---|
| 762 | // normalize buttons |
---|
| 763 | me.button = e.button ? btnMap[e.button] : (e.which ? e.which - 1 : -1); |
---|
| 764 | if(clickRe.test(e.type) && me.button == -1){ |
---|
| 765 | me.button = 0; |
---|
| 766 | } |
---|
| 767 | me.type = e.type; |
---|
| 768 | me.shiftKey = e.shiftKey; |
---|
| 769 | // mac metaKey behaves like ctrlKey |
---|
| 770 | me.ctrlKey = e.ctrlKey || e.metaKey || false; |
---|
| 771 | me.altKey = e.altKey; |
---|
| 772 | // in getKey these will be normalized for the mac |
---|
| 773 | me.keyCode = e.keyCode; |
---|
| 774 | me.charCode = e.charCode; |
---|
| 775 | // cache the target for the delayed and or buffered events |
---|
| 776 | me.target = E.getTarget(e); |
---|
| 777 | // same for XY |
---|
| 778 | me.xy = E.getXY(e); |
---|
| 779 | }else{ |
---|
| 780 | me.button = -1; |
---|
| 781 | me.shiftKey = false; |
---|
| 782 | me.ctrlKey = false; |
---|
| 783 | me.altKey = false; |
---|
| 784 | me.keyCode = 0; |
---|
| 785 | me.charCode = 0; |
---|
| 786 | me.target = null; |
---|
| 787 | me.xy = [0, 0]; |
---|
| 788 | } |
---|
| 789 | return me; |
---|
| 790 | }, |
---|
| 791 | |
---|
| 792 | /** |
---|
| 793 | * Stop the event (preventDefault and stopPropagation) |
---|
| 794 | */ |
---|
| 795 | stopEvent : function(){ |
---|
| 796 | var me = this; |
---|
| 797 | if(me.browserEvent){ |
---|
| 798 | if(me.browserEvent.type == 'mousedown'){ |
---|
| 799 | Ext.EventManager.stoppedMouseDownEvent.fire(me); |
---|
| 800 | } |
---|
| 801 | E.stopEvent(me.browserEvent); |
---|
| 802 | } |
---|
| 803 | }, |
---|
| 804 | |
---|
| 805 | /** |
---|
| 806 | * Prevents the browsers default handling of the event. |
---|
| 807 | */ |
---|
| 808 | preventDefault : function(){ |
---|
| 809 | if(this.browserEvent){ |
---|
| 810 | E.preventDefault(this.browserEvent); |
---|
| 811 | } |
---|
| 812 | }, |
---|
| 813 | |
---|
| 814 | /** |
---|
| 815 | * Cancels bubbling of the event. |
---|
| 816 | */ |
---|
| 817 | stopPropagation : function(){ |
---|
| 818 | var me = this; |
---|
| 819 | if(me.browserEvent){ |
---|
| 820 | if(me.browserEvent.type == 'mousedown'){ |
---|
| 821 | Ext.EventManager.stoppedMouseDownEvent.fire(me); |
---|
| 822 | } |
---|
| 823 | E.stopPropagation(me.browserEvent); |
---|
| 824 | } |
---|
| 825 | }, |
---|
| 826 | |
---|
| 827 | /** |
---|
| 828 | * Gets the character code for the event. |
---|
| 829 | * @return {Number} |
---|
| 830 | */ |
---|
| 831 | getCharCode : function(){ |
---|
| 832 | return this.charCode || this.keyCode; |
---|
| 833 | }, |
---|
| 834 | |
---|
| 835 | /** |
---|
| 836 | * Returns a normalized keyCode for the event. |
---|
| 837 | * @return {Number} The key code |
---|
| 838 | */ |
---|
| 839 | getKey : function(){ |
---|
| 840 | return this.normalizeKey(this.keyCode || this.charCode); |
---|
| 841 | }, |
---|
| 842 | |
---|
| 843 | // private |
---|
| 844 | normalizeKey: function(k){ |
---|
| 845 | return Ext.isSafari ? (safariKeys[k] || k) : k; |
---|
| 846 | }, |
---|
| 847 | |
---|
| 848 | /** |
---|
| 849 | * Gets the x coordinate of the event. |
---|
| 850 | * @return {Number} |
---|
| 851 | */ |
---|
| 852 | getPageX : function(){ |
---|
| 853 | return this.xy[0]; |
---|
| 854 | }, |
---|
| 855 | |
---|
| 856 | /** |
---|
| 857 | * Gets the y coordinate of the event. |
---|
| 858 | * @return {Number} |
---|
| 859 | */ |
---|
| 860 | getPageY : function(){ |
---|
| 861 | return this.xy[1]; |
---|
| 862 | }, |
---|
| 863 | |
---|
| 864 | /** |
---|
| 865 | * Gets the page coordinates of the event. |
---|
| 866 | * @return {Array} The xy values like [x, y] |
---|
| 867 | */ |
---|
| 868 | getXY : function(){ |
---|
| 869 | return this.xy; |
---|
| 870 | }, |
---|
| 871 | |
---|
| 872 | /** |
---|
| 873 | * Gets the target for the event. |
---|
| 874 | * @param {String} selector (optional) A simple selector to filter the target or look for an ancestor of the target |
---|
| 875 | * @param {Number/Mixed} maxDepth (optional) The max depth to |
---|
| 876 | search as a number or element (defaults to 10 || document.body) |
---|
| 877 | * @param {Boolean} returnEl (optional) True to return a Ext.Element object instead of DOM node |
---|
| 878 | * @return {HTMLelement} |
---|
| 879 | */ |
---|
| 880 | getTarget : function(selector, maxDepth, returnEl){ |
---|
| 881 | return selector ? Ext.fly(this.target).findParent(selector, maxDepth, returnEl) : (returnEl ? Ext.get(this.target) : this.target); |
---|
| 882 | }, |
---|
| 883 | |
---|
| 884 | /** |
---|
| 885 | * Gets the related target. |
---|
| 886 | * @return {HTMLElement} |
---|
| 887 | */ |
---|
| 888 | getRelatedTarget : function(){ |
---|
| 889 | return this.browserEvent ? E.getRelatedTarget(this.browserEvent) : null; |
---|
| 890 | }, |
---|
| 891 | |
---|
| 892 | /** |
---|
| 893 | * Normalizes mouse wheel delta across browsers |
---|
| 894 | * @return {Number} The delta |
---|
| 895 | */ |
---|
| 896 | getWheelDelta : function(){ |
---|
| 897 | var e = this.browserEvent; |
---|
| 898 | var delta = 0; |
---|
| 899 | if(e.wheelDelta){ /* IE/Opera. */ |
---|
| 900 | delta = e.wheelDelta/120; |
---|
| 901 | }else if(e.detail){ /* Mozilla case. */ |
---|
| 902 | delta = -e.detail/3; |
---|
| 903 | } |
---|
| 904 | return delta; |
---|
| 905 | }, |
---|
| 906 | |
---|
| 907 | /** |
---|
| 908 | * Returns true if the target of this event is a child of el. Unless the allowEl parameter is set, it will return false if if the target is el. |
---|
| 909 | * Example usage:<pre><code> |
---|
| 910 | // Handle click on any child of an element |
---|
| 911 | Ext.getBody().on('click', function(e){ |
---|
| 912 | if(e.within('some-el')){ |
---|
| 913 | alert('Clicked on a child of some-el!'); |
---|
| 914 | } |
---|
| 915 | }); |
---|
| 916 | |
---|
| 917 | // Handle click directly on an element, ignoring clicks on child nodes |
---|
| 918 | Ext.getBody().on('click', function(e,t){ |
---|
| 919 | if((t.id == 'some-el') && !e.within(t, true)){ |
---|
| 920 | alert('Clicked directly on some-el!'); |
---|
| 921 | } |
---|
| 922 | }); |
---|
| 923 | </code></pre> |
---|
| 924 | * @param {Mixed} el The id, DOM element or Ext.Element to check |
---|
| 925 | * @param {Boolean} related (optional) true to test if the related target is within el instead of the target |
---|
| 926 | * @param {Boolean} allowEl {optional} true to also check if the passed element is the target or related target |
---|
| 927 | * @return {Boolean} |
---|
| 928 | */ |
---|
| 929 | within : function(el, related, allowEl){ |
---|
| 930 | if(el){ |
---|
| 931 | var t = this[related ? "getRelatedTarget" : "getTarget"](); |
---|
| 932 | return t && ((allowEl ? (t == Ext.getDom(el)) : false) || Ext.fly(el).contains(t)); |
---|
| 933 | } |
---|
| 934 | return false; |
---|
| 935 | } |
---|
| 936 | }; |
---|
| 937 | |
---|
| 938 | return new Ext.EventObjectImpl(); |
---|
| 939 | }(); |
---|