// Bind an event to an element
// Original by Dean Edwards
- add: function(element, types, handler, data) {
- if ( element.nodeType == 3 || element.nodeType == 8 )
+ add: function(elem, types, handler, data) {
+ if ( elem.nodeType == 3 || elem.nodeType == 8 )
return;
// For whatever reason, IE has trouble passing the window object
// around, causing it to be cloned in the process
- if ( jQuery.browser.msie && element.setInterval != undefined )
- element = window;
+ if ( jQuery.browser.msie && elem.setInterval != undefined )
+ elem = window;
// Make sure that the function being executed has a unique ID
if ( !handler.guid )
}
// Init the element's event structure
- var events = jQuery.data(element, "events") || jQuery.data(element, "events", {}),
- handle = jQuery.data(element, "handle") || jQuery.data(element, "handle", function(){
- // returned undefined or false
- var val;
-
+ var events = jQuery.data(elem, "events") || jQuery.data(elem, "events", {}),
+ handle = jQuery.data(elem, "handle") || jQuery.data(elem, "handle", function(){
// Handle the second event of a trigger and when
// an event is called after a page has unloaded
- if ( typeof jQuery == "undefined" || jQuery.event.triggered )
- return val;
-
- val = jQuery.event.handle.apply(element, arguments);
-
- return val;
+ if ( typeof jQuery != "undefined" && !jQuery.event.triggered )
+ return jQuery.event.handle.apply(arguments.callee.elem, arguments);
});
+ // Add elem as a property of the handle function
+ // This is to prevent a memory leak with non-native
+ // event in IE.
+ handle.elem = elem;
// Handle multiple events seperated by a space
// jQuery(...).bind("mouseover mouseout", fn);
// Check for a special event handler
// Only use addEventListener/attachEvent if the special
// events handler returns false
- if ( !jQuery.event.special[type] || jQuery.event.special[type].setup.call(element) === false ) {
+ if ( !jQuery.event.special[type] || jQuery.event.special[type].setup.call(elem) === false ) {
// Bind the global event handler to the element
- if (element.addEventListener)
- element.addEventListener(type, handle, false);
- else if (element.attachEvent)
- element.attachEvent("on" + type, handle);
+ if (elem.addEventListener)
+ elem.addEventListener(type, handle, false);
+ else if (elem.attachEvent)
+ elem.attachEvent("on" + type, handle);
}
}
// Keep track of which events have been used, for global triggering
jQuery.event.global[type] = true;
});
+
+ // Nullify elem to prevent memory leaks in IE
+ elem = null;
},
guid: 1,
global: {},
// Detach an event or set of events from an element
- remove: function(element, types, handler) {
+ remove: function(elem, types, handler) {
// don't do events on text and comment nodes
- if ( element.nodeType == 3 || element.nodeType == 8 )
+ if ( elem.nodeType == 3 || elem.nodeType == 8 )
return;
- var events = jQuery.data(element, "events"), ret, index;
+ var events = jQuery.data(elem, "events"), ret, index;
if ( events ) {
// Unbind all events for the element
- if ( !types )
+ if ( types == undefined || (typeof types == "string" && types.charAt(0) == ".") )
for ( var type in events )
- this.remove( element, type );
+ this.remove( elem, type + (types || "") );
else {
// types is actually an event object here
if ( types.type ) {
// remove generic event handler if no more handlers exist
for ( ret in events[type] ) break;
if ( !ret ) {
- if ( !jQuery.event.special[type] || jQuery.event.special[type].teardown.call(this, element) === false ) {
- if (element.removeEventListener)
- element.removeEventListener(type, jQuery.data(element, "handle"), false);
- else if (element.detachEvent)
- element.detachEvent("on" + type, jQuery.data(element, "handle"));
+ if ( !jQuery.event.special[type] || jQuery.event.special[type].teardown.call(elem) === false ) {
+ if (elem.removeEventListener)
+ elem.removeEventListener(type, jQuery.data(elem, "handle"), false);
+ else if (elem.detachEvent)
+ elem.detachEvent("on" + type, jQuery.data(elem, "handle"));
}
ret = null;
delete events[type];
// Remove the expando if it's no longer used
for ( ret in events ) break;
if ( !ret ) {
- jQuery.removeData( element, "events" );
- jQuery.removeData( element, "handle" );
+ var handle = jQuery.data( elem, "handle" );
+ if ( handle ) handle.elem = null;
+ jQuery.removeData( elem, "events" );
+ jQuery.removeData( elem, "handle" );
}
}
},
- trigger: function(type, data, element, donative, extra) {
+ trigger: function(type, data, elem, donative, extra) {
// Clone the incoming data, if any
- data = jQuery.makeArray(data || []);
+ data = jQuery.makeArray(data);
+
+ if ( type.indexOf("!") >= 0 ) {
+ type = type.slice(0, -1);
+ var exclusive = true;
+ }
// Handle a global trigger
- if ( !element ) {
+ if ( !elem ) {
// Only trigger if we've ever bound an event for it
if ( this.global[type] )
jQuery("*").add([window, document]).trigger(type, data);
// Handle triggering a single element
} else {
// don't do events on text and comment nodes
- if ( element.nodeType == 3 || element.nodeType == 8 )
- return;
+ if ( elem.nodeType == 3 || elem.nodeType == 8 )
+ return undefined;
- var val, ret, fn = jQuery.isFunction( element[ type ] || null ),
+ var val, ret, fn = jQuery.isFunction( elem[ type ] || null ),
// Check to see if we need to provide a fake event, or not
event = !data[0] || !data[0].preventDefault;
// Pass along a fake event
if ( event )
- data.unshift( this.fix({ type: type, target: element }) );
+ data.unshift( this.fix({ type: type, target: elem }) );
// Enforce the right trigger type
data[0].type = type;
+ if ( exclusive )
+ data[0].exclusive = true;
- // Trigger the event
- if ( jQuery.isFunction( jQuery.data(element, "handle") ) )
- val = jQuery.data(element, "handle").apply( element, data );
+ // Trigger the event, it is assumed that "handle" is a function
+ var handle = jQuery.data(elem, "handle");
+ if ( handle )
+ val = handle.apply( elem, data );
- // Handle triggering native .onfoo handlers
- if ( !fn && element["on"+type] && element["on"+type].apply( element, data ) === false )
+ // Handle triggering native .onfoo handlers (and on links since we don't call .click() for links)
+ if ( (!fn || (jQuery.nodeName(elem, 'a') && type == "click")) && elem["on"+type] && elem["on"+type].apply( elem, data ) === false )
val = false;
// Extra functions don't get the custom event object
data.shift();
// Handle triggering of extra function
- if ( extra ) {
+ if ( extra && jQuery.isFunction( extra ) ) {
// call the extra function and tack the current return value on the end for possible inspection
- var ret = extra.apply( element, data.concat( val ) );
+ ret = extra.apply( elem, val == null ? data : data.concat( val ) );
// if anything is returned, give it precedence and have it overwrite the previous value
if (ret !== undefined)
val = ret;
}
// Trigger the native events (except for clicks on links)
- if ( fn && donative !== false && val !== false && !(jQuery.nodeName(element, 'a') && type == "click") ) {
+ if ( fn && donative !== false && val !== false && !(jQuery.nodeName(elem, 'a') && type == "click") ) {
this.triggered = true;
try {
- element[ type ]();
+ elem[ type ]();
// prevent IE from throwing an error for some hidden elements
} catch (e) {}
}
handle: function(event) {
// returned undefined or false
- var val;
+ var val, ret, namespace, all, handlers;
- // Empty object is for triggered events with no data
- event = jQuery.event.fix( event || window.event || {} );
+ event = arguments[0] = jQuery.event.fix( event || window.event );
// Namespaced event handlers
- var parts = event.type.split(".");
- event.type = parts[0];
+ namespace = event.type.split(".");
+ event.type = namespace[0];
+ namespace = namespace[1];
+ all = !namespace && !event.exclusive; //cache this now, all = true means, any handler
- var handlers = jQuery.data(this, "events") && jQuery.data(this, "events")[event.type], args = Array.prototype.slice.call( arguments, 1 );
- args.unshift( event );
+ handlers = ( jQuery.data(this, "events") || {} )[event.type];
for ( var j in handlers ) {
var handler = handlers[j];
- // Pass in a reference to the handler function itself
- // So that we can later remove it
- args[0].handler = handler;
- args[0].data = handler.data;
// Filter the functions by class
- if ( !parts[1] || handler.type == parts[1] ) {
- var ret = handler.apply( this, args );
+ if ( all || handler.type == namespace ) {
+ // Pass in a reference to the handler function itself
+ // So that we can later remove it
+ event.handler = handler;
+ event.data = handler.data;
+
+ ret = handler.apply( this, arguments );
if ( val !== false )
val = ret;
originalEvent.cancelBubble = true;
};
+ // Fix timeStamp
+ event.timeStamp = event.timeStamp || +new Date;
+
// Fix target property, if necessary
if ( !event.target )
event.target = event.srcElement || document; // Fixes #1925 where srcElement might not be defined either
}
// Add which for key events
- if ( !event.which && (event.charCode || event.keyCode) )
+ if ( !event.which && ((event.charCode || event.charCode === 0) ? event.charCode : event.keyCode) )
event.which = event.charCode || event.keyCode;
// Add metaKey to non-Mac browsers (use ctrl for PC's and Meta for Macs)
special: {
ready: {
setup: function() {
- var handler = jQuery.event.special.ready.handler;
-
- // Mozilla, Opera and webkit nightlies currently support this event
- if ( document.addEventListener )
- // Use the handy event callback
- document.addEventListener( "DOMContentLoaded", handler, false );
-
- // If Safari or IE is used
- // Continually check to see if the document is ready
- if (jQuery.browser.msie || jQuery.browser.safari ) (function(){
- try {
- // If IE is used, use the trick by Diego Perini
- // http://javascript.nwbox.com/IEContentLoaded/
- if ( jQuery.browser.msie || document.readyState != "loaded" && document.readyState != "complete" )
- document.documentElement.doScroll("left");
- } catch( error ) {
- return setTimeout( arguments.callee, 0 );
- }
-
- // and execute any waiting functions
- handler();
- })();
-
- // A fallback to window.onload, that will always work
- jQuery.event.add( window, "load", handler );
+ // Make sure the ready event is setup
+ bindReady();
+ return;
},
- teardown: function() {return;},
-
- handler: function() {
- // Make sure that the DOM is not already loaded
- if ( !jQuery.isReady ) {
- // Remember that the DOM is ready
- jQuery.isReady = true;
- jQuery(document).triggerHandler("ready");
- jQuery(document).unbind("ready");
- }
- }
+ teardown: function() { return; }
},
mouseenter: {
setup: function() {
- if (jQuery.browser.msie) return false;
- jQuery(this).bind('mouseover', jQuery.event.special.mouseenter.handler);
+ if ( jQuery.browser.msie ) return false;
+ jQuery(this).bind("mouseover", jQuery.event.special.mouseenter.handler);
+ return true;
},
teardown: function() {
- if (jQuery.browser.msie) return false;
- jQuery(this).unbind('mouseover', jQuery.event.special.mouseenter.handler);
+ if ( jQuery.browser.msie ) return false;
+ jQuery(this).unbind("mouseover", jQuery.event.special.mouseenter.handler);
+ return true;
},
handler: function(event) {
- var args = Array.prototype.slice.call( arguments, 1 );
// If we actually just moused on to a sub-element, ignore it
- if ( withinElement(event, this) ) return;
+ if ( withinElement(event, this) ) return true;
// Execute the right handlers by setting the event type to mouseenter
- event.type = 'mouseenter';
- // Include the event object as the first argument
- args.unshift(event);
- var val = jQuery.event.handle.apply(this, args);
- return val;
+ arguments[0].type = "mouseenter";
+ return jQuery.event.handle.apply(this, arguments);
}
},
mouseleave: {
setup: function() {
- if (jQuery.browser.msie) return false;
- jQuery(this).bind('mouseout', jQuery.event.special.mouseleave.handler);
+ if ( jQuery.browser.msie ) return false;
+ jQuery(this).bind("mouseout", jQuery.event.special.mouseleave.handler);
+ return true;
},
teardown: function() {
- if (jQuery.browser.msie) return false;
- jQuery(this).unbind('mouseout', jQuery.event.special.mouseleave.handler);
+ if ( jQuery.browser.msie ) return false;
+ jQuery(this).unbind("mouseout", jQuery.event.special.mouseleave.handler);
+ return true;
},
handler: function(event) {
- var args = Array.prototype.slice.call( arguments, 1 );
// If we actually just moused on to a sub-element, ignore it
- if ( withinElement(event, this) ) return false;
+ if ( withinElement(event, this) ) return true;
// Execute the right handlers by setting the event type to mouseleave
- event.type = 'mouseleave';
- // Include the event object as the first argument
- args.unshift(event);
- var val = jQuery.event.handle.apply(this, args);
- return val;
+ arguments[0].type = "mouseleave";
+ return jQuery.event.handle.apply(this, arguments);
}
}
}
triggerHandler: function( type, data, fn ) {
if ( this[0] )
return jQuery.event.trigger( type, data, this[0], false, fn );
+ return undefined;
},
toggle: function() {
hover: function(fnOver, fnOut) {
return this.bind('mouseenter', fnOver).bind('mouseleave', fnOut);
+ },
+
+ ready: function(fn) {
+ // Attach the listeners
+ bindReady();
+
+ // If the DOM is already ready
+ if ( jQuery.isReady )
+ // Execute the function immediately
+ fn.call( document, jQuery );
+
+ // Otherwise, remember the function for later
+ else
+ // Add the function to the wait list
+ jQuery.readyList.push( function() { return fn.call(this, jQuery); } );
+
+ return this;
}
});
jQuery.extend({
- isReady: false
+ isReady: false,
+ readyList: [],
+ // Handle when the DOM is ready
+ ready: function() {
+ // Make sure that the DOM is not already loaded
+ if ( !jQuery.isReady ) {
+ // Remember that the DOM is ready
+ jQuery.isReady = true;
+
+ // If there are functions bound, to execute
+ if ( jQuery.readyList ) {
+ // Execute all of them
+ jQuery.each( jQuery.readyList, function(){
+ this.apply( document );
+ });
+
+ // Reset the list of functions
+ jQuery.readyList = null;
+ }
+
+ // Trigger any bound ready events
+ jQuery(document).triggerHandler("ready");
+ }
+ }
});
-jQuery.each( ("blur,focus,load,ready,resize,scroll,unload,click,dblclick," +
+var readyBound = false;
+
+function bindReady(){
+ if ( readyBound ) return;
+ readyBound = true;
+
+ // Mozilla, Opera (see further below for it) and webkit nightlies currently support this event
+ if ( document.addEventListener && !jQuery.browser.opera)
+ // Use the handy event callback
+ document.addEventListener( "DOMContentLoaded", jQuery.ready, false );
+
+ // If IE is used and is not in a frame
+ // Continually check to see if the document is ready
+ if ( jQuery.browser.msie && window == top ) (function(){
+ if (jQuery.isReady) return;
+ try {
+ // If IE is used, use the trick by Diego Perini
+ // http://javascript.nwbox.com/IEContentLoaded/
+ document.documentElement.doScroll("left");
+ } catch( error ) {
+ setTimeout( arguments.callee, 0 );
+ return;
+ }
+ // and execute any waiting functions
+ jQuery.ready();
+ })();
+
+ if ( jQuery.browser.opera )
+ document.addEventListener( "DOMContentLoaded", function () {
+ if (jQuery.isReady) return;
+ for (var i = 0; i < document.styleSheets.length; i++)
+ if (document.styleSheets[i].disabled) {
+ setTimeout( arguments.callee, 0 );
+ return;
+ }
+ // and execute any waiting functions
+ jQuery.ready();
+ }, false);
+
+ if ( jQuery.browser.safari ) {
+ var numStyles;
+ (function(){
+ if (jQuery.isReady) return;
+ if ( document.readyState != "loaded" && document.readyState != "complete" ) {
+ setTimeout( arguments.callee, 0 );
+ return;
+ }
+ if ( numStyles === undefined )
+ numStyles = jQuery("style, link[rel=stylesheet]").length;
+ if ( document.styleSheets.length != numStyles ) {
+ setTimeout( arguments.callee, 0 );
+ return;
+ }
+ // and execute any waiting functions
+ jQuery.ready();
+ })();
+ }
+
+ // A fallback to window.onload, that will always work
+ jQuery.event.add( window, "load", jQuery.ready );
+}
+
+jQuery.each( ("blur,focus,load,resize,scroll,unload,click,dblclick," +
"mousedown,mouseup,mousemove,mouseover,mouseout,change,select," +
"submit,keydown,keypress,keyup,error").split(","), function(i, name){
// Checks if an event happened on an element within another element
// Used in jQuery.event.special.mouseenter and mouseleave handlers
-var withinElement = function(event, element) {
+var withinElement = function(event, elem) {
// Check if mouse(over|out) are still within the same parent element
var parent = event.relatedTarget;
// Traverse up the tree
- while ( parent && parent != element ) try { parent = parent.parentNode } catch(error) { parent = element; };
+ while ( parent && parent != elem ) try { parent = parent.parentNode; } catch(error) { parent = elem; }
// Return true if we actually just moused on to a sub-element
- return parent == element;
+ return parent == elem;
};
// Prevent memory leaks in IE