2 * A number of helper functions used for managing events.
3 * Many of the ideas behind this code orignated from
4 * Dean Edwards' addEvent library.
8 // Bind an event to an element
9 // Original by Dean Edwards
10 add: function(element, type, handler, data) {
11 // For whatever reason, IE has trouble passing the window object
12 // around, causing it to be cloned in the process
13 if ( jQuery.browser.msie && element.setInterval != undefined )
16 // Make sure that the function being executed has a unique ID
18 handler.guid = this.guid++;
20 // if data is passed, bind to handler
21 if( data != undefined ) {
22 // Create temporary function pointer to original handler
25 // Create unique handler function, wrapped around original handler
26 handler = function() {
27 // Pass arguments and context to original handler
28 return fn.apply(this, arguments);
31 // Store data in unique handler
34 // Set the guid of unique handler to the same of original handler, so it can be removed
35 handler.guid = fn.guid;
38 // Namespaced event handlers
39 var parts = type.split(".");
41 handler.type = parts[1];
43 // Init the element's event structure
44 var events = jQuery.data(element, "events") || jQuery.data(element, "events", {});
46 var handle = jQuery.data(element, "handle", function(){
47 // returned undefined or false
50 // Handle the second event of a trigger and when
51 // an event is called after a page has unloaded
52 if ( typeof jQuery == "undefined" || jQuery.event.triggered )
55 val = jQuery.event.handle.apply(element, arguments);
60 // Get the current list of functions bound to this event
61 var handlers = events[type];
63 // Init the event handler queue
65 handlers = events[type] = {};
67 // And bind the global event handler to the element
68 if (element.addEventListener)
69 element.addEventListener(type, handle, false);
71 element.attachEvent("on" + type, handle);
74 // Add the function to the element's handler list
75 handlers[handler.guid] = handler;
77 // Keep track of which events have been used, for global triggering
78 this.global[type] = true;
84 // Detach an event or set of events from an element
85 remove: function(element, type, handler) {
86 var events = jQuery.data(element, "events"), ret, index;
88 // Namespaced event handlers
89 if ( typeof type == "string" ) {
90 var parts = type.split(".");
95 // type is actually an event object here
96 if ( type && type.type ) {
97 handler = type.handler;
102 for ( type in events )
103 this.remove( element, type );
105 } else if ( events[type] ) {
106 // remove the given handler for the given type
108 delete events[type][handler.guid];
110 // remove all handlers for the given type
112 for ( handler in events[type] )
113 // Handle the removal of namespaced events
114 if ( !parts[1] || events[type][handler].type == parts[1] )
115 delete events[type][handler];
117 // remove generic event handler if no more handlers exist
118 for ( ret in events[type] ) break;
120 if (element.removeEventListener)
121 element.removeEventListener(type, jQuery.data(element, "handle"), false);
123 element.detachEvent("on" + type, jQuery.data(element, "handle"));
129 // Remove the expando if it's no longer used
130 for ( ret in events ) break;
132 jQuery.removeData( element, "events" );
133 jQuery.removeData( element, "handle" );
138 trigger: function(type, data, element, donative, extra) {
139 // Clone the incoming data, if any
140 data = jQuery.makeArray(data || []);
142 // Handle a global trigger
144 // Only trigger if we've ever bound an event for it
145 if ( this.global[type] )
146 jQuery("*").add([window, document]).trigger(type, data);
148 // Handle triggering a single element
150 var val, ret, fn = jQuery.isFunction( element[ type ] || null ),
151 // Check to see if we need to provide a fake event, or not
152 evt = !data[0] || !data[0].preventDefault;
154 // Pass along a fake event
156 data.unshift( this.fix({ type: type, target: element }) );
158 // Enforce the right trigger type
162 if ( jQuery.isFunction( jQuery.data(element, "handle") ) )
163 val = jQuery.data(element, "handle").apply( element, data );
165 // Handle triggering native .onfoo handlers
166 if ( !fn && element["on"+type] && element["on"+type].apply( element, data ) === false )
169 // Extra functions don't get the custom event object
173 // Handle triggering of extra function
174 if ( extra && extra.apply( element, data ) === false )
177 // Trigger the native events (except for clicks on links)
178 if ( fn && donative !== false && val !== false && !(jQuery.nodeName(element, 'a') && type == "click") ) {
179 this.triggered = true;
183 this.triggered = false;
189 handle: function(event) {
190 // returned undefined or false
193 // Empty object is for triggered events with no data
194 event = jQuery.event.fix( event || window.event || {} );
196 // Namespaced event handlers
197 var parts = event.type.split(".");
198 event.type = parts[0];
200 var c = jQuery.data(this, "events") && jQuery.data(this, "events")[event.type], args = Array.prototype.slice.call( arguments, 1 );
201 args.unshift( event );
204 // Pass in a reference to the handler function itself
205 // So that we can later remove it
206 args[0].handler = c[j];
207 args[0].data = c[j].data;
209 // Filter the functions by class
210 if ( !parts[1] || c[j].type == parts[1] ) {
211 var tmp = c[j].apply( this, args );
216 if ( tmp === false ) {
217 event.preventDefault();
218 event.stopPropagation();
223 // Clean up added properties in IE to prevent memory leak
224 if (jQuery.browser.msie)
225 event.target = event.preventDefault = event.stopPropagation =
226 event.handler = event.data = null;
231 fix: function(event) {
232 // store a copy of the original event object
233 // and clone to set read-only properties
234 var originalEvent = event;
235 event = jQuery.extend({}, originalEvent);
237 // add preventDefault and stopPropagation since
238 // they will not work on the clone
239 event.preventDefault = function() {
240 // if preventDefault exists run it on the original event
241 if (originalEvent.preventDefault)
242 originalEvent.preventDefault();
243 // otherwise set the returnValue property of the original event to false (IE)
244 originalEvent.returnValue = false;
246 event.stopPropagation = function() {
247 // if stopPropagation exists run it on the original event
248 if (originalEvent.stopPropagation)
249 originalEvent.stopPropagation();
250 // otherwise set the cancelBubble property of the original event to true (IE)
251 originalEvent.cancelBubble = true;
254 // Fix target property, if necessary
255 if ( !event.target && event.srcElement )
256 event.target = event.srcElement;
258 // check if target is a textnode (safari)
259 if (jQuery.browser.safari && event.target.nodeType == 3)
260 event.target = originalEvent.target.parentNode;
262 // Add relatedTarget, if necessary
263 if ( !event.relatedTarget && event.fromElement )
264 event.relatedTarget = event.fromElement == event.target ? event.toElement : event.fromElement;
266 // Calculate pageX/Y if missing and clientX/Y available
267 if ( event.pageX == null && event.clientX != null ) {
268 var e = document.documentElement, b = document.body;
269 event.pageX = event.clientX + (e && e.scrollLeft || b && b.scrollLeft || 0);
270 event.pageY = event.clientY + (e && e.scrollTop || b && b.scrollTop || 0);
273 // Add which for key events
274 if ( !event.which && (event.charCode || event.keyCode) )
275 event.which = event.charCode || event.keyCode;
277 // Add metaKey to non-Mac browsers (use ctrl for PC's and Meta for Macs)
278 if ( !event.metaKey && event.ctrlKey )
279 event.metaKey = event.ctrlKey;
281 // Add which for click: 1 == left; 2 == middle; 3 == right
282 // Note: button is not normalized, so don't use it
283 if ( !event.which && event.button )
284 event.which = (event.button & 1 ? 1 : ( event.button & 2 ? 3 : ( event.button & 4 ? 2 : 0 ) ));
291 bind: function( type, data, fn ) {
292 return type == "unload" ? this.one(type, data, fn) : this.each(function(){
293 jQuery.event.add( this, type, fn || data, fn && data );
297 one: function( type, data, fn ) {
298 return this.each(function(){
299 jQuery.event.add( this, type, function(event) {
300 jQuery(this).unbind(event);
301 return (fn || data).apply( this, arguments);
306 unbind: function( type, fn ) {
307 return this.each(function(){
308 jQuery.event.remove( this, type, fn );
312 trigger: function( type, data, fn ) {
313 return this.each(function(){
314 jQuery.event.trigger( type, data, this, true, fn );
318 triggerHandler: function( type, data, fn ) {
320 return jQuery.event.trigger( type, data, this[0], false, fn );
324 // Save reference to arguments for access in closure
327 return this.click(function(e) {
328 // Figure out which function to execute
329 this.lastToggle = 0 == this.lastToggle ? 1 : 0;
331 // Make sure that clicks stop
334 // and execute the function
335 return a[this.lastToggle].apply( this, [e] ) || false;
339 hover: function(f,g) {
341 // A private function for handling mouse 'hovering'
342 function handleHover(e) {
343 // Check if mouse(over|out) are still within the same parent element
344 var p = e.relatedTarget;
346 // Traverse up the tree
347 while ( p && p != this ) try { p = p.parentNode; } catch(e) { p = this; };
349 // If we actually just moused on to a sub-element, ignore it
350 if ( p == this ) return false;
352 // Execute the right function
353 return (e.type == "mouseover" ? f : g).apply(this, [e]);
356 // Bind the function to the two event listeners
357 return this.mouseover(handleHover).mouseout(handleHover);
361 // Attach the listeners
364 // If the DOM is already ready
365 if ( jQuery.isReady )
366 // Execute the function immediately
367 f.apply( document, [jQuery] );
369 // Otherwise, remember the function for later
371 // Add the function to the wait list
372 jQuery.readyList.push( function() { return f.apply(this, [jQuery]); } );
380 * All the code that makes DOM Ready work nicely.
385 // Handle when the DOM is ready
387 // Make sure that the DOM is not already loaded
388 if ( !jQuery.isReady ) {
389 // Remember that the DOM is ready
390 jQuery.isReady = true;
392 // If there are functions bound, to execute
393 if ( jQuery.readyList ) {
394 // Execute all of them
395 jQuery.each( jQuery.readyList, function(){
396 this.apply( document );
399 // Reset the list of functions
400 jQuery.readyList = null;
402 // Remove event listener to avoid memory leak
403 if ( jQuery.browser.mozilla || jQuery.browser.opera )
404 document.removeEventListener( "DOMContentLoaded", jQuery.ready, false );
410 jQuery.each( ("blur,focus,load,resize,scroll,unload,click,dblclick," +
411 "mousedown,mouseup,mousemove,mouseover,mouseout,change,select," +
412 "submit,keydown,keypress,keyup,error").split(","), function(i,o){
414 // Handle event binding
415 jQuery.fn[o] = function(f){
416 return f ? this.bind(o, f) : this.trigger(o);
420 var readyBound = false;
422 function bindReady(){
423 if ( readyBound ) return;
426 // If Mozilla is used
427 if ( jQuery.browser.mozilla || jQuery.browser.opera )
428 // Use the handy event callback
429 document.addEventListener( "DOMContentLoaded", jQuery.ready, false );
431 // If Safari or IE is used
433 // Continually check to see if the document is ready
436 // If IE is used, use the trick by Diego Perini
437 // http://javascript.nwbox.com/IEContentLoaded/
438 if ( jQuery.browser.msie || document.readyState != "loaded" && document.readyState != "complete" )
439 document.documentElement.doScroll("left");
441 // and execute any waiting functions
444 setTimeout( timer, 0 );
451 // A fallback to window.onload, that will always work
452 jQuery.event.add( window, "load", jQuery.ready );