oqapi/webgui
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
webgui/www/extras/yui/build/event/event.js
JT Smith 4f68a0933c added YUI and YUI-ext 
fixed the resizable text area with IE problem
fixed the ad space with IE problem
merged the 7.2.0 and 7.1.4 change logs
2006-11-07 23:15:57 +00:00

1326 lines
46 KiB
JavaScript
Raw Blame History

/*
Copyright (c) 2006, Yahoo! Inc. All rights reserved.
Code licensed under the BSD License:
http://developer.yahoo.net/yui/license.txt
Version: 0.11.4
*/
/**
* The CustomEvent class lets you define events for your application
* that can be subscribed to by one or more independent component.
*
* @param {String} type The type of event, which is passed to the callback
* when the event fires
* @param {Object} oScope The context the event will fire from. "this" will
* refer to this object in the callback. Default value:
* the window object. The listener can override this.
* @param {boolean} silent pass true to prevent the event from writing to
* the log system
* @namespace YAHOO.util
* @class CustomEvent
* @constructor
*/
YAHOO.util.CustomEvent = function(type, oScope, silent) {
/**
* The type of event, returned to subscribers when the event fires
* @property type
* @type string
*/
this.type = type;
/**
* The scope the the event will fire from by default. Defaults to the window
* obj
* @property scope
* @type object
*/
this.scope = oScope || window;
/**
* By default all custom events are logged in the debug build, set silent
* to true to disable logging for this event.
* @property silent
* @type boolean
*/
this.silent = silent;
/**
* The subscribers to this event
* @property subscribers
* @type Subscriber[]
*/
this.subscribers = [];
if (!this.silent) {
}
// Only add subscribe events for events that are not generated by CustomEvent
//if (oScope && (oScope.constructor != this.constructor)) {
/*
* Custom events provide a custom event that fires whenever there is
* a new subscriber to the event. This provides an opportunity to
* handle the case where there is a non-repeating event that has
* already fired has a new subscriber.
*
* type CustomEvent
*/
//this.subscribeEvent =
//new YAHOO.util.CustomEvent("subscribe", this, true);
//}
};
YAHOO.util.CustomEvent.prototype = {
/**
* Subscribes the caller to this event
* @method subscribe
* @param {Function} fn The function to execute
* @param {Object} obj An object to be passed along when the event fires
* @param {boolean} bOverride If true, the obj passed in becomes the execution
* scope of the listener
*/
subscribe: function(fn, obj, bOverride) {
//if (this.subscribeEvent) {
//this.subscribeEvent.fire(fn, obj, bOverride);
//}
this.subscribers.push( new YAHOO.util.Subscriber(fn, obj, bOverride) );
},
/**
* Unsubscribes the caller from this event
* @method unsubscribe
* @param {Function} fn The function to execute
* @param {Object} obj An object to be passed along when the event fires
* @return {boolean} True if the subscriber was found and detached.
*/
unsubscribe: function(fn, obj) {
var found = false;
for (var i=0, len=this.subscribers.length; i<len; ++i) {
var s = this.subscribers[i];
if (s && s.contains(fn, obj)) {
this._delete(i);
found = true;
}
}
return found;
},
/**
* Notifies the subscribers. The callback functions will be executed
* from the scope specified when the event was created, and with the following
* parameters:
* <pre>
* - The type of event
* - All of the arguments fire() was executed with as an array
* - The custom object (if any) that was passed into the subscribe() method
* </pre>
* @method fire
* @param {Array} an arbitrary set of parameters to pass to the handler
*/
fire: function() {
var len=this.subscribers.length;
if (!len && this.silent) {
return;
}
var args = [];
for (var i=0; i<arguments.length; ++i) {
args.push(arguments[i]);
}
if (!this.silent) {
}
for (i=0; i<len; ++i) {
var s = this.subscribers[i];
if (s) {
if (!this.silent) {
}
var scope = (s.override) ? s.obj : this.scope;
s.fn.call(scope, this.type, args, s.obj);
}
}
},
/**
* Removes all listeners
* @method unsubscribeAll
*/
unsubscribeAll: function() {
for (var i=0, len=this.subscribers.length; i<len; ++i) {
this._delete(len - 1 - i);
}
},
/**
* @method _delete
* @private
*/
_delete: function(index) {
var s = this.subscribers[index];
if (s) {
delete s.fn;
delete s.obj;
}
// delete this.subscribers[index];
this.subscribers.splice(index, 1);
},
/**
* @method toString
*/
toString: function() {
return "CustomEvent: " + "'" + this.type + "', " +
"scope: " + this.scope;
}
};
/////////////////////////////////////////////////////////////////////
/**
* Stores the subscriber information to be used when the event fires.
* @param {Function} fn The function to execute
* @param {Object} obj An object to be passed along when the event fires
* @param {boolean} bOverride If true, the obj passed in becomes the execution
* scope of the listener
* @class Subscriber
* @constructor
*/
YAHOO.util.Subscriber = function(fn, obj, bOverride) {
/**
* The callback that will be execute when the event fires
* @property fn
* @type function
*/
this.fn = fn;
/**
* An optional custom object that will passed to the callback when
* the event fires
* @property obj
* @type object
*/
this.obj = obj || null;
/**
* The default execution scope for the event listener is defined when the
* event is created (usually the object which contains the event).
* By setting override to true, the execution scope becomes the custom
* object passed in by the subscriber
* @property override
* @type boolean
*/
this.override = (bOverride);
};
/**
* Returns true if the fn and obj match this objects properties.
* Used by the unsubscribe method to match the right subscriber.
*
* @method contains
* @param {Function} fn the function to execute
* @param {Object} obj an object to be passed along when the event fires
* @return {boolean} true if the supplied arguments match this
* subscriber's signature.
*/
YAHOO.util.Subscriber.prototype.contains = function(fn, obj) {
return (this.fn == fn && this.obj == obj);
};
/**
* @method toString
*/
YAHOO.util.Subscriber.prototype.toString = function() {
return "Subscriber { obj: " + (this.obj || "") +
", override: " + (this.override || "no") + " }";
};
// The first instance of Event will win if it is loaded more than once.
if (!YAHOO.util.Event) {
/**
* The event utility provides functions to add and remove event listeners,
* event cleansing. It also tries to automatically remove listeners it
* registers during the unload event.
* @namespace YAHOO.util
* @class Event
*/
YAHOO.util.Event = function() {
/**
* True after the onload event has fired
* @property loadComplete
* @type boolean
* @private
*/
var loadComplete = false;
/**
* Cache of wrapped listeners
* @property listeners
* @type array
* @private
*/
var listeners = [];
/**
* Listeners that will be attached during the onload event
* @property delayedListeners
* @type array
* @private
*/
var delayedListeners = [];
/**
* User-defined unload function that will be fired before all events
* are detached
* @property unloadListeners
* @type array
* @private
*/
var unloadListeners = [];
/**
* Cache of DOM0 event handlers to work around issues with DOM2 events
* in Safari
* @property legacyEvents
* @private
*/
var legacyEvents = [];
/**
* Listener stack for DOM0 events
* @property legacyHandlers
* @private
*/
var legacyHandlers = [];
/**
* The number of times to poll after window.onload. This number is
* increased if additional late-bound handlers are requested after
* the page load.
* @property retryCount
* @private
*/
var retryCount = 0;
/**
* onAvailable listeners
* @property onAvailStack
* @private
*/
var onAvailStack = [];
/**
* Lookup table for legacy events
* @property legacyMap
* @private
*/
var legacyMap = [];
/**
* Counter for auto id generation
* @property counter
* @private
*/
var counter = 0;
return { // PREPROCESS
/**
* The number of times we should look for elements that are not
* in the DOM at the time the event is requested after the document
* has been loaded. The default is 200@amp;50 ms, so it will poll
* for 10 seconds or until all outstanding handlers are bound
* (whichever comes first).
* @property POLL_RETRYS
* @type int
*/
POLL_RETRYS: 200,
/**
* The poll interval in milliseconds
* @property POLL_INTERVAL
* @type int
*/
POLL_INTERVAL: 50,
/**
* Element to bind, int constant
* @property EL
* @type int
*/
EL: 0,
/**
* Type of event, int constant
* @property TYPE
* @type int
*/
TYPE: 1,
/**
* Function to execute, int constant
* @property FN
* @type int
*/
FN: 2,
/**
* Function wrapped for scope correction and cleanup, int constant
* @property WFN
* @type int
*/
WFN: 3,
/**
* Object passed in by the user that will be returned as a
* parameter to the callback, int constant
* @property SCOPE
* @type int
*/
SCOPE: 3,
/**
* Adjusted scope, either the element we are registering the event
* on or the custom object passed in by the listener, int constant
* @property ADJ_SCOPE
* @type int
*/
ADJ_SCOPE: 4,
/**
* Safari detection is necessary to work around the preventDefault
* bug that makes it so you can't cancel a href click from the
* handler. There is not a capabilities check we can use here.
* @property isSafari
* @private
*/
isSafari: (/Safari|Konqueror|KHTML/gi).test(navigator.userAgent),
/**
* IE detection needed to properly calculate pageX and pageY.
* capabilities checking didn't seem to work because another
* browser that does not provide the properties have the values
* calculated in a different manner than IE.
* @property isIE
* @private
*/
isIE: (!this.isSafari && !navigator.userAgent.match(/opera/gi) &&
navigator.userAgent.match(/msie/gi)),
/**
* @method addDelayedListener
* @private
*/
addDelayedListener: function(el, sType, fn, oScope, bOverride) {
delayedListeners[delayedListeners.length] =
[el, sType, fn, oScope, bOverride];
// If this happens after the inital page load, we need to
// reset the poll counter so that we continue to search for
// the element for a fixed period of time.
if (loadComplete) {
retryCount = this.POLL_RETRYS;
this.startTimeout(0);
// this._tryPreloadAttach();
}
},
/**
* @method startTimeout
* @private
*/
startTimeout: function(interval) {
var i = (interval || interval === 0) ? interval : this.POLL_INTERVAL;
var self = this;
var callback = function() { self._tryPreloadAttach(); };
this.timeout = setTimeout(callback, i);
},
/**
* Executes the supplied callback when the item with the supplied
* id is found. This is meant to be used to execute behavior as
* soon as possible as the page loads. If you use this after the
* initial page load it will poll for a fixed time for the element.
* The number of times it will poll and the frequency are
* configurable. By default it will poll for 10 seconds.
*
* @method onAvailable
*
* @param {string} p_id the id of the element to look for.
* @param {function} p_fn what to execute when the element is found.
* @param {object} p_obj an optional object to be passed back as
* a parameter to p_fn.
* @param {boolean} p_override If set to true, p_fn will execute
* in the scope of p_obj
*
*/
onAvailable: function(p_id, p_fn, p_obj, p_override) {
onAvailStack.push( { id: p_id,
fn: p_fn,
obj: p_obj,
override: p_override } );
retryCount = this.POLL_RETRYS;
this.startTimeout(0);
// this._tryPreloadAttach();
},
/**
* Appends an event handler
*
* @method addListener
*
* @param {Object} el The html element to assign the
* event to
* @param {String} sType The type of event to append
* @param {Function} fn The method the event invokes
* @param {Object} oScope An arbitrary object that will be
* passed as a parameter to the handler
* @param {boolean} bOverride If true, the obj passed in becomes
* the execution scope of the listener
* @return {boolean} True if the action was successful or defered,
* false if one or more of the elements
* could not have the event bound to it.
*/
addListener: function(el, sType, fn, oScope, bOverride) {
if (!fn || !fn.call) {
return false;
}
// The el argument can be an array of elements or element ids.
if ( this._isValidCollection(el)) {
var ok = true;
for (var i=0,len=el.length; i<len; ++i) {
ok = ( this.on(el[i],
sType,
fn,
oScope,
bOverride) && ok );
}
return ok;
} else if (typeof el == "string") {
var oEl = this.getEl(el);
// If the el argument is a string, we assume it is
// actually the id of the element. If the page is loaded
// we convert el to the actual element, otherwise we
// defer attaching the event until onload event fires
// check to see if we need to delay hooking up the event
// until after the page loads.
if (loadComplete && oEl) {
el = oEl;
} else {
// defer adding the event until onload fires
this.addDelayedListener(el,
sType,
fn,
oScope,
bOverride);
return true;
}
}
// Element should be an html element or an array if we get
// here.
if (!el) {
return false;
}
// we need to make sure we fire registered unload events
// prior to automatically unhooking them. So we hang on to
// these instead of attaching them to the window and fire the
// handles explicitly during our one unload event.
if ("unload" == sType && oScope !== this) {
unloadListeners[unloadListeners.length] =
[el, sType, fn, oScope, bOverride];
return true;
}
// if the user chooses to override the scope, we use the custom
// object passed in, otherwise the executing scope will be the
// HTML element that the event is registered on
var scope = (bOverride) ? oScope : el;
// wrap the function so we can return the oScope object when
// the event fires;
var wrappedFn = function(e) {
return fn.call(scope, YAHOO.util.Event.getEvent(e),
oScope);
};
var li = [el, sType, fn, wrappedFn, scope];
var index = listeners.length;
// cache the listener so we can try to automatically unload
listeners[index] = li;
if (this.useLegacyEvent(el, sType)) {
var legacyIndex = this.getLegacyIndex(el, sType);
// Add a new dom0 wrapper if one is not detected for this
// element
if ( legacyIndex == -1 ||
el != legacyEvents[legacyIndex][0] ) {
legacyIndex = legacyEvents.length;
legacyMap[el.id + sType] = legacyIndex;
// cache the signature for the DOM0 event, and
// include the existing handler for the event, if any
legacyEvents[legacyIndex] =
[el, sType, el["on" + sType]];
legacyHandlers[legacyIndex] = [];
el["on" + sType] =
function(e) {
YAHOO.util.Event.fireLegacyEvent(
YAHOO.util.Event.getEvent(e), legacyIndex);
};
}
// add a reference to the wrapped listener to our custom
// stack of events
//legacyHandlers[legacyIndex].push(index);
legacyHandlers[legacyIndex].push(li);
// DOM2 Event model
} else if (el.addEventListener) {
el.addEventListener(sType, wrappedFn, false);
// IE
} else if (el.attachEvent) {
el.attachEvent("on" + sType, wrappedFn);
}
return true;
},
/**
* When using legacy events, the handler is routed to this object
* so we can fire our custom listener stack.
* @method fireLegacyEvent
* @private
*/
fireLegacyEvent: function(e, legacyIndex) {
var ok = true;
var le = legacyHandlers[legacyIndex];
for (var i=0,len=le.length; i<len; ++i) {
var li = le[i];
if ( li && li[this.WFN] ) {
var scope = li[this.ADJ_SCOPE];
var ret = li[this.WFN].call(scope, e);
ok = (ok && ret);
}
}
return ok;
},
/**
* Returns the legacy event index that matches the supplied
* signature
* @method getLegacyIndex
* @private
*/
getLegacyIndex: function(el, sType) {
var key = this.generateId(el) + sType;
if (typeof legacyMap[key] == "undefined") {
return -1;
} else {
return legacyMap[key];
}
},
/**
* Logic that determines when we should automatically use legacy
* events instead of DOM2 events.
* @method useLegacyEvent
* @private
*/
useLegacyEvent: function(el, sType) {
if (!el.addEventListener && !el.attachEvent) {
return true;
} else if (this.isSafari) {
if ("click" == sType || "dblclick" == sType) {
return true;
}
}
return false;
},
/**
* Removes an event handler
*
* @method removeListener
*
* @param {Object} el the html element or the id of the element to
* assign the event to.
* @param {String} sType the type of event to remove
* @param {Function} fn the method the event invokes
* @return {boolean} true if the unbind was successful, false
* otherwise
*/
removeListener: function(el, sType, fn, index) {
if (!fn || !fn.call) {
return false;
}
var i, len;
// The el argument can be a string
if (typeof el == "string") {
el = this.getEl(el);
// The el argument can be an array of elements or element ids.
} else if ( this._isValidCollection(el)) {
var ok = true;
for (i=0,len=el.length; i<len; ++i) {
ok = ( this.removeListener(el[i], sType, fn) && ok );
}
return ok;
}
if ("unload" == sType) {
for (i=0, len=unloadListeners.length; i<len; i++) {
var li = unloadListeners[i];
if (li &&
li[0] == el &&
li[1] == sType &&
li[2] == fn) {
unloadListeners.splice(i, 1);
return true;
}
}
return false;
}
var cacheItem = null;
//var index = arguments[3];
if ("undefined" == typeof index) {
index = this._getCacheIndex(el, sType, fn);
}
if (index >= 0) {
cacheItem = listeners[index];
}
if (!el || !cacheItem) {
return false;
}
if (this.useLegacyEvent(el, sType)) {
var legacyIndex = this.getLegacyIndex(el, sType);
var llist = legacyHandlers[legacyIndex];
if (llist) {
for (i=0, len=llist.length; i<len; ++i) {
li = llist[i];
if (li &&
li[this.EL] == el &&
li[this.TYPE] == sType &&
li[this.FN] == fn) {
llist.splice(i, 1);
}
}
}
} else if (el.removeEventListener) {
el.removeEventListener(sType, cacheItem[this.WFN], false);
} else if (el.detachEvent) {
el.detachEvent("on" + sType, cacheItem[this.WFN]);
}
// removed the wrapped handler
delete listeners[index][this.WFN];
delete listeners[index][this.FN];
listeners.splice(index, 1);
return true;
},
/**
* Returns the event's target element
* @method getTarget
* @param {Event} ev the event
* @param {boolean} resolveTextNode when set to true the target's
* parent will be returned if the target is a
* text node. @deprecated, the text node is
* now resolved automatically
* @return {HTMLElement} the event's target
*/
getTarget: function(ev, resolveTextNode) {
var t = ev.target || ev.srcElement;
return this.resolveTextNode(t);
},
/**
* In some cases, some browsers will return a text node inside
* the actual element that was targeted. This normalizes the
* return value for getTarget and getRelatedTarget.
* @method resolveTextNode
* @param {HTMLElement} node to resolve
* @return the normized node
*/
resolveTextNode: function(node) {
if (node && node.nodeName &&
"#TEXT" == node.nodeName.toUpperCase()) {
return node.parentNode;
} else {
return node;
}
},
/**
* Returns the event's pageX
* @method getPageX
* @param {Event} ev the event
* @return {int} the event's pageX
*/
getPageX: function(ev) {
var x = ev.pageX;
if (!x && 0 !== x) {
x = ev.clientX || 0;
if ( this.isIE ) {
x += this._getScrollLeft();
}
}
return x;
},
/**
* Returns the event's pageY
* @method getPageY
* @param {Event} ev the event
* @return {int} the event's pageY
*/
getPageY: function(ev) {
var y = ev.pageY;
if (!y && 0 !== y) {
y = ev.clientY || 0;
if ( this.isIE ) {
y += this._getScrollTop();
}
}
return y;
},
/**
* Returns the pageX and pageY properties as an indexed array.
* @method getXY
* @type int[]
*/
getXY: function(ev) {
return [this.getPageX(ev), this.getPageY(ev)];
},
/**
* Returns the event's related target
* @method getRelatedTarget
* @param {Event} ev the event
* @return {HTMLElement} the event's relatedTarget
*/
getRelatedTarget: function(ev) {
var t = ev.relatedTarget;
if (!t) {
if (ev.type == "mouseout") {
t = ev.toElement;
} else if (ev.type == "mouseover") {
t = ev.fromElement;
}
}
return this.resolveTextNode(t);
},
/**
* Returns the time of the event. If the time is not included, the
* event is modified using the current time.
* @method getTime
* @param {Event} ev the event
* @return {Date} the time of the event
*/
getTime: function(ev) {
if (!ev.time) {
var t = new Date().getTime();
try {
ev.time = t;
} catch(e) {
// can't set the time property
return t;
}
}
return ev.time;
},
/**
* Convenience method for stopPropagation + preventDefault
* @method stopEvent
* @param {Event} ev the event
*/
stopEvent: function(ev) {
this.stopPropagation(ev);
this.preventDefault(ev);
},
/**
* Stops event propagation
* @method stopPropagation
* @param {Event} ev the event
*/
stopPropagation: function(ev) {
if (ev.stopPropagation) {
ev.stopPropagation();
} else {
ev.cancelBubble = true;
}
},
/**
* Prevents the default behavior of the event
* @method preventDefault
* @param {Event} ev the event
*/
preventDefault: function(ev) {
if (ev.preventDefault) {
ev.preventDefault();
} else {
ev.returnValue = false;
}
},
/**
* Finds the event in the window object, the caller's arguments, or
* in the arguments of another method in the callstack. This is
* executed automatically for events registered through the event
* manager, so the implementer should not normally need to execute
* this function at all.
* @method getEvent
* @param {Event} the event parameter from the handler
* @return {Event} the event
*/
getEvent: function(e) {
var ev = e || window.event;
if (!ev) {
var c = this.getEvent.caller;
while (c) {
ev = c.arguments[0];
if (ev && Event == ev.constructor) {
break;
}
c = c.caller;
}
}
return ev;
},
/**
* Returns the charcode for an event
* @method getCharCode
* @param {Event} ev the event
* @return {int} the event's charCode
*/
getCharCode: function(ev) {
return ev.charCode || ((ev.type == "keypress") ? ev.keyCode : 0);
},
/**
* Locating the saved event handler data by function ref
*
* @method _getCacheIndex
* @private
*/
_getCacheIndex: function(el, sType, fn) {
for (var i=0,len=listeners.length; i<len; ++i) {
var li = listeners[i];
if ( li &&
li[this.FN] == fn &&
li[this.EL] == el &&
li[this.TYPE] == sType ) {
return i;
}
}
return -1;
},
/**
* Generates an unique ID for the element if it does not already
* have one.
* @method generateId
* @param el the element
* @return {string} the id of the element
*/
generateId: function(el) {
var id = el.id;
if (!id) {
id = "yuievtautoid-" + counter;
++counter;
el.id = id;
}
return id;
},
/**
* We want to be able to use getElementsByTagName as a collection
* to attach a group of events to. Unfortunately, different
* browsers return different types of collections. This function
* tests to determine if the object is array-like. It will also
* fail if the object is an array, but is empty.
* @method _isValidCollection
* @param o the object to test
* @return {boolean} true if the object is array-like and populated
* @private
*/
_isValidCollection: function(o) {
return ( o && // o is something
o.length && // o is indexed
typeof o != "string" && // o is not a string
!o.tagName && // o is not an HTML element
!o.alert && // o is not a window
typeof o[0] != "undefined" );
},
/**
* @private
* @property elCache
* DOM element cache
*/
elCache: {},
/**
* We cache elements bound by id because when the unload event
* fires, we can no longer use document.getElementById
* @method getEl
* @private
*/
getEl: function(id) {
return document.getElementById(id);
},
/**
* Clears the element cache
* @deprecated
* @private
*/
clearCache: function() { },
/**
* hook up any deferred listeners
* @method _load
* @private
*/
_load: function(e) {
loadComplete = true;
var EU = YAHOO.util.Event;
EU._simpleRemove(window, "load", EU._load);
},
/**
* Polling function that runs before the onload event fires,
* attempting to attach to DOM Nodes as soon as they are
* available
* @method _tryPreloadAttach
* @private
*/
_tryPreloadAttach: function() {
if (this.locked) {
return false;
}
this.locked = true;
// keep trying until after the page is loaded. We need to
// check the page load state prior to trying to bind the
// elements so that we can be certain all elements have been
// tested appropriately
var tryAgain = !loadComplete;
if (!tryAgain) {
tryAgain = (retryCount > 0);
}
// Delayed listeners
var stillDelayed = [];
for (var i=0,len=delayedListeners.length; i<len; ++i) {
var d = delayedListeners[i];
// There may be a race condition here, so we need to
// verify the array element is usable.
if (d) {
// el will be null if document.getElementById did not
// work
var el = this.getEl(d[this.EL]);
if (el) {
this.on(el, d[this.TYPE], d[this.FN],
d[this.SCOPE], d[this.ADJ_SCOPE]);
delete delayedListeners[i];
} else {
stillDelayed.push(d);
}
}
}
delayedListeners = stillDelayed;
// onAvailable
var notAvail = [];
for (i=0,len=onAvailStack.length; i<len ; ++i) {
var item = onAvailStack[i];
if (item) {
el = this.getEl(item.id);
if (el) {
var scope = (item.override) ? item.obj : el;
item.fn.call(scope, item.obj);
delete onAvailStack[i];
} else {
notAvail.push(item);
}
}
}
retryCount = (stillDelayed.length === 0 &&
notAvail.length === 0) ? 0 : retryCount - 1;
if (tryAgain) {
this.startTimeout();
}
this.locked = false;
return true;
},
/**
* Removes all listeners attached to the given element via addListener.
* Optionally, the node's children can also be purged.
* Optionally, you can specify a specific type of event to remove.
* @method purgeElement
* @param {HTMLElement} el the element to purge
* @param {boolean} recurse recursively purge this element's children
* as well. Use with caution.
* @param {string} sType optional type of listener to purge. If
* left out, all listeners will be removed
*/
purgeElement: function(el, recurse, sType) {
var elListeners = this.getListeners(el, sType);
if (elListeners) {
for (var i=0,len=elListeners.length; i<len ; ++i) {
var l = elListeners[i];
// can't use the index on the changing collection
//this.removeListener(el, l.type, l.fn, l.index);
this.removeListener(el, l.type, l.fn);
}
}
if (recurse && el && el.childNodes) {
for (i=0,len=el.childNodes.length; i<len ; ++i) {
this.purgeElement(el.childNodes[i], recurse, sType);
}
}
},
/**
* Returns all listeners attached to the given element via addListener.
* Optionally, you can specify a specific type of event to return.
* @method getListeners
* @param el {HTMLElement} the element to inspect
* @param sType {string} optional type of listener to return. If
* left out, all listeners will be returned
* @return {Object} the listener. Contains the following fields:
* type: (string) the type of event
* fn: (function) the callback supplied to addListener
* obj: (object) the custom object supplied to addListener
* adjust: (boolean) whether or not to adjust the default scope
* index: (int) its position in the Event util listener cache
*/
getListeners: function(el, sType) {
var elListeners = [];
if (listeners && listeners.length > 0) {
for (var i=0,len=listeners.length; i<len ; ++i) {
var l = listeners[i];
if ( l && l[this.EL] === el &&
(!sType || sType === l[this.TYPE]) ) {
elListeners.push({
type: l[this.TYPE],
fn: l[this.FN],
obj: l[this.SCOPE],
adjust: l[this.ADJ_SCOPE],
index: i
});
}
}
}
return (elListeners.length) ? elListeners : null;
},
/**
* Removes all listeners registered by pe.event. Called
* automatically during the unload event.
* @method _unload
* @private
*/
_unload: function(e) {
var EU = YAHOO.util.Event;
for (var i=0,len=unloadListeners.length; i<len; ++i) {
var l = unloadListeners[i];
if (l) {
var scope = (l[EU.ADJ_SCOPE]) ? l[EU.SCOPE]: window;
l[EU.FN].call(scope, EU.getEvent(e), l[EU.SCOPE] );
delete unloadListeners[i];
l=null;
}
}
if (listeners && listeners.length > 0) {
//for (i=0,len=listeners.length; i<len ; ++i) {
var j = listeners.length;
while (j) {
var index = j-1;
l = listeners[index];
if (l) {
EU.removeListener(l[EU.EL], l[EU.TYPE],
l[EU.FN], index);
}
l=null;
j = j - 1;
}
EU.clearCache();
}
for (i=0,len=legacyEvents.length; i<len; ++i) {
// dereference the element
delete legacyEvents[i][0];
// delete the array item
delete legacyEvents[i];
}
EU._simpleRemove(window, "unload", EU._unload);
},
/**
* Returns scrollLeft
* @method _getScrollLeft
* @private
*/
_getScrollLeft: function() {
return this._getScroll()[1];
},
/**
* Returns scrollTop
* @method _getScrollTop
* @private
*/
_getScrollTop: function() {
return this._getScroll()[0];
},
/**
* Returns the scrollTop and scrollLeft. Used to calculate the
* pageX and pageY in Internet Explorer
* @method _getScroll
* @private
*/
_getScroll: function() {
var dd = document.documentElement, db = document.body;
if (dd && (dd.scrollTop || dd.scrollLeft)) {
return [dd.scrollTop, dd.scrollLeft];
} else if (db) {
return [db.scrollTop, db.scrollLeft];
} else {
return [0, 0];
}
},
/**
* Adds a DOM event directly without the caching, cleanup, scope adj, etc
*
* @param el the elment to bind the handler to
* @param {string} sType the type of event handler
* @param {function} fn the callback to invoke
* @param {boolen} capture or bubble phase
* @private
*/
_simpleAdd: function (el, sType, fn, capture) {
if (el.addEventListener) {
el.addEventListener(sType, fn, (capture));
} else if (el.attachEvent) {
el.attachEvent("on" + sType, fn);
}
},
/**
* Basic remove listener
*
* @param el the elment to bind the handler to
* @param {string} sType the type of event handler
* @param {function} fn the callback to invoke
* @param {boolen} capture or bubble phase
* @private
*/
_simpleRemove: function (el, sType, fn, capture) {
if (el.removeEventListener) {
el.removeEventListener(sType, fn, (capture));
} else if (el.detachEvent) {
el.detachEvent("on" + sType, fn);
}
}
};
} ();
/**
* YAHOO.util.Event.on is an alias for addListener
* @method on
* @see addListener
*/
YAHOO.util.Event.on = YAHOO.util.Event.addListener;
if (document && document.body) {
YAHOO.util.Event._load();
} else {
YAHOO.util.Event._simpleAdd(window, "load", YAHOO.util.Event._load);
}
YAHOO.util.Event._simpleAdd(window, "unload", YAHOO.util.Event._unload);
YAHOO.util.Event._tryPreloadAttach();
}
Reference in a new issue View git blame Copy permalink