1 | /*
|
---|
2 | Copyright (c) 2006 Yahoo! Inc. All rights reserved.
|
---|
3 | version 0.9.0
|
---|
4 | */
|
---|
5 |
|
---|
6 | /**
|
---|
7 | * @class The CustomEvent class lets you define events for your application
|
---|
8 | * that can be subscribed to by one or more independent component.
|
---|
9 | * @param {String} type The type of event, which is passed to the callback
|
---|
10 | * when the event fires
|
---|
11 | * @param {Object} oScope The context the event will fire from. "this" will
|
---|
12 | * refer to this object in the callback. Default value:
|
---|
13 | * the window object. The listener can override this.
|
---|
14 | * @constructor
|
---|
15 | */
|
---|
16 | YAHOO.util.CustomEvent = function(type, oScope) {
|
---|
17 | /**
|
---|
18 | * The type of event, returned to subscribers when the event fires
|
---|
19 | * @type string
|
---|
20 | */
|
---|
21 | this.type = type;
|
---|
22 |
|
---|
23 | /**
|
---|
24 | * The scope the the event will fire from. Defaults to the window obj
|
---|
25 | * @type object
|
---|
26 | */
|
---|
27 | this.scope = oScope || window;
|
---|
28 |
|
---|
29 | /**
|
---|
30 | * The subscribers to this event
|
---|
31 | * @type array
|
---|
32 | */
|
---|
33 | this.subscribers = [];
|
---|
34 |
|
---|
35 | // Register with the event utility for automatic cleanup. Made optional
|
---|
36 | // so that CustomEvent can be used independently of pe.event
|
---|
37 | if (YAHOO.util["Event"]) {
|
---|
38 | YAHOO.util.Event.regCE(this);
|
---|
39 | }
|
---|
40 | };
|
---|
41 |
|
---|
42 | YAHOO.util.CustomEvent.prototype = {
|
---|
43 | /**
|
---|
44 | * Subscribes the caller to this event
|
---|
45 | * @param {Function} fn The function to execute
|
---|
46 | * @param {Object} obj An object to be passed along when the event fires
|
---|
47 | * @param {boolean} bOverride If true, the obj passed in becomes the execution
|
---|
48 | * scope of the listener
|
---|
49 | */
|
---|
50 | subscribe: function(fn, obj, bOverride) {
|
---|
51 | this.subscribers.push( new YAHOO.util.Subscriber(fn, obj, bOverride) );
|
---|
52 | },
|
---|
53 |
|
---|
54 | /**
|
---|
55 | * Unsubscribes the caller from this event
|
---|
56 | * @param {Function} fn The function to execute
|
---|
57 | * @param {Object} obj An object to be passed along when the event fires
|
---|
58 | * @return {boolean} True if the subscriber was found and detached.
|
---|
59 | */
|
---|
60 | unsubscribe: function(fn, obj) {
|
---|
61 | var found = false;
|
---|
62 | for (var i=0; i<this.subscribers.length; ++i) {
|
---|
63 | var s = this.subscribers[i];
|
---|
64 | if (s && s.contains(fn, obj)) {
|
---|
65 | this._delete(i);
|
---|
66 | found = true;
|
---|
67 | }
|
---|
68 | }
|
---|
69 |
|
---|
70 | return found;
|
---|
71 | },
|
---|
72 |
|
---|
73 | /**
|
---|
74 | * Notifies the subscribers. The callback functions will be executed
|
---|
75 | * from the scope specified when the event was created, and with the following
|
---|
76 | * parameters:
|
---|
77 | * <pre>
|
---|
78 | * - The type of event
|
---|
79 | * - All of the arguments fire() was executed with as an array
|
---|
80 | * - The custom object (if any) that was passed into the subscribe() method
|
---|
81 | * </pre>
|
---|
82 | *
|
---|
83 | * @param {Array} an arbitrary set of parameters to pass to the handler
|
---|
84 | */
|
---|
85 | fire: function() {
|
---|
86 | for (var i=0; i<this.subscribers.length; ++i) {
|
---|
87 | var s = this.subscribers[i];
|
---|
88 | if (s) {
|
---|
89 | var scope = (s.override) ? s.obj : this.scope;
|
---|
90 | s.fn.call(scope, this.type, arguments, s.obj);
|
---|
91 | }
|
---|
92 | }
|
---|
93 | },
|
---|
94 |
|
---|
95 | /**
|
---|
96 | * Removes all listeners
|
---|
97 | */
|
---|
98 | unsubscribeAll: function() {
|
---|
99 | for (var i=0; i<this.subscribers.length; ++i) {
|
---|
100 | this._delete(i);
|
---|
101 | }
|
---|
102 | },
|
---|
103 |
|
---|
104 | /**
|
---|
105 | * @private
|
---|
106 | */
|
---|
107 | _delete: function(index) {
|
---|
108 | var s = this.subscribers[index];
|
---|
109 | if (s) {
|
---|
110 | delete s.fn;
|
---|
111 | delete s.obj;
|
---|
112 | }
|
---|
113 |
|
---|
114 | delete this.subscribers[index];
|
---|
115 | }
|
---|
116 | };
|
---|
117 |
|
---|
118 | /////////////////////////////////////////////////////////////////////
|
---|
119 |
|
---|
120 | /**
|
---|
121 | * @class
|
---|
122 | * @param {Function} fn The function to execute
|
---|
123 | * @param {Object} obj An object to be passed along when the event fires
|
---|
124 | * @param {boolean} bOverride If true, the obj passed in becomes the execution
|
---|
125 | * scope of the listener
|
---|
126 | * @constructor
|
---|
127 | */
|
---|
128 | YAHOO.util.Subscriber = function(fn, obj, bOverride) {
|
---|
129 | /**
|
---|
130 | * The callback that will be execute when the event fires
|
---|
131 | * @type function
|
---|
132 | */
|
---|
133 | this.fn = fn;
|
---|
134 |
|
---|
135 | /**
|
---|
136 | * An optional custom object that will passed to the callback when
|
---|
137 | * the event fires
|
---|
138 | * @type object
|
---|
139 | */
|
---|
140 | this.obj = obj || null;
|
---|
141 |
|
---|
142 | /**
|
---|
143 | * The default execution scope for the event listener is defined when the
|
---|
144 | * event is created (usually the object which contains the event).
|
---|
145 | * By setting override to true, the execution scope becomes the custom
|
---|
146 | * object passed in by the subscriber
|
---|
147 | * @type boolean
|
---|
148 | */
|
---|
149 | this.override = (bOverride);
|
---|
150 | };
|
---|
151 |
|
---|
152 | /**
|
---|
153 | * Returns true if the fn and obj match this objects properties.
|
---|
154 | * Used by the unsubscribe method to match the right subscriber.
|
---|
155 | *
|
---|
156 | * @param {Function} fn the function to execute
|
---|
157 | * @param {Object} obj an object to be passed along when the event fires
|
---|
158 | * @return {boolean} true if the supplied arguments match this
|
---|
159 | * subscriber's signature.
|
---|
160 | */
|
---|
161 | YAHOO.util.Subscriber.prototype.contains = function(fn, obj) {
|
---|
162 | return (this.fn == fn && this.obj == obj);
|
---|
163 | };
|
---|
164 |
|
---|
165 | /* Copyright (c) 2006 Yahoo! Inc. All rights reserved. */
|
---|
166 |
|
---|
167 | // Only load this library once. If it is loaded a second time, existing
|
---|
168 | // events cannot be detached.
|
---|
169 | if (!YAHOO.util.Event) {
|
---|
170 |
|
---|
171 | /**
|
---|
172 | * The event utility provides functions to add and remove event listeners,
|
---|
173 | * event cleansing. It also tries to automatically remove listeners it
|
---|
174 | * registers during the unload event.
|
---|
175 | * @class
|
---|
176 | * @constructor
|
---|
177 | */
|
---|
178 | YAHOO.util.Event = function() {
|
---|
179 |
|
---|
180 | /**
|
---|
181 | * True after the onload event has fired
|
---|
182 | * @type boolean
|
---|
183 | * @private
|
---|
184 | */
|
---|
185 | var loadComplete = false;
|
---|
186 |
|
---|
187 | /**
|
---|
188 | * Cache of wrapped listeners
|
---|
189 | * @type array
|
---|
190 | * @private
|
---|
191 | */
|
---|
192 | var listeners = [];
|
---|
193 |
|
---|
194 | /**
|
---|
195 | * Listeners that will be attached during the onload event
|
---|
196 | * @type array
|
---|
197 | * @private
|
---|
198 | */
|
---|
199 | var delayedListeners = [];
|
---|
200 |
|
---|
201 | /**
|
---|
202 | * User-defined unload function that will be fired before all events
|
---|
203 | * are detached
|
---|
204 | * @type array
|
---|
205 | * @private
|
---|
206 | */
|
---|
207 | var unloadListeners = [];
|
---|
208 |
|
---|
209 | /**
|
---|
210 | * Cache of the custom events that have been defined. Used for
|
---|
211 | * automatic cleanup
|
---|
212 | * @type array
|
---|
213 | * @private
|
---|
214 | */
|
---|
215 | var customEvents = [];
|
---|
216 |
|
---|
217 | /**
|
---|
218 | * Cache of DOM0 event handlers to work around issues with DOM2 events
|
---|
219 | * in Safari
|
---|
220 | * @private
|
---|
221 | */
|
---|
222 | var legacyEvents = [];
|
---|
223 |
|
---|
224 | /**
|
---|
225 | * Listener stack for DOM0 events
|
---|
226 | * @private
|
---|
227 | */
|
---|
228 | var legacyHandlers = [];
|
---|
229 |
|
---|
230 | return { // PREPROCESS
|
---|
231 |
|
---|
232 | /**
|
---|
233 | * Element to bind, int constant
|
---|
234 | * @type int
|
---|
235 | */
|
---|
236 | EL: 0,
|
---|
237 |
|
---|
238 | /**
|
---|
239 | * Type of event, int constant
|
---|
240 | * @type int
|
---|
241 | */
|
---|
242 | TYPE: 1,
|
---|
243 |
|
---|
244 | /**
|
---|
245 | * Function to execute, int constant
|
---|
246 | * @type int
|
---|
247 | */
|
---|
248 | FN: 2,
|
---|
249 |
|
---|
250 | /**
|
---|
251 | * Function wrapped for scope correction and cleanup, int constant
|
---|
252 | * @type int
|
---|
253 | */
|
---|
254 | WFN: 3,
|
---|
255 |
|
---|
256 | /**
|
---|
257 | * Object passed in by the user that will be returned as a
|
---|
258 | * parameter to the callback, int constant
|
---|
259 | * @type int
|
---|
260 | */
|
---|
261 | SCOPE: 3,
|
---|
262 |
|
---|
263 | /**
|
---|
264 | * Adjusted scope, either the element we are registering the event
|
---|
265 | * on or the custom object passed in by the listener, int constant
|
---|
266 | * @type int
|
---|
267 | */
|
---|
268 | ADJ_SCOPE: 4,
|
---|
269 |
|
---|
270 | /**
|
---|
271 | * Safari detection is necessary to work around the preventDefault
|
---|
272 | * bug that makes it so you can't cancel a href click from the
|
---|
273 | * handler. There is not a capabilities check we can use here.
|
---|
274 | * @private
|
---|
275 | */
|
---|
276 | isSafari: (navigator.userAgent.match(/safari/gi)),
|
---|
277 |
|
---|
278 | /**
|
---|
279 | * @private
|
---|
280 | * IE detection needed to properly calculate pageX and pageY.
|
---|
281 | * capabilities checking didn't seem to work because another
|
---|
282 | * browser that does not provide the properties have the values
|
---|
283 | * calculated in a different manner than IE.
|
---|
284 | */
|
---|
285 | isIE: (!this.isSafari && navigator.userAgent.match(/msie/gi)),
|
---|
286 |
|
---|
287 | /**
|
---|
288 | * Appends an event handler
|
---|
289 | *
|
---|
290 | * @param {Object} el The html element to assign the
|
---|
291 | * event to
|
---|
292 | * @param {String} sType The type of event to append
|
---|
293 | * @param {Function} fn The method the event invokes
|
---|
294 | * @param {Object} oScope An arbitrary object that will be
|
---|
295 | * passed as a parameter to the handler
|
---|
296 | * @param {boolean} bOverride If true, the obj passed in becomes
|
---|
297 | * the execution scope of the listener
|
---|
298 | * @return {boolean} True if the action was successful or defered,
|
---|
299 | * false if one or more of the elements
|
---|
300 | * could not have the event bound to it.
|
---|
301 | */
|
---|
302 | addListener: function(el, sType, fn, oScope, bOverride) {
|
---|
303 |
|
---|
304 | // The el argument can be an array of elements or element ids.
|
---|
305 | if ( this._isValidCollection(el)) {
|
---|
306 | var ok = true;
|
---|
307 | for (var i=0; i< el.length; ++i) {
|
---|
308 | ok = ( this.on(el[i],
|
---|
309 | sType,
|
---|
310 | fn,
|
---|
311 | oScope,
|
---|
312 | bOverride) && ok );
|
---|
313 | }
|
---|
314 | return ok;
|
---|
315 |
|
---|
316 | } else if (typeof el == "string") {
|
---|
317 | // If the el argument is a string, we assume it is
|
---|
318 | // actually the id of the element. If the page is loaded
|
---|
319 | // we convert el to the actual element, otherwise we
|
---|
320 | // defer attaching the event until onload event fires
|
---|
321 |
|
---|
322 | // check to see if we need to delay hooking up the event
|
---|
323 | // until after the page loads.
|
---|
324 | if (loadComplete) {
|
---|
325 | el = this.getEl(el);
|
---|
326 | } else {
|
---|
327 | // defer adding the event until onload fires
|
---|
328 | delayedListeners[delayedListeners.length] =
|
---|
329 | [el, sType, fn, oScope, bOverride];
|
---|
330 |
|
---|
331 | return true;
|
---|
332 | }
|
---|
333 | }
|
---|
334 |
|
---|
335 | // Element should be an html element or an array if we get
|
---|
336 | // here.
|
---|
337 | if (!el) {
|
---|
338 | return false;
|
---|
339 | }
|
---|
340 |
|
---|
341 | // we need to make sure we fire registered unload events
|
---|
342 | // prior to automatically unhooking them. So we hang on to
|
---|
343 | // these instead of attaching them to the window and fire the
|
---|
344 | // handles explicitly during our one unload event.
|
---|
345 | if ("unload" == sType && oScope !== this) {
|
---|
346 | unloadListeners[unloadListeners.length] =
|
---|
347 | [el, sType, fn, oScope, bOverride];
|
---|
348 | return true;
|
---|
349 | }
|
---|
350 |
|
---|
351 |
|
---|
352 | // if the user chooses to override the scope, we use the custom
|
---|
353 | // object passed in, otherwise the executing scope will be the
|
---|
354 | // HTML element that the event is registered on
|
---|
355 | var scope = (bOverride) ? oScope : el;
|
---|
356 |
|
---|
357 | // wrap the function so we can return the oScope object when
|
---|
358 | // the event fires;
|
---|
359 | var wrappedFn = function(e) {
|
---|
360 | return fn.call(scope, YAHOO.util.Event.getEvent(e),
|
---|
361 | oScope);
|
---|
362 | };
|
---|
363 |
|
---|
364 | var li = [el, sType, fn, wrappedFn, scope];
|
---|
365 | var index = listeners.length;
|
---|
366 | // cache the listener so we can try to automatically unload
|
---|
367 | listeners[index] = li;
|
---|
368 |
|
---|
369 | if (this.useLegacyEvent(el, sType)) {
|
---|
370 | var legacyIndex = this.getLegacyIndex(el, sType);
|
---|
371 | if (legacyIndex == -1) {
|
---|
372 |
|
---|
373 | legacyIndex = legacyEvents.length;
|
---|
374 | // cache the signature for the DOM0 event, and
|
---|
375 | // include the existing handler for the event, if any
|
---|
376 | legacyEvents[legacyIndex] =
|
---|
377 | [el, sType, el["on" + sType]];
|
---|
378 | legacyHandlers[legacyIndex] = [];
|
---|
379 |
|
---|
380 | el["on" + sType] =
|
---|
381 | function(e) {
|
---|
382 | YAHOO.util.Event.fireLegacyEvent(
|
---|
383 | YAHOO.util.Event.getEvent(e), legacyIndex);
|
---|
384 | };
|
---|
385 | }
|
---|
386 |
|
---|
387 | // add a reference to the wrapped listener to our custom
|
---|
388 | // stack of events
|
---|
389 | legacyHandlers[legacyIndex].push(index);
|
---|
390 |
|
---|
391 | // DOM2 Event model
|
---|
392 | } else if (el.addEventListener) {
|
---|
393 | el.addEventListener(sType, wrappedFn, false);
|
---|
394 | // Internet Explorer abstraction
|
---|
395 | } else if (el.attachEvent) {
|
---|
396 | el.attachEvent("on" + sType, wrappedFn);
|
---|
397 | }
|
---|
398 |
|
---|
399 | return true;
|
---|
400 |
|
---|
401 | },
|
---|
402 |
|
---|
403 | /**
|
---|
404 | * Shorthand for YAHOO.util.Event.addListener
|
---|
405 | * @type function
|
---|
406 | */
|
---|
407 | // on: this.addListener,
|
---|
408 |
|
---|
409 | /**
|
---|
410 | * When using legacy events, the handler is routed to this object
|
---|
411 | * so we can fire our custom listener stack.
|
---|
412 | * @private
|
---|
413 | */
|
---|
414 | fireLegacyEvent: function(e, legacyIndex) {
|
---|
415 | // alert("fireLegacyEvent " + legacyIndex);
|
---|
416 | var ok = true;
|
---|
417 |
|
---|
418 | // var el = legacyEvents[YAHOO.util.Event.EL];
|
---|
419 |
|
---|
420 | /* this is not working because the property may get populated
|
---|
421 | // fire the event we replaced, if it exists
|
---|
422 | var origHandler = legacyEvents[2];
|
---|
423 | alert(origHandler);
|
---|
424 | if (origHandler && origHandler.call) {
|
---|
425 | var ret = origHandler.call(el, e);
|
---|
426 | ok = (ret);
|
---|
427 | }
|
---|
428 | */
|
---|
429 |
|
---|
430 | var le = legacyHandlers[legacyIndex];
|
---|
431 | for (i=0; i < le.length; ++i) {
|
---|
432 | var index = le[i];
|
---|
433 | // alert(index);
|
---|
434 | if (index) {
|
---|
435 | var li = listeners[index];
|
---|
436 | var scope = li[this.ADJ_SCOPE];
|
---|
437 | var ret = li[this.WFN].call(scope, e);
|
---|
438 | ok = (ok && ret);
|
---|
439 | // alert(ok);
|
---|
440 | }
|
---|
441 | }
|
---|
442 |
|
---|
443 | return ok;
|
---|
444 | },
|
---|
445 |
|
---|
446 | /**
|
---|
447 | * Returns the legacy event index that matches the supplied
|
---|
448 | * signature
|
---|
449 | * @private
|
---|
450 | */
|
---|
451 | getLegacyIndex: function(el, sType) {
|
---|
452 | for (var i=0; i < legacyEvents.length; ++i) {
|
---|
453 | var le = legacyEvents[i];
|
---|
454 | if (le && le[0] == el && le[1] == sType) {
|
---|
455 | return i;
|
---|
456 | }
|
---|
457 | }
|
---|
458 |
|
---|
459 | return -1;
|
---|
460 | },
|
---|
461 |
|
---|
462 | /**
|
---|
463 | * Logic that determines when we should automatically use legacy
|
---|
464 | * events instead of DOM2 events.
|
---|
465 | * @private
|
---|
466 | */
|
---|
467 | useLegacyEvent: function(el, sType) {
|
---|
468 |
|
---|
469 | return ( (!el.addEventListener && !el.attachEvent) ||
|
---|
470 | (sType == "click" && this.isSafari) );
|
---|
471 | },
|
---|
472 |
|
---|
473 | /**
|
---|
474 | * Removes an event handler
|
---|
475 | *
|
---|
476 | * @param {Object} el the html element or the id of the element to
|
---|
477 | * assign the event to.
|
---|
478 | * @param {String} sType the type of event to remove
|
---|
479 | * @param {Function} fn the method the event invokes
|
---|
480 | * @return {boolean} true if the unbind was successful, false
|
---|
481 | * otherwise
|
---|
482 | */
|
---|
483 | removeListener: function(el, sType, fn) {
|
---|
484 |
|
---|
485 | // The el argument can be a string
|
---|
486 | if (typeof el == "string") {
|
---|
487 | el = this.getEl(el);
|
---|
488 | // The el argument can be an array of elements or element ids.
|
---|
489 | } else if ( this._isValidCollection(el)) {
|
---|
490 | var ok = true;
|
---|
491 | for (var i=0; i< el.length; ++i) {
|
---|
492 | ok = ( this.removeListener(el[i], sType, fn) && ok );
|
---|
493 | }
|
---|
494 | return ok;
|
---|
495 | }
|
---|
496 |
|
---|
497 | var cacheItem = null;
|
---|
498 | var index = this._getCacheIndex(el, sType, fn);
|
---|
499 |
|
---|
500 | if (index >= 0) {
|
---|
501 | cacheItem = listeners[index];
|
---|
502 | }
|
---|
503 |
|
---|
504 | if (!el || !cacheItem) {
|
---|
505 | return false;
|
---|
506 | }
|
---|
507 |
|
---|
508 |
|
---|
509 | if (el.removeEventListener) {
|
---|
510 | el.removeEventListener(sType, cacheItem[this.WFN], false);
|
---|
511 | // alert("adsf");
|
---|
512 | } else if (el.detachEvent) {
|
---|
513 | el.detachEvent("on" + sType, cacheItem[this.WFN]);
|
---|
514 | }
|
---|
515 |
|
---|
516 | // removed the wrapped handler
|
---|
517 | delete listeners[index][this.WFN];
|
---|
518 | delete listeners[index][this.FN];
|
---|
519 | delete listeners[index];
|
---|
520 |
|
---|
521 | return true;
|
---|
522 |
|
---|
523 | },
|
---|
524 |
|
---|
525 | /**
|
---|
526 | * Returns the event's target element
|
---|
527 | * @param {Event} ev the event
|
---|
528 | * @param {boolean} resolveTextNode when set to true the target's
|
---|
529 | * parent will be returned if the target is a
|
---|
530 | * text node
|
---|
531 | * @return {HTMLElement} the event's target
|
---|
532 | */
|
---|
533 | getTarget: function(ev, resolveTextNode) {
|
---|
534 | var t = ev.target || ev.srcElement;
|
---|
535 |
|
---|
536 | if (resolveTextNode && t && "#text" == t.nodeName) {
|
---|
537 | return t.parentNode;
|
---|
538 | } else {
|
---|
539 | return t;
|
---|
540 | }
|
---|
541 | },
|
---|
542 |
|
---|
543 | /**
|
---|
544 | * Returns the event's pageX
|
---|
545 | * @param {Event} ev the event
|
---|
546 | * @return {int} the event's pageX
|
---|
547 | */
|
---|
548 | getPageX: function(ev) {
|
---|
549 | var x = ev.pageX;
|
---|
550 | if (!x && 0 !== x) {
|
---|
551 | x = ev.clientX || 0;
|
---|
552 |
|
---|
553 | if ( this.isIE ) {
|
---|
554 | x += this._getScrollLeft();
|
---|
555 | }
|
---|
556 | }
|
---|
557 |
|
---|
558 | return x;
|
---|
559 | },
|
---|
560 |
|
---|
561 | /**
|
---|
562 | * Returns the event's pageY
|
---|
563 | * @param {Event} ev the event
|
---|
564 | * @return {int} the event's pageY
|
---|
565 | */
|
---|
566 | getPageY: function(ev) {
|
---|
567 | var y = ev.pageY;
|
---|
568 | if (!y && 0 !== y) {
|
---|
569 | y = ev.clientY || 0;
|
---|
570 |
|
---|
571 | if ( this.isIE ) {
|
---|
572 | y += this._getScrollTop();
|
---|
573 | }
|
---|
574 | }
|
---|
575 |
|
---|
576 | return y;
|
---|
577 | },
|
---|
578 |
|
---|
579 | /**
|
---|
580 | * Returns the event's related target
|
---|
581 | * @param {Event} ev the event
|
---|
582 | * @return {HTMLElement} the event's relatedTarget
|
---|
583 | */
|
---|
584 | getRelatedTarget: function(ev) {
|
---|
585 | var t = ev.relatedTarget;
|
---|
586 | if (!t) {
|
---|
587 | if (ev.type == "mouseout") {
|
---|
588 | t = ev.toElement;
|
---|
589 | } else if (ev.type == "mouseover") {
|
---|
590 | t = ev.fromElement;
|
---|
591 | }
|
---|
592 | }
|
---|
593 |
|
---|
594 | return t;
|
---|
595 | },
|
---|
596 |
|
---|
597 | /**
|
---|
598 | * Returns the time of the event. If the time is not included, the
|
---|
599 | * event is modified using the current time.
|
---|
600 | * @param {Event} ev the event
|
---|
601 | * @return {Date} the time of the event
|
---|
602 | */
|
---|
603 | getTime: function(ev) {
|
---|
604 | if (!ev.time) {
|
---|
605 | var t = new Date().getTime();
|
---|
606 | try {
|
---|
607 | ev.time = t;
|
---|
608 | } catch(e) {
|
---|
609 | // can't set the time property
|
---|
610 | return t;
|
---|
611 | }
|
---|
612 | }
|
---|
613 |
|
---|
614 | return ev.time;
|
---|
615 | },
|
---|
616 |
|
---|
617 | /**
|
---|
618 | * Convenience method for stopPropagation + preventDefault
|
---|
619 | * @param {Event} ev the event
|
---|
620 | */
|
---|
621 | stopEvent: function(ev) {
|
---|
622 | this.stopPropagation(ev);
|
---|
623 | this.preventDefault(ev);
|
---|
624 | },
|
---|
625 |
|
---|
626 | /**
|
---|
627 | * Stops event propagation
|
---|
628 | * @param {Event} ev the event
|
---|
629 | */
|
---|
630 | stopPropagation: function(ev) {
|
---|
631 | if (ev.stopPropagation) {
|
---|
632 | ev.stopPropagation();
|
---|
633 | } else {
|
---|
634 | ev.cancelBubble = true;
|
---|
635 | }
|
---|
636 | },
|
---|
637 |
|
---|
638 | /**
|
---|
639 | * Prevents the default behavior of the event
|
---|
640 | * @param {Event} ev the event
|
---|
641 | */
|
---|
642 | preventDefault: function(ev) {
|
---|
643 | if (ev.preventDefault) {
|
---|
644 | ev.preventDefault();
|
---|
645 | } else {
|
---|
646 | ev.returnValue = false;
|
---|
647 | }
|
---|
648 | },
|
---|
649 |
|
---|
650 | /**
|
---|
651 | * Returns the event, should not be necessary for user to call
|
---|
652 | * @param {Event} the event parameter from the handler
|
---|
653 | * @return {Event} the event
|
---|
654 | */
|
---|
655 | getEvent: function(e) {
|
---|
656 | var ev = e || window.event;
|
---|
657 |
|
---|
658 | if (!ev) {
|
---|
659 | var c = this.getEvent.caller;
|
---|
660 | while (c) {
|
---|
661 | ev = c.arguments[0];
|
---|
662 | if (ev && Event == ev.constructor) {
|
---|
663 | break;
|
---|
664 | }
|
---|
665 | c = c.caller;
|
---|
666 | }
|
---|
667 | }
|
---|
668 |
|
---|
669 | return ev;
|
---|
670 | },
|
---|
671 |
|
---|
672 | /**
|
---|
673 | * Returns the charcode for an event
|
---|
674 | * @param {Event} ev the event
|
---|
675 | * @return {int} the event's charCode
|
---|
676 | */
|
---|
677 | getCharCode: function(ev) {
|
---|
678 | return ev.charCode || (ev.type == "keypress") ? ev.keyCode : 0;
|
---|
679 | },
|
---|
680 |
|
---|
681 | /**
|
---|
682 | * @private
|
---|
683 | * Locating the saved event handler data by function ref
|
---|
684 | */
|
---|
685 | _getCacheIndex: function(el, sType, fn) {
|
---|
686 | for (var i=0; i< listeners.length; ++i) {
|
---|
687 | var li = listeners[i];
|
---|
688 | if ( li &&
|
---|
689 | li[this.FN] == fn &&
|
---|
690 | li[this.EL] == el &&
|
---|
691 | li[this.TYPE] == sType ) {
|
---|
692 | return i;
|
---|
693 | }
|
---|
694 | }
|
---|
695 |
|
---|
696 | return -1;
|
---|
697 | },
|
---|
698 |
|
---|
699 | /**
|
---|
700 | * We want to be able to use getElementsByTagName as a collection
|
---|
701 | * to attach a group of events to. Unfortunately, different
|
---|
702 | * browsers return different types of collections. This function
|
---|
703 | * tests to determine if the object is array-like. It will also
|
---|
704 | * fail if the object is an array, but is empty.
|
---|
705 | * @param o the object to test
|
---|
706 | * @return {boolean} true if the object is array-like and populated
|
---|
707 | */
|
---|
708 | _isValidCollection: function(o) {
|
---|
709 | // alert(o.constructor.toString())
|
---|
710 | // alert(typeof o)
|
---|
711 |
|
---|
712 | return ( o && // o is something
|
---|
713 | o.length && // o is indexed
|
---|
714 | typeof o != "string" && // o is not a string
|
---|
715 | !o.tagName && // o is not an HTML element
|
---|
716 | !o.alert && // o is not a window
|
---|
717 | typeof o[0] != "undefined" );
|
---|
718 |
|
---|
719 | },
|
---|
720 |
|
---|
721 | /**
|
---|
722 | * @private
|
---|
723 | * DOM element cache
|
---|
724 | */
|
---|
725 | elCache: {},
|
---|
726 |
|
---|
727 | /**
|
---|
728 | * We cache elements bound by id because when the unload event
|
---|
729 | * fires, we can no longer use document.getElementById
|
---|
730 | * @private
|
---|
731 | */
|
---|
732 | getEl: function(id) {
|
---|
733 | /*
|
---|
734 | // this is a problem when replaced via document.getElementById
|
---|
735 | if (! this.elCache[id]) {
|
---|
736 | try {
|
---|
737 | var el = document.getElementById(id);
|
---|
738 | if (el) {
|
---|
739 | this.elCache[id] = el;
|
---|
740 | }
|
---|
741 | } catch (er) {
|
---|
742 | }
|
---|
743 | }
|
---|
744 | return this.elCache[id];
|
---|
745 | */
|
---|
746 |
|
---|
747 | return document.getElementById(id);
|
---|
748 | },
|
---|
749 |
|
---|
750 | /**
|
---|
751 | * Clears the element cache
|
---|
752 | */
|
---|
753 | clearCache: function() {
|
---|
754 | for (i in this.elCache) {
|
---|
755 | delete this.elCache[i];
|
---|
756 | }
|
---|
757 | },
|
---|
758 |
|
---|
759 | /**
|
---|
760 | * Called by CustomEvent instances to provide a handle to the
|
---|
761 | * event * that can be removed later on. Should be package
|
---|
762 | * protected.
|
---|
763 | * @private
|
---|
764 | */
|
---|
765 | regCE: function(ce) {
|
---|
766 | customEvents.push(ce);
|
---|
767 | },
|
---|
768 |
|
---|
769 | /**
|
---|
770 | * @private
|
---|
771 | * hook up any deferred listeners
|
---|
772 | */
|
---|
773 | _load: function(e) {
|
---|
774 | loadComplete = true;
|
---|
775 | },
|
---|
776 |
|
---|
777 | /**
|
---|
778 | * Polling function that runs before the onload event fires,
|
---|
779 | * attempting * to attach to DOM Nodes as soon as they are
|
---|
780 | * available
|
---|
781 | * @private
|
---|
782 | */
|
---|
783 | _tryPreloadAttach: function() {
|
---|
784 |
|
---|
785 | // keep trying until after the page is loaded. We need to
|
---|
786 | // check the page load state prior to trying to bind the
|
---|
787 | // elements so that we can be certain all elements have been
|
---|
788 | // tested appropriately
|
---|
789 | var tryAgain = !loadComplete;
|
---|
790 |
|
---|
791 | for (var i=0; i < delayedListeners.length; ++i) {
|
---|
792 | var d = delayedListeners[i];
|
---|
793 | // There may be a race condition here, so we need to
|
---|
794 | // verify the array element is usable.
|
---|
795 | if (d) {
|
---|
796 |
|
---|
797 | // el will be null if document.getElementById did not
|
---|
798 | // work
|
---|
799 | var el = this.getEl(d[this.EL]);
|
---|
800 |
|
---|
801 | if (el) {
|
---|
802 | this.on(el, d[this.TYPE], d[this.FN],
|
---|
803 | d[this.SCOPE], d[this.ADJ_SCOPE]);
|
---|
804 | delete delayedListeners[i];
|
---|
805 | }
|
---|
806 | }
|
---|
807 | }
|
---|
808 |
|
---|
809 | if (tryAgain) {
|
---|
810 | setTimeout("YAHOO.util.Event._tryPreloadAttach()", 50);
|
---|
811 | }
|
---|
812 | },
|
---|
813 |
|
---|
814 | /**
|
---|
815 | * Removes all listeners registered by pe.event. Called
|
---|
816 | * automatically during the unload event.
|
---|
817 | */
|
---|
818 | _unload: function(e, me) {
|
---|
819 | for (var i=0; i < unloadListeners.length; ++i) {
|
---|
820 | var l = unloadListeners[i];
|
---|
821 | if (l) {
|
---|
822 | var scope = (l[this.ADJ_SCOPE]) ? l[this.SCOPE]: window;
|
---|
823 | l[this.FN].call(scope, this.getEvent(e), l[this.SCOPE] );
|
---|
824 | }
|
---|
825 | }
|
---|
826 |
|
---|
827 | if (listeners && listeners.length > 0) {
|
---|
828 | for (i = 0; i < listeners.length; ++i) {
|
---|
829 | l = listeners[i];
|
---|
830 | if (l) {
|
---|
831 | this.removeListener(l[this.EL], l[this.TYPE],
|
---|
832 | l[this.FN]);
|
---|
833 | }
|
---|
834 | }
|
---|
835 |
|
---|
836 | this.clearCache();
|
---|
837 | }
|
---|
838 |
|
---|
839 | for (i = 0; i < customEvents.length; ++i) {
|
---|
840 | customEvents[i].unsubscribeAll();
|
---|
841 | delete customEvents[i];
|
---|
842 | }
|
---|
843 |
|
---|
844 | for (i = 0; i < legacyEvents.length; ++i) {
|
---|
845 | // dereference the element
|
---|
846 | delete legacyEvents[i][0];
|
---|
847 | // delete the array item
|
---|
848 | delete legacyEvents[i];
|
---|
849 | }
|
---|
850 | },
|
---|
851 |
|
---|
852 | /**
|
---|
853 | * Returns scrollLeft
|
---|
854 | * @private
|
---|
855 | */
|
---|
856 | _getScrollLeft: function() {
|
---|
857 | return this._getScroll()[1];
|
---|
858 | },
|
---|
859 |
|
---|
860 | /**
|
---|
861 | * Returns scrollTop
|
---|
862 | * @private
|
---|
863 | */
|
---|
864 | _getScrollTop: function() {
|
---|
865 | return this._getScroll()[0];
|
---|
866 | },
|
---|
867 |
|
---|
868 | /**
|
---|
869 | * Returns the scrollTop and scrollLeft. Used to calculate the
|
---|
870 | * pageX and pageY in Internet Explorer
|
---|
871 | * @private
|
---|
872 | */
|
---|
873 | _getScroll: function() {
|
---|
874 | var dd = document.documentElement; db = document.body;
|
---|
875 | if (dd && dd.scrollTop) {
|
---|
876 | return [dd.scrollTop, dd.scrollLeft];
|
---|
877 | } else if (db) {
|
---|
878 | return [db.scrollTop, db.scrollLeft];
|
---|
879 | } else {
|
---|
880 | return [0, 0];
|
---|
881 | }
|
---|
882 | }
|
---|
883 | };
|
---|
884 | } ();
|
---|
885 |
|
---|
886 | YAHOO.util.Event.on = YAHOO.util.Event.addListener;
|
---|
887 |
|
---|
888 | if (document && document.body) {
|
---|
889 | YAHOO.util.Event._load();
|
---|
890 | } else {
|
---|
891 | YAHOO.util.Event.on(window, "load", YAHOO.util.Event._load,
|
---|
892 | YAHOO.util.Event, true);
|
---|
893 | }
|
---|
894 |
|
---|
895 | YAHOO.util.Event.on(window, "unload", YAHOO.util.Event._unload,
|
---|
896 | YAHOO.util.Event, true);
|
---|
897 |
|
---|
898 | YAHOO.util.Event._tryPreloadAttach();
|
---|
899 |
|
---|
900 | }
|
---|
901 |
|
---|