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