Added selector path logging (creates a trail that plugins can use).
[jquery.git] / src / core.js
1 /*
2  * jQuery @VERSION - New Wave Javascript
3  *
4  * Copyright (c) 2008 John Resig (jquery.com)
5  * Dual licensed under the MIT (MIT-LICENSE.txt)
6  * and GPL (GPL-LICENSE.txt) licenses.
7  *
8  * $Date$
9  * $Rev$
10  */
11
12 // Map over jQuery in case of overwrite
13 var _jQuery = window.jQuery,
14 // Map over the $ in case of overwrite
15         _$ = window.$;
16
17 var jQuery = window.jQuery = window.$ = function( selector, context ) {
18         // The jQuery object is actually just the init constructor 'enhanced'
19         return new jQuery.fn.init( selector, context );
20 };
21
22 // A simple way to check for HTML strings or ID strings
23 // (both of which we optimize for)
24 var quickExpr = /^[^<]*(<(.|\s)+>)[^>]*$|^#([\w-]+)$/,
25
26 // Is it a simple selector
27         isSimple = /^.[^:#\[\.]*$/,
28
29 // Will speed up references to undefined, and allows munging its name.
30         undefined;
31
32 jQuery.fn = jQuery.prototype = {
33         init: function( selector, context ) {
34                 // Make sure that a selection was provided
35                 selector = selector || document;
36
37                 // Handle $(DOMElement)
38                 if ( selector.nodeType ) {
39                         this[0] = selector;
40                         this.length = 1;
41                         this.context = selector;
42                         return this;
43                 }
44                 // Handle HTML strings
45                 if ( typeof selector === "string" ) {
46                         // Are we dealing with HTML string or an ID?
47                         var match = quickExpr.exec( selector );
48
49                         // Verify a match, and that no context was specified for #id
50                         if ( match && (match[1] || !context) ) {
51
52                                 // HANDLE: $(html) -> $(array)
53                                 if ( match[1] )
54                                         selector = jQuery.clean( [ match[1] ], context );
55
56                                 // HANDLE: $("#id")
57                                 else {
58                                         var elem = document.getElementById( match[3] );
59
60                                         // Make sure an element was located
61                                         if ( elem ){
62                                                 // Handle the case where IE and Opera return items
63                                                 // by name instead of ID
64                                                 if ( elem.id != match[3] )
65                                                         return jQuery().find( selector );
66
67                                                 // Otherwise, we inject the element directly into the jQuery object
68                                                 var ret = jQuery( elem );
69                                                 ret.context = document;
70                                                 ret.selector = selector;
71                                                 return ret;
72                                         }
73                                         selector = [];
74                                 }
75
76                         // HANDLE: $(expr, [context])
77                         // (which is just equivalent to: $(content).find(expr)
78                         } else
79                                 return jQuery( context ).find( selector );
80
81                 // HANDLE: $(function)
82                 // Shortcut for document ready
83                 } else if ( jQuery.isFunction( selector ) )
84                         return jQuery( document )[ jQuery.fn.ready ? "ready" : "load" ]( selector );
85
86                 return this.setArray(jQuery.makeArray(selector));
87         },
88
89         // Start with an empty selector
90         selector: "",
91
92         // The current version of jQuery being used
93         jquery: "@VERSION",
94
95         // The number of elements contained in the matched element set
96         size: function() {
97                 return this.length;
98         },
99
100         // Get the Nth element in the matched element set OR
101         // Get the whole matched element set as a clean array
102         get: function( num ) {
103                 return num === undefined ?
104
105                         // Return a 'clean' array
106                         jQuery.makeArray( this ) :
107
108                         // Return just the object
109                         this[ num ];
110         },
111
112         // Take an array of elements and push it onto the stack
113         // (returning the new matched element set)
114         pushStack: function( elems, name, selector ) {
115                 // Build a new jQuery matched element set
116                 var ret = jQuery( elems );
117
118                 // Add the old object onto the stack (as a reference)
119                 ret.prevObject = this;
120
121                 ret.context = this.context;
122
123                 if ( name === "find" )
124                         ret.selector = this.selector + (this.selector ? " " : "") + selector;
125                 else if ( name )
126                         ret.selector = this.selector + "." + name + "(" + selector + ")";
127
128                 // Return the newly-formed element set
129                 return ret;
130         },
131
132         // Force the current matched set of elements to become
133         // the specified array of elements (destroying the stack in the process)
134         // You should use pushStack() in order to do this, but maintain the stack
135         setArray: function( elems ) {
136                 // Resetting the length to 0, then using the native Array push
137                 // is a super-fast way to populate an object with array-like properties
138                 this.length = 0;
139                 Array.prototype.push.apply( this, elems );
140
141                 return this;
142         },
143
144         // Execute a callback for every element in the matched set.
145         // (You can seed the arguments with an array of args, but this is
146         // only used internally.)
147         each: function( callback, args ) {
148                 return jQuery.each( this, callback, args );
149         },
150
151         // Determine the position of an element within
152         // the matched set of elements
153         index: function( elem ) {
154                 var ret = -1;
155
156                 // Locate the position of the desired element
157                 return jQuery.inArray(
158                         // If it receives a jQuery object, the first element is used
159                         elem && elem.jquery ? elem[0] : elem
160                 , this );
161         },
162
163         attr: function( name, value, type ) {
164                 var options = name;
165
166                 // Look for the case where we're accessing a style value
167                 if ( typeof name === "string" )
168                         if ( value === undefined )
169                                 return this[0] && jQuery[ type || "attr" ]( this[0], name );
170
171                         else {
172                                 options = {};
173                                 options[ name ] = value;
174                         }
175
176                 // Check to see if we're setting style values
177                 return this.each(function(i){
178                         // Set all the styles
179                         for ( name in options )
180                                 jQuery.attr(
181                                         type ?
182                                                 this.style :
183                                                 this,
184                                         name, jQuery.prop( this, options[ name ], type, i, name )
185                                 );
186                 });
187         },
188
189         css: function( key, value ) {
190                 // ignore negative width and height values
191                 if ( (key == 'width' || key == 'height') && parseFloat(value) < 0 )
192                         value = undefined;
193                 return this.attr( key, value, "curCSS" );
194         },
195
196         text: function( text ) {
197                 if ( typeof text !== "object" && text != null )
198                         return this.empty().append( (this[0] && this[0].ownerDocument || document).createTextNode( text ) );
199
200                 var ret = "";
201
202                 jQuery.each( text || this, function(){
203                         jQuery.each( this.childNodes, function(){
204                                 if ( this.nodeType != 8 )
205                                         ret += this.nodeType != 1 ?
206                                                 this.nodeValue :
207                                                 jQuery.fn.text( [ this ] );
208                         });
209                 });
210
211                 return ret;
212         },
213
214         wrapAll: function( html ) {
215                 if ( this[0] )
216                         // The elements to wrap the target around
217                         jQuery( html, this[0].ownerDocument )
218                                 .clone()
219                                 .insertBefore( this[0] )
220                                 .map(function(){
221                                         var elem = this;
222
223                                         while ( elem.firstChild )
224                                                 elem = elem.firstChild;
225
226                                         return elem;
227                                 })
228                                 .append(this);
229
230                 return this;
231         },
232
233         wrapInner: function( html ) {
234                 return this.each(function(){
235                         jQuery( this ).contents().wrapAll( html );
236                 });
237         },
238
239         wrap: function( html ) {
240                 return this.each(function(){
241                         jQuery( this ).wrapAll( html );
242                 });
243         },
244
245         append: function() {
246                 return this.domManip(arguments, true, false, function(elem){
247                         if (this.nodeType == 1)
248                                 this.appendChild( elem );
249                 });
250         },
251
252         prepend: function() {
253                 return this.domManip(arguments, true, true, function(elem){
254                         if (this.nodeType == 1)
255                                 this.insertBefore( elem, this.firstChild );
256                 });
257         },
258
259         before: function() {
260                 return this.domManip(arguments, false, false, function(elem){
261                         this.parentNode.insertBefore( elem, this );
262                 });
263         },
264
265         after: function() {
266                 return this.domManip(arguments, false, true, function(elem){
267                         this.parentNode.insertBefore( elem, this.nextSibling );
268                 });
269         },
270
271         end: function() {
272                 return this.prevObject || jQuery( [] );
273         },
274
275         find: function( selector ) {
276                 var elems = jQuery.map(this, function(elem){
277                         return jQuery.find( selector, elem );
278                 });
279
280                 return this.pushStack( /[^+>] [^+>]/.test( selector ) ?
281                         jQuery.unique( elems ) :
282                         elems, "find", selector );
283         },
284
285         clone: function( events ) {
286                 // Do the clone
287                 var ret = this.map(function(){
288                         if ( jQuery.browser.msie && !jQuery.isXMLDoc(this) ) {
289                                 // IE copies events bound via attachEvent when
290                                 // using cloneNode. Calling detachEvent on the
291                                 // clone will also remove the events from the orignal
292                                 // In order to get around this, we use innerHTML.
293                                 // Unfortunately, this means some modifications to
294                                 // attributes in IE that are actually only stored
295                                 // as properties will not be copied (such as the
296                                 // the name attribute on an input).
297                                 var clone = this.cloneNode(true),
298                                         container = document.createElement("div");
299                                 container.appendChild(clone);
300                                 return jQuery.clean([container.innerHTML])[0];
301                         } else
302                                 return this.cloneNode(true);
303                 });
304
305                 // Need to set the expando to null on the cloned set if it exists
306                 // removeData doesn't work here, IE removes it from the original as well
307                 // this is primarily for IE but the data expando shouldn't be copied over in any browser
308                 var clone = ret.find("*").andSelf().each(function(){
309                         if ( this[ expando ] !== undefined )
310                                 this[ expando ] = null;
311                 });
312
313                 // Copy the events from the original to the clone
314                 if ( events === true )
315                         this.find("*").andSelf().each(function(i){
316                                 if (this.nodeType == 3)
317                                         return;
318                                 var events = jQuery.data( this, "events" );
319
320                                 for ( var type in events )
321                                         for ( var handler in events[ type ] )
322                                                 jQuery.event.add( clone[ i ], type, events[ type ][ handler ], events[ type ][ handler ].data );
323                         });
324
325                 // Return the cloned set
326                 return ret;
327         },
328
329         filter: function( selector ) {
330                 return this.pushStack(
331                         jQuery.isFunction( selector ) &&
332                         jQuery.grep(this, function(elem, i){
333                                 return selector.call( elem, i );
334                         }) ||
335
336                         jQuery.multiFilter( selector, this ), "filter", selector );
337         },
338
339         not: function( selector ) {
340                 if ( typeof selector === "string" )
341                         // test special case where just one selector is passed in
342                         if ( isSimple.test( selector ) )
343                                 return this.pushStack( jQuery.multiFilter( selector, this, true ), "not", selector );
344                         else
345                                 selector = jQuery.multiFilter( selector, this );
346
347                 var isArrayLike = selector.length && selector[selector.length - 1] !== undefined && !selector.nodeType;
348                 return this.filter(function() {
349                         return isArrayLike ? jQuery.inArray( this, selector ) < 0 : this != selector;
350                 });
351         },
352
353         add: function( selector ) {
354                 return this.pushStack( jQuery.unique( jQuery.merge(
355                         this.get(),
356                         typeof selector === "string" ?
357                                 jQuery( selector ) :
358                                 jQuery.makeArray( selector )
359                 )));
360         },
361
362         is: function( selector ) {
363                 return !!selector && jQuery.multiFilter( selector, this ).length > 0;
364         },
365
366         hasClass: function( selector ) {
367                 return !!selector && this.is( "." + selector );
368         },
369
370         val: function( value ) {
371                 if ( value === undefined ) {                    
372                         var elem = this[0];
373
374                         if ( elem ) {
375                                 if( jQuery.nodeName( elem, 'option' ) )
376                                         return (elem.attributes.value || {}).specified ? elem.value : elem.text;
377                                 
378                                 // We need to handle select boxes special
379                                 if ( jQuery.nodeName( elem, "select" ) ) {
380                                         var index = elem.selectedIndex,
381                                                 values = [],
382                                                 options = elem.options,
383                                                 one = elem.type == "select-one";
384
385                                         // Nothing was selected
386                                         if ( index < 0 )
387                                                 return null;
388
389                                         // Loop through all the selected options
390                                         for ( var i = one ? index : 0, max = one ? index + 1 : options.length; i < max; i++ ) {
391                                                 var option = options[ i ];
392
393                                                 if ( option.selected ) {
394                                                         // Get the specifc value for the option
395                                                         value = jQuery(option).val();
396
397                                                         // We don't need an array for one selects
398                                                         if ( one )
399                                                                 return value;
400
401                                                         // Multi-Selects return an array
402                                                         values.push( value );
403                                                 }
404                                         }
405
406                                         return values;                          
407                                 }
408
409                                 // Everything else, we just grab the value
410                                 return (elem.value || "").replace(/\r/g, "");
411
412                         }
413
414                         return undefined;
415                 }
416
417                 if ( typeof value === "number" )
418                         value += '';
419
420                 return this.each(function(){
421                         if ( this.nodeType != 1 )
422                                 return;
423
424                         if ( jQuery.isArray(value) && /radio|checkbox/.test( this.type ) )
425                                 this.checked = (jQuery.inArray(this.value, value) >= 0 ||
426                                         jQuery.inArray(this.name, value) >= 0);
427
428                         else if ( jQuery.nodeName( this, "select" ) ) {
429                                 var values = jQuery.makeArray(value);
430
431                                 jQuery( "option", this ).each(function(){
432                                         this.selected = (jQuery.inArray( this.value, values ) >= 0 ||
433                                                 jQuery.inArray( this.text, values ) >= 0);
434                                 });
435
436                                 if ( !values.length )
437                                         this.selectedIndex = -1;
438
439                         } else
440                                 this.value = value;
441                 });
442         },
443
444         html: function( value ) {
445                 return value === undefined ?
446                         (this[0] ?
447                                 this[0].innerHTML :
448                                 null) :
449                         this.empty().append( value );
450         },
451
452         replaceWith: function( value ) {
453                 return this.after( value ).remove();
454         },
455
456         eq: function( i ) {
457                 return this.slice( i, +i + 1 );
458         },
459
460         slice: function() {
461                 return this.pushStack( Array.prototype.slice.apply( this, arguments ),
462                         "slice", Array.prototype.slice.call(arguments).join(",") );
463         },
464
465         map: function( callback ) {
466                 return this.pushStack( jQuery.map(this, function(elem, i){
467                         return callback.call( elem, i, elem );
468                 }));
469         },
470
471         andSelf: function() {
472                 return this.add( this.prevObject );
473         },
474
475         data: function( key, value ){
476                 var parts = key.split(".");
477                 parts[1] = parts[1] ? "." + parts[1] : "";
478
479                 if ( value === undefined ) {
480                         var data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]);
481
482                         if ( data === undefined && this.length )
483                                 data = jQuery.data( this[0], key );
484
485                         return data === undefined && parts[1] ?
486                                 this.data( parts[0] ) :
487                                 data;
488                 } else
489                         return this.trigger("setData" + parts[1] + "!", [parts[0], value]).each(function(){
490                                 jQuery.data( this, key, value );
491                         });
492         },
493
494         removeData: function( key ){
495                 return this.each(function(){
496                         jQuery.removeData( this, key );
497                 });
498         },
499
500         domManip: function( args, table, reverse, callback ) {
501                 var clone = this.length > 1, elems;
502
503                 return this.each(function(){
504                         if ( !elems ) {
505                                 elems = jQuery.clean( args, this.ownerDocument );
506
507                                 if ( reverse )
508                                         elems.reverse();
509                         }
510
511                         var obj = this;
512
513                         if ( table && jQuery.nodeName( this, "table" ) && jQuery.nodeName( elems[0], "tr" ) )
514                                 obj = this.getElementsByTagName("tbody")[0] || this.appendChild( this.ownerDocument.createElement("tbody") );
515
516                         var scripts = jQuery( [] );
517
518                         jQuery.each(elems, function(){
519                                 var elem = clone ?
520                                         jQuery( this ).clone( true )[0] :
521                                         this;
522
523                                 // execute all scripts after the elements have been injected
524                                 if ( jQuery.nodeName( elem, "script" ) )
525                                         scripts = scripts.add( elem );
526                                 else {
527                                         // Remove any inner scripts for later evaluation
528                                         if ( elem.nodeType == 1 )
529                                                 scripts = scripts.add( jQuery( "script", elem ).remove() );
530
531                                         // Inject the elements into the document
532                                         callback.call( obj, elem );
533                                 }
534                         });
535
536                         scripts.each( evalScript );
537                 });
538         }
539 };
540
541 // Give the init function the jQuery prototype for later instantiation
542 jQuery.fn.init.prototype = jQuery.fn;
543
544 function evalScript( i, elem ) {
545         if ( elem.src )
546                 jQuery.ajax({
547                         url: elem.src,
548                         async: false,
549                         dataType: "script"
550                 });
551
552         else
553                 jQuery.globalEval( elem.text || elem.textContent || elem.innerHTML || "" );
554
555         if ( elem.parentNode )
556                 elem.parentNode.removeChild( elem );
557 }
558
559 function now(){
560         return +new Date;
561 }
562
563 jQuery.extend = jQuery.fn.extend = function() {
564         // copy reference to target object
565         var target = arguments[0] || {}, i = 1, length = arguments.length, deep = false, options;
566
567         // Handle a deep copy situation
568         if ( typeof target === "boolean" ) {
569                 deep = target;
570                 target = arguments[1] || {};
571                 // skip the boolean and the target
572                 i = 2;
573         }
574
575         // Handle case when target is a string or something (possible in deep copy)
576         if ( typeof target !== "object" && !jQuery.isFunction(target) )
577                 target = {};
578
579         // extend jQuery itself if only one argument is passed
580         if ( length == i ) {
581                 target = this;
582                 --i;
583         }
584
585         for ( ; i < length; i++ )
586                 // Only deal with non-null/undefined values
587                 if ( (options = arguments[ i ]) != null )
588                         // Extend the base object
589                         for ( var name in options ) {
590                                 var src = target[ name ], copy = options[ name ];
591
592                                 // Prevent never-ending loop
593                                 if ( target === copy )
594                                         continue;
595
596                                 // Recurse if we're merging object values
597                                 if ( deep && copy && typeof copy === "object" && !copy.nodeType )
598                                         target[ name ] = jQuery.extend( deep, 
599                                                 // Never move original objects, clone them
600                                                 src || ( copy.length != null ? [ ] : { } )
601                                         , copy );
602
603                                 // Don't bring in undefined values
604                                 else if ( copy !== undefined )
605                                         target[ name ] = copy;
606
607                         }
608
609         // Return the modified object
610         return target;
611 };
612
613 var expando = "jQuery" + now(), uuid = 0, windowData = {},
614         // exclude the following css properties to add px
615         exclude = /z-?index|font-?weight|opacity|zoom|line-?height/i,
616         // cache defaultView
617         defaultView = document.defaultView || {},
618         toString = Object.prototype.toString;
619
620 jQuery.extend({
621         noConflict: function( deep ) {
622                 window.$ = _$;
623
624                 if ( deep )
625                         window.jQuery = _jQuery;
626
627                 return jQuery;
628         },
629
630         // See test/unit/core.js for details concerning isFunction.
631         // Since version 1.3, DOM methods and functions like alert
632         // aren't supported. They return false on IE (#2968).
633         isFunction: function( obj ) {
634                 return toString.call(obj) === "[object Function]";
635         },
636
637         isArray: function( obj ) {
638                 return toString.call(obj) === "[object Array]";
639         },
640
641         // check if an element is in a (or is an) XML document
642         isXMLDoc: function( elem ) {
643                 return elem.documentElement && !elem.body ||
644                         elem.tagName && elem.ownerDocument && !elem.ownerDocument.body;
645         },
646
647         // Evalulates a script in a global context
648         globalEval: function( data ) {
649                 data = jQuery.trim( data );
650
651                 if ( data ) {
652                         // Inspired by code by Andrea Giammarchi
653                         // http://webreflection.blogspot.com/2007/08/global-scope-evaluation-and-dom.html
654                         var head = document.getElementsByTagName("head")[0] || document.documentElement,
655                                 script = document.createElement("script");
656
657                         script.type = "text/javascript";
658                         if ( jQuery.browser.msie )
659                                 script.text = data;
660                         else
661                                 script.appendChild( document.createTextNode( data ) );
662
663                         // Use insertBefore instead of appendChild  to circumvent an IE6 bug.
664                         // This arises when a base node is used (#2709).
665                         head.insertBefore( script, head.firstChild );
666                         head.removeChild( script );
667                 }
668         },
669
670         nodeName: function( elem, name ) {
671                 return elem.nodeName && elem.nodeName.toUpperCase() == name.toUpperCase();
672         },
673
674         cache: {},
675
676         data: function( elem, name, data ) {
677                 elem = elem == window ?
678                         windowData :
679                         elem;
680
681                 var id = elem[ expando ];
682
683                 // Compute a unique ID for the element
684                 if ( !id )
685                         id = elem[ expando ] = ++uuid;
686
687                 // Only generate the data cache if we're
688                 // trying to access or manipulate it
689                 if ( name && !jQuery.cache[ id ] )
690                         jQuery.cache[ id ] = {};
691
692                 // Prevent overriding the named cache with undefined values
693                 if ( data !== undefined )
694                         jQuery.cache[ id ][ name ] = data;
695
696                 // Return the named cache data, or the ID for the element
697                 return name ?
698                         jQuery.cache[ id ][ name ] || null :
699                         id;
700         },
701
702         removeData: function( elem, name ) {
703                 elem = elem == window ?
704                         windowData :
705                         elem;
706
707                 var id = elem[ expando ];
708
709                 // If we want to remove a specific section of the element's data
710                 if ( name ) {
711                         if ( jQuery.cache[ id ] ) {
712                                 // Remove the section of cache data
713                                 delete jQuery.cache[ id ][ name ];
714
715                                 // If we've removed all the data, remove the element's cache
716                                 name = "";
717
718                                 for ( name in jQuery.cache[ id ] )
719                                         break;
720
721                                 if ( !name )
722                                         jQuery.removeData( elem );
723                         }
724
725                 // Otherwise, we want to remove all of the element's data
726                 } else {
727                         // Clean up the element expando
728                         try {
729                                 delete elem[ expando ];
730                         } catch(e){
731                                 // IE has trouble directly removing the expando
732                                 // but it's ok with using removeAttribute
733                                 if ( elem.removeAttribute )
734                                         elem.removeAttribute( expando );
735                         }
736
737                         // Completely remove the data cache
738                         delete jQuery.cache[ id ];
739                 }
740         },
741
742         // args is for internal usage only
743         each: function( object, callback, args ) {
744                 var name, i = 0, length = object.length;
745
746                 if ( args ) {
747                         if ( length === undefined ) {
748                                 for ( name in object )
749                                         if ( callback.apply( object[ name ], args ) === false )
750                                                 break;
751                         } else
752                                 for ( ; i < length; )
753                                         if ( callback.apply( object[ i++ ], args ) === false )
754                                                 break;
755
756                 // A special, fast, case for the most common use of each
757                 } else {
758                         if ( length === undefined ) {
759                                 for ( name in object )
760                                         if ( callback.call( object[ name ], name, object[ name ] ) === false )
761                                                 break;
762                         } else
763                                 for ( var value = object[0];
764                                         i < length && callback.call( value, i, value ) !== false; value = object[++i] ){}
765                 }
766
767                 return object;
768         },
769
770         prop: function( elem, value, type, i, name ) {
771                 // Handle executable functions
772                 if ( jQuery.isFunction( value ) )
773                         value = value.call( elem, i );
774
775                 // Handle passing in a number to a CSS property
776                 return typeof value === "number" && type == "curCSS" && !exclude.test( name ) ?
777                         value + "px" :
778                         value;
779         },
780
781         className: {
782                 // internal only, use addClass("class")
783                 add: function( elem, classNames ) {
784                         jQuery.each((classNames || "").split(/\s+/), function(i, className){
785                                 if ( elem.nodeType == 1 && !jQuery.className.has( elem.className, className ) )
786                                         elem.className += (elem.className ? " " : "") + className;
787                         });
788                 },
789
790                 // internal only, use removeClass("class")
791                 remove: function( elem, classNames ) {
792                         if (elem.nodeType == 1)
793                                 elem.className = classNames !== undefined ?
794                                         jQuery.grep(elem.className.split(/\s+/), function(className){
795                                                 return !jQuery.className.has( classNames, className );
796                                         }).join(" ") :
797                                         "";
798                 },
799
800                 // internal only, use hasClass("class")
801                 has: function( elem, className ) {
802                         return jQuery.inArray( className, (elem.className || elem).toString().split(/\s+/) ) > -1;
803                 }
804         },
805
806         // A method for quickly swapping in/out CSS properties to get correct calculations
807         swap: function( elem, options, callback ) {
808                 var old = {};
809                 // Remember the old values, and insert the new ones
810                 for ( var name in options ) {
811                         old[ name ] = elem.style[ name ];
812                         elem.style[ name ] = options[ name ];
813                 }
814
815                 callback.call( elem );
816
817                 // Revert the old values
818                 for ( var name in options )
819                         elem.style[ name ] = old[ name ];
820         },
821
822         css: function( elem, name, force ) {
823                 if ( name == "width" || name == "height" ) {
824                         var val, props = { position: "absolute", visibility: "hidden", display:"block" }, which = name == "width" ? [ "Left", "Right" ] : [ "Top", "Bottom" ];
825
826                         function getWH() {
827                                 val = name == "width" ? elem.offsetWidth : elem.offsetHeight;
828                                 var padding = 0, border = 0;
829                                 jQuery.each( which, function() {
830                                         padding += parseFloat(jQuery.curCSS( elem, "padding" + this, true)) || 0;
831                                         border += parseFloat(jQuery.curCSS( elem, "border" + this + "Width", true)) || 0;
832                                 });
833                                 val -= Math.round(padding + border);
834                         }
835
836                         if ( jQuery(elem).is(":visible") )
837                                 getWH();
838                         else
839                                 jQuery.swap( elem, props, getWH );
840
841                         return Math.max(0, val);
842                 }
843
844                 return jQuery.curCSS( elem, name, force );
845         },
846
847         curCSS: function( elem, name, force ) {
848                 var ret, style = elem.style;
849
850                 // A helper method for determining if an element's values are broken
851                 function color( elem ) {
852                         if ( !jQuery.browser.safari )
853                                 return false;
854
855                         // defaultView is cached
856                         var ret = defaultView.getComputedStyle( elem, null );
857                         return !ret || ret.getPropertyValue("color") == "";
858                 }
859
860                 // We need to handle opacity special in IE
861                 if ( name == "opacity" && jQuery.browser.msie ) {
862                         ret = jQuery.attr( style, "opacity" );
863
864                         return ret == "" ?
865                                 "1" :
866                                 ret;
867                 }
868                 // Opera sometimes will give the wrong display answer, this fixes it, see #2037
869                 if ( jQuery.browser.opera && name == "display" ) {
870                         var save = style.outline;
871                         style.outline = "0 solid black";
872                         style.outline = save;
873                 }
874
875                 // Make sure we're using the right name for getting the float value
876                 if ( name.match( /float/i ) )
877                         name = styleFloat;
878
879                 if ( !force && style && style[ name ] )
880                         ret = style[ name ];
881
882                 else if ( defaultView.getComputedStyle ) {
883
884                         // Only "float" is needed here
885                         if ( name.match( /float/i ) )
886                                 name = "float";
887
888                         name = name.replace( /([A-Z])/g, "-$1" ).toLowerCase();
889
890                         var computedStyle = defaultView.getComputedStyle( elem, null );
891
892                         if ( computedStyle && !color( elem ) )
893                                 ret = computedStyle.getPropertyValue( name );
894
895                         // If the element isn't reporting its values properly in Safari
896                         // then some display: none elements are involved
897                         else {
898                                 var swap = [], stack = [], a = elem, i = 0;
899
900                                 // Locate all of the parent display: none elements
901                                 for ( ; a && color(a); a = a.parentNode )
902                                         stack.unshift(a);
903
904                                 // Go through and make them visible, but in reverse
905                                 // (It would be better if we knew the exact display type that they had)
906                                 for ( ; i < stack.length; i++ )
907                                         if ( color( stack[ i ] ) ) {
908                                                 swap[ i ] = stack[ i ].style.display;
909                                                 stack[ i ].style.display = "block";
910                                         }
911
912                                 // Since we flip the display style, we have to handle that
913                                 // one special, otherwise get the value
914                                 ret = name == "display" && swap[ stack.length - 1 ] != null ?
915                                         "none" :
916                                         ( computedStyle && computedStyle.getPropertyValue( name ) ) || "";
917
918                                 // Finally, revert the display styles back
919                                 for ( i = 0; i < swap.length; i++ )
920                                         if ( swap[ i ] != null )
921                                                 stack[ i ].style.display = swap[ i ];
922                         }
923
924                         // We should always get a number back from opacity
925                         if ( name == "opacity" && ret == "" )
926                                 ret = "1";
927
928                 } else if ( elem.currentStyle ) {
929                         var camelCase = name.replace(/\-(\w)/g, function(all, letter){
930                                 return letter.toUpperCase();
931                         });
932
933                         ret = elem.currentStyle[ name ] || elem.currentStyle[ camelCase ];
934
935                         // From the awesome hack by Dean Edwards
936                         // http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291
937
938                         // If we're not dealing with a regular pixel number
939                         // but a number that has a weird ending, we need to convert it to pixels
940                         if ( !/^\d+(px)?$/i.test( ret ) && /^\d/.test( ret ) ) {
941                                 // Remember the original values
942                                 var left = style.left, rsLeft = elem.runtimeStyle.left;
943
944                                 // Put in the new values to get a computed value out
945                                 elem.runtimeStyle.left = elem.currentStyle.left;
946                                 style.left = ret || 0;
947                                 ret = style.pixelLeft + "px";
948
949                                 // Revert the changed values
950                                 style.left = left;
951                                 elem.runtimeStyle.left = rsLeft;
952                         }
953                 }
954
955                 return ret;
956         },
957
958         clean: function( elems, context ) {
959                 var ret = [];
960                 context = context || document;
961
962                 // !context.createElement fails in IE with an error but returns typeof 'object'
963                 if ( typeof context.createElement === "undefined" )
964                         context = context.ownerDocument || context[0] && context[0].ownerDocument || document;
965
966                 jQuery.each(elems, function(i, elem){
967                         if ( typeof elem === "number" )
968                                 elem += '';
969
970                         if ( !elem )
971                                 return;
972
973                         // Convert html string into DOM nodes
974                         if ( typeof elem === "string" ) {
975                                 // Fix "XHTML"-style tags in all browsers
976                                 elem = elem.replace(/(<(\w+)[^>]*?)\/>/g, function(all, front, tag){
977                                         return tag.match(/^(abbr|br|col|img|input|link|meta|param|hr|area|embed)$/i) ?
978                                                 all :
979                                                 front + "></" + tag + ">";
980                                 });
981
982                                 // Trim whitespace, otherwise indexOf won't work as expected
983                                 var tags = jQuery.trim( elem ).toLowerCase(), div = context.createElement("div");
984
985                                 var wrap =
986                                         // option or optgroup
987                                         !tags.indexOf("<opt") &&
988                                         [ 1, "<select multiple='multiple'>", "</select>" ] ||
989
990                                         !tags.indexOf("<leg") &&
991                                         [ 1, "<fieldset>", "</fieldset>" ] ||
992
993                                         tags.match(/^<(thead|tbody|tfoot|colg|cap)/) &&
994                                         [ 1, "<table>", "</table>" ] ||
995
996                                         !tags.indexOf("<tr") &&
997                                         [ 2, "<table><tbody>", "</tbody></table>" ] ||
998
999                                         // <thead> matched above
1000                                         (!tags.indexOf("<td") || !tags.indexOf("<th")) &&
1001                                         [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ] ||
1002
1003                                         !tags.indexOf("<col") &&
1004                                         [ 2, "<table><tbody></tbody><colgroup>", "</colgroup></table>" ] ||
1005
1006                                         // IE can't serialize <link> and <script> tags normally
1007                                         jQuery.browser.msie &&
1008                                         [ 1, "div<div>", "</div>" ] ||
1009
1010                                         [ 0, "", "" ];
1011
1012                                 // Go to html and back, then peel off extra wrappers
1013                                 div.innerHTML = wrap[1] + elem + wrap[2];
1014
1015                                 // Move to the right depth
1016                                 while ( wrap[0]-- )
1017                                         div = div.lastChild;
1018
1019                                 // Remove IE's autoinserted <tbody> from table fragments
1020                                 if ( jQuery.browser.msie ) {
1021
1022                                         // String was a <table>, *may* have spurious <tbody>
1023                                         var tbody = !tags.indexOf("<table") && tags.indexOf("<tbody") < 0 ?
1024                                                 div.firstChild && div.firstChild.childNodes :
1025
1026                                                 // String was a bare <thead> or <tfoot>
1027                                                 wrap[1] == "<table>" && tags.indexOf("<tbody") < 0 ?
1028                                                         div.childNodes :
1029                                                         [];
1030
1031                                         for ( var j = tbody.length - 1; j >= 0 ; --j )
1032                                                 if ( jQuery.nodeName( tbody[ j ], "tbody" ) && !tbody[ j ].childNodes.length )
1033                                                         tbody[ j ].parentNode.removeChild( tbody[ j ] );
1034
1035                                         // IE completely kills leading whitespace when innerHTML is used
1036                                         if ( /^\s/.test( elem ) )
1037                                                 div.insertBefore( context.createTextNode( elem.match(/^\s*/)[0] ), div.firstChild );
1038
1039                                 }
1040
1041                                 elem = jQuery.makeArray( div.childNodes );
1042                         }
1043
1044                         if ( elem.length === 0 && (!jQuery.nodeName( elem, "form" ) && !jQuery.nodeName( elem, "select" )) )
1045                                 return;
1046
1047                         if ( elem[0] === undefined || jQuery.nodeName( elem, "form" ) || elem.options )
1048                                 ret.push( elem );
1049
1050                         else
1051                                 ret = jQuery.merge( ret, elem );
1052
1053                 });
1054
1055                 return ret;
1056         },
1057
1058         attr: function( elem, name, value ) {
1059                 // don't set attributes on text and comment nodes
1060                 if (!elem || elem.nodeType == 3 || elem.nodeType == 8)
1061                         return undefined;
1062
1063                 var notxml = !jQuery.isXMLDoc( elem ),
1064                         // Whether we are setting (or getting)
1065                         set = value !== undefined,
1066                         msie = jQuery.browser.msie;
1067
1068                 // Try to normalize/fix the name
1069                 name = notxml && jQuery.props[ name ] || name;
1070
1071                 // Only do all the following if this is a node (faster for style)
1072                 // IE elem.getAttribute passes even for style
1073                 if ( elem.tagName ) {
1074
1075                         // These attributes require special treatment
1076                         var special = /href|src|style/.test( name );
1077
1078                         // Safari mis-reports the default selected property of a hidden option
1079                         // Accessing the parent's selectedIndex property fixes it
1080                         if ( name == "selected" && jQuery.browser.safari )
1081                                 elem.parentNode.selectedIndex;
1082
1083                         // If applicable, access the attribute via the DOM 0 way
1084                         if ( name in elem && notxml && !special ) {
1085                                 if ( set ){
1086                                         // We can't allow the type property to be changed (since it causes problems in IE)
1087                                         if ( name == "type" && jQuery.nodeName( elem, "input" ) && elem.parentNode )
1088                                                 throw "type property can't be changed";
1089
1090                                         elem[ name ] = value;
1091                                 }
1092
1093                                 // browsers index elements by id/name on forms, give priority to attributes.
1094                                 if( jQuery.nodeName( elem, "form" ) && elem.getAttributeNode(name) )
1095                                         return elem.getAttributeNode( name ).nodeValue;
1096
1097                                 return elem[ name ];
1098                         }
1099
1100                         if ( msie && notxml &&  name == "style" )
1101                                 return jQuery.attr( elem.style, "cssText", value );
1102
1103                         if ( set )
1104                                 // convert the value to a string (all browsers do this but IE) see #1070
1105                                 elem.setAttribute( name, "" + value );
1106
1107                         var attr = msie && notxml && special
1108                                         // Some attributes require a special call on IE
1109                                         ? elem.getAttribute( name, 2 )
1110                                         : elem.getAttribute( name );
1111
1112                         // Non-existent attributes return null, we normalize to undefined
1113                         return attr === null ? undefined : attr;
1114                 }
1115
1116                 // elem is actually elem.style ... set the style
1117
1118                 // IE uses filters for opacity
1119                 if ( msie && name == "opacity" ) {
1120                         if ( set ) {
1121                                 // IE has trouble with opacity if it does not have layout
1122                                 // Force it by setting the zoom level
1123                                 elem.zoom = 1;
1124
1125                                 // Set the alpha filter to set the opacity
1126                                 elem.filter = (elem.filter || "").replace( /alpha\([^)]*\)/, "" ) +
1127                                         (parseInt( value ) + '' == "NaN" ? "" : "alpha(opacity=" + value * 100 + ")");
1128                         }
1129
1130                         return elem.filter && elem.filter.indexOf("opacity=") >= 0 ?
1131                                 (parseFloat( elem.filter.match(/opacity=([^)]*)/)[1] ) / 100) + '':
1132                                 "";
1133                 }
1134
1135                 name = name.replace(/-([a-z])/ig, function(all, letter){
1136                         return letter.toUpperCase();
1137                 });
1138
1139                 if ( set )
1140                         elem[ name ] = value;
1141
1142                 return elem[ name ];
1143         },
1144
1145         trim: function( text ) {
1146                 return (text || "").replace( /^\s+|\s+$/g, "" );
1147         },
1148
1149         makeArray: function( array ) {
1150                 var ret = [];
1151
1152                 if( array != null ){
1153                         var i = array.length;
1154                         // The window, strings (and functions) also have 'length'
1155                         if( i == null || typeof array === "string" || jQuery.isFunction(array) || array.setInterval )
1156                                 ret[0] = array;
1157                         else
1158                                 while( i )
1159                                         ret[--i] = array[i];
1160                 }
1161
1162                 return ret;
1163         },
1164
1165         inArray: function( elem, array ) {
1166                 for ( var i = 0, length = array.length; i < length; i++ )
1167                 // Use === because on IE, window == document
1168                         if ( array[ i ] === elem )
1169                                 return i;
1170
1171                 return -1;
1172         },
1173
1174         merge: function( first, second ) {
1175                 // We have to loop this way because IE & Opera overwrite the length
1176                 // expando of getElementsByTagName
1177                 var i = 0, elem, pos = first.length;
1178                 // Also, we need to make sure that the correct elements are being returned
1179                 // (IE returns comment nodes in a '*' query)
1180                 if ( jQuery.browser.msie ) {
1181                         while ( (elem = second[ i++ ]) )
1182                                 if ( elem.nodeType != 8 )
1183                                         first[ pos++ ] = elem;
1184
1185                 } else
1186                         while ( (elem = second[ i++ ]) )
1187                                 first[ pos++ ] = elem;
1188
1189                 return first;
1190         },
1191
1192         unique: function( array ) {
1193                 var ret = [], done = {};
1194
1195                 try {
1196
1197                         for ( var i = 0, length = array.length; i < length; i++ ) {
1198                                 var id = jQuery.data( array[ i ] );
1199
1200                                 if ( !done[ id ] ) {
1201                                         done[ id ] = true;
1202                                         ret.push( array[ i ] );
1203                                 }
1204                         }
1205
1206                 } catch( e ) {
1207                         ret = array;
1208                 }
1209
1210                 return ret;
1211         },
1212
1213         grep: function( elems, callback, inv ) {
1214                 var ret = [];
1215
1216                 // Go through the array, only saving the items
1217                 // that pass the validator function
1218                 for ( var i = 0, length = elems.length; i < length; i++ )
1219                         if ( !inv != !callback( elems[ i ], i ) )
1220                                 ret.push( elems[ i ] );
1221
1222                 return ret;
1223         },
1224
1225         map: function( elems, callback ) {
1226                 var ret = [];
1227
1228                 // Go through the array, translating each of the items to their
1229                 // new value (or values).
1230                 for ( var i = 0, length = elems.length; i < length; i++ ) {
1231                         var value = callback( elems[ i ], i );
1232
1233                         if ( value != null )
1234                                 ret[ ret.length ] = value;
1235                 }
1236
1237                 return ret.concat.apply( [], ret );
1238         }
1239 });
1240
1241 var userAgent = navigator.userAgent.toLowerCase();
1242
1243 // Figure out what browser is being used
1244 jQuery.browser = {
1245         version: (userAgent.match( /.+(?:rv|it|ra|ie)[\/: ]([\d.]+)/ ) || [0,'0'])[1],
1246         safari: /webkit/.test( userAgent ),
1247         opera: /opera/.test( userAgent ),
1248         msie: /msie/.test( userAgent ) && !/opera/.test( userAgent ),
1249         mozilla: /mozilla/.test( userAgent ) && !/(compatible|webkit)/.test( userAgent )
1250 };
1251
1252 var styleFloat = jQuery.browser.msie ?
1253         "styleFloat" :
1254         "cssFloat";
1255
1256 jQuery.extend({
1257         // Check to see if the W3C box model is being used
1258         boxModel: !jQuery.browser.msie || document.compatMode == "CSS1Compat",
1259
1260         props: {
1261                 "for": "htmlFor",
1262                 "class": "className",
1263                 "float": styleFloat,
1264                 cssFloat: styleFloat,
1265                 styleFloat: styleFloat,
1266                 readonly: "readOnly",
1267                 maxlength: "maxLength",
1268                 cellspacing: "cellSpacing",
1269                 rowspan: "rowSpan"
1270         }
1271 });
1272
1273 jQuery.each({
1274         parent: function(elem){return elem.parentNode;},
1275         parents: function(elem){return jQuery.dir(elem,"parentNode");},
1276         next: function(elem){return jQuery.nth(elem,2,"nextSibling");},
1277         prev: function(elem){return jQuery.nth(elem,2,"previousSibling");},
1278         nextAll: function(elem){return jQuery.dir(elem,"nextSibling");},
1279         prevAll: function(elem){return jQuery.dir(elem,"previousSibling");},
1280         siblings: function(elem){return jQuery.sibling(elem.parentNode.firstChild,elem);},
1281         children: function(elem){return jQuery.sibling(elem.firstChild);},
1282         contents: function(elem){return jQuery.nodeName(elem,"iframe")?elem.contentDocument||elem.contentWindow.document:jQuery.makeArray(elem.childNodes);}
1283 }, function(name, fn){
1284         jQuery.fn[ name ] = function( selector ) {
1285                 var ret = jQuery.map( this, fn );
1286
1287                 if ( selector && typeof selector == "string" )
1288                         ret = jQuery.multiFilter( selector, ret );
1289
1290                 return this.pushStack( jQuery.unique( ret ), name, selector );
1291         };
1292 });
1293
1294 jQuery.each({
1295         appendTo: "append",
1296         prependTo: "prepend",
1297         insertBefore: "before",
1298         insertAfter: "after",
1299         replaceAll: "replaceWith"
1300 }, function(name, original){
1301         jQuery.fn[ name ] = function() {
1302                 var args = arguments;
1303
1304                 return this.each(function(){
1305                         for ( var i = 0, length = args.length; i < length; i++ )
1306                                 jQuery( args[ i ] )[ original ]( this );
1307                 });
1308         };
1309 });
1310
1311 jQuery.each({
1312         removeAttr: function( name ) {
1313                 jQuery.attr( this, name, "" );
1314                 if (this.nodeType == 1)
1315                         this.removeAttribute( name );
1316         },
1317
1318         addClass: function( classNames ) {
1319                 jQuery.className.add( this, classNames );
1320         },
1321
1322         removeClass: function( classNames ) {
1323                 jQuery.className.remove( this, classNames );
1324         },
1325
1326         toggleClass: function( classNames ) {
1327                 jQuery.className[ jQuery.className.has( this, classNames ) ? "remove" : "add" ]( this, classNames );
1328         },
1329
1330         remove: function( selector ) {
1331                 if ( !selector || jQuery.filter( selector, [ this ] ).r.length ) {
1332                         // Prevent memory leaks
1333                         jQuery( "*", this ).add([this]).each(function(){
1334                                 jQuery.event.remove(this);
1335                                 jQuery.removeData(this);
1336                         });
1337                         if (this.parentNode)
1338                                 this.parentNode.removeChild( this );
1339                 }
1340         },
1341
1342         empty: function() {
1343                 // Remove element nodes and prevent memory leaks
1344                 jQuery( ">*", this ).remove();
1345
1346                 // Remove any remaining nodes
1347                 while ( this.firstChild )
1348                         this.removeChild( this.firstChild );
1349         }
1350 }, function(name, fn){
1351         jQuery.fn[ name ] = function(){
1352                 return this.each( fn, arguments );
1353         };
1354 });
1355
1356 jQuery.each([ "Height", "Width" ], function(i, name){
1357         var type = name.toLowerCase();
1358
1359         jQuery.fn[ type ] = function( size ) {
1360                 // Get window width or height
1361                 return this[0] == window ?
1362                         // Opera reports document.body.client[Width/Height] properly in both quirks and standards
1363                         jQuery.browser.opera && document.body.parentNode[ "client" + name ] ||
1364
1365                         // Safari reports inner[Width/Height] just fine (Mozilla and Opera include scroll bar widths)
1366                         jQuery.browser.safari && window[ "inner" + name ] ||
1367
1368                         // Everyone else use document.documentElement or document.body depending on Quirks vs Standards mode
1369                         document.compatMode == "CSS1Compat" && document.documentElement[ "client" + name ] || document.body[ "client" + name ] :
1370
1371                         // Get document width or height
1372                         this[0] == document ?
1373                                 // Either scroll[Width/Height] or offset[Width/Height], whichever is greater
1374                                 Math.max(
1375                                         Math.max(document.body["scroll" + name], document.documentElement["scroll" + name]),
1376                                         Math.max(document.body["offset" + name], document.documentElement["offset" + name])
1377                                 ) :
1378
1379                                 // Get or set width or height on the element
1380                                 size === undefined ?
1381                                         // Get width or height on the element
1382                                         (this.length ? jQuery.css( this[0], type ) : null) :
1383
1384                                         // Set the width or height on the element (default to pixels if value is unitless)
1385                                         this.css( type, typeof size === "string" ? size : size + "px" );
1386         };
1387 });
1388
1389 // Helper function used by the dimensions and offset modules
1390 function num(elem, prop) {
1391         return elem[0] && parseInt( jQuery.curCSS(elem[0], prop, true), 10 ) || 0;
1392 }