Standardize on using double-quotes for string literals.
[jquery.git] / src / core.js
1 // Define a local copy of jQuery
2 var jQuery = function( selector, context ) {
3                 // The jQuery object is actually just the init constructor 'enhanced'
4                 return new jQuery.fn.init( selector, context );
5         },
6
7         // Map over jQuery in case of overwrite
8         _jQuery = window.jQuery,
9
10         // Map over the $ in case of overwrite
11         _$ = window.$,
12
13         // Use the correct document accordingly with window argument (sandbox)
14         document = window.document,
15
16         // A central reference to the root jQuery(document)
17         rootjQuery,
18
19         // A simple way to check for HTML strings or ID strings
20         // (both of which we optimize for)
21         quickExpr = /^[^<]*(<[\w\W]+>)[^>]*$|^#([\w-]+)$/,
22
23         // Is it a simple selector
24         isSimple = /^.[^:#\[\.,]*$/,
25
26         // Check if a string has a non-whitespace character in it
27         rnotwhite = /\S/,
28
29         // Used for trimming whitespace
30         rtrim = /^(\s|\u00A0)+|(\s|\u00A0)+$/g,
31
32         // Match a standalone tag
33         rsingleTag = /^<(\w+)\s*\/?>(?:<\/\1>)?$/,
34
35         // Keep a UserAgent string for use with jQuery.browser
36         userAgent = navigator.userAgent.toLowerCase(),
37         
38         // Has the ready events already been bound?
39         readyBound = false,
40         
41         // The functions to execute on DOM ready
42         readyList = [],
43
44         // The ready event handler
45         DOMContentLoaded,
46
47         // Save a reference to some core methods
48         toString = Object.prototype.toString,
49         hasOwnProperty = Object.prototype.hasOwnProperty,
50         push = Array.prototype.push,
51         slice = Array.prototype.slice,
52         indexOf = Array.prototype.indexOf;
53
54 jQuery.fn = jQuery.prototype = {
55         init: function( selector, context ) {
56                 var match, elem, ret, doc;
57
58                 // Handle $(""), $(null), or $(undefined)
59                 if ( !selector ) {
60                         return this;
61                 }
62
63                 // Handle $(DOMElement)
64                 if ( selector.nodeType ) {
65                         this.context = this[0] = selector;
66                         this.length = 1;
67                         return this;
68                 }
69
70                 // Handle HTML strings
71                 if ( typeof selector === "string" ) {
72                         // Are we dealing with HTML string or an ID?
73                         match = quickExpr.exec( selector );
74
75                         // Verify a match, and that no context was specified for #id
76                         if ( match && (match[1] || !context) ) {
77
78                                 // HANDLE: $(html) -> $(array)
79                                 if ( match[1] ) {
80                                         doc = (context ? context.ownerDocument || context : document);
81
82                                         // If a single string is passed in and it's a single tag
83                                         // just do a createElement and skip the rest
84                                         ret = rsingleTag.exec( selector );
85
86                                         if ( ret ) {
87                                                 if ( jQuery.isPlainObject( context ) ) {
88                                                         selector = [ document.createElement( ret[1] ) ];
89                                                         jQuery.fn.attr.call( selector, context, true );
90
91                                                 } else {
92                                                         selector = [ doc.createElement( ret[1] ) ];
93                                                 }
94
95                                         } else {
96                                                 ret = buildFragment( [ match[1] ], [ doc ] );
97                                                 selector = (ret.cacheable ? ret.fragment.cloneNode(true) : ret.fragment).childNodes;
98                                         }
99
100                                 // HANDLE: $("#id")
101                                 } else {
102                                         elem = document.getElementById( match[2] );
103
104                                         if ( elem ) {
105                                                 // Handle the case where IE and Opera return items
106                                                 // by name instead of ID
107                                                 if ( elem.id !== match[2] ) {
108                                                         return rootjQuery.find( selector );
109                                                 }
110
111                                                 // Otherwise, we inject the element directly into the jQuery object
112                                                 this.length = 1;
113                                                 this[0] = elem;
114                                         }
115
116                                         this.context = document;
117                                         this.selector = selector;
118                                         return this;
119                                 }
120
121                         // HANDLE: $("TAG")
122                         } else if ( !context && /^\w+$/.test( selector ) ) {
123                                 this.selector = selector;
124                                 this.context = document;
125                                 selector = document.getElementsByTagName( selector );
126
127                         // HANDLE: $(expr, $(...))
128                         } else if ( !context || context.jquery ) {
129                                 return (context || rootjQuery).find( selector );
130
131                         // HANDLE: $(expr, context)
132                         // (which is just equivalent to: $(context).find(expr)
133                         } else {
134                                 return jQuery( context ).find( selector );
135                         }
136
137                 // HANDLE: $(function)
138                 // Shortcut for document ready
139                 } else if ( jQuery.isFunction( selector ) ) {
140                         return rootjQuery.ready( selector );
141                 }
142
143                 if (selector.selector !== undefined) {
144                         this.selector = selector.selector;
145                         this.context = selector.context;
146                 }
147
148                 return jQuery.isArray( selector ) ?
149                         this.setArray( selector ) :
150                         jQuery.makeArray( selector, this );
151         },
152
153         // Start with an empty selector
154         selector: "",
155
156         // The current version of jQuery being used
157         jquery: "@VERSION",
158
159         // The default length of a jQuery object is 0
160         length: 0,
161
162         // The number of elements contained in the matched element set
163         size: function() {
164                 return this.length;
165         },
166
167         toArray: function() {
168                 return slice.call( this, 0 );
169         },
170
171         // Get the Nth element in the matched element set OR
172         // Get the whole matched element set as a clean array
173         get: function( num ) {
174                 return num == null ?
175
176                         // Return a 'clean' array
177                         this.toArray() :
178
179                         // Return just the object
180                         ( num < 0 ? this.slice(num)[ 0 ] : this[ num ] );
181         },
182
183         // Take an array of elements and push it onto the stack
184         // (returning the new matched element set)
185         pushStack: function( elems, name, selector ) {
186                 // Build a new jQuery matched element set
187                 var ret = jQuery( elems || null );
188
189                 // Add the old object onto the stack (as a reference)
190                 ret.prevObject = this;
191
192                 ret.context = this.context;
193
194                 if ( name === "find" ) {
195                         ret.selector = this.selector + (this.selector ? " " : "") + selector;
196                 } else if ( name ) {
197                         ret.selector = this.selector + "." + name + "(" + selector + ")";
198                 }
199
200                 // Return the newly-formed element set
201                 return ret;
202         },
203
204         // Force the current matched set of elements to become
205         // the specified array of elements (destroying the stack in the process)
206         // You should use pushStack() in order to do this, but maintain the stack
207         setArray: function( elems ) {
208                 // Resetting the length to 0, then using the native Array push
209                 // is a super-fast way to populate an object with array-like properties
210                 this.length = 0;
211                 push.apply( this, elems );
212
213                 return this;
214         },
215
216         // Execute a callback for every element in the matched set.
217         // (You can seed the arguments with an array of args, but this is
218         // only used internally.)
219         each: function( callback, args ) {
220                 return jQuery.each( this, callback, args );
221         },
222         
223         ready: function( fn ) {
224                 // Attach the listeners
225                 jQuery.bindReady();
226
227                 // If the DOM is already ready
228                 if ( jQuery.isReady ) {
229                         // Execute the function immediately
230                         fn.call( document, jQuery );
231
232                 // Otherwise, remember the function for later
233                 } else if ( readyList ) {
234                         // Add the function to the wait list
235                         readyList.push( fn );
236                 }
237
238                 return this;
239         },
240         
241         eq: function( i ) {
242                 return i === -1 ?
243                         this.slice( i ) :
244                         this.slice( i, +i + 1 );
245         },
246
247         first: function() {
248                 return this.eq( 0 );
249         },
250
251         last: function() {
252                 return this.eq( -1 );
253         },
254
255         slice: function() {
256                 return this.pushStack( slice.apply( this, arguments ),
257                         "slice", slice.call(arguments).join(",") );
258         },
259
260         map: function( callback ) {
261                 return this.pushStack( jQuery.map(this, function( elem, i ) {
262                         return callback.call( elem, i, elem );
263                 }));
264         },
265         
266         end: function() {
267                 return this.prevObject || jQuery(null);
268         },
269
270         // For internal use only.
271         // Behaves like an Array's method, not like a jQuery method.
272         push: push,
273         sort: [].sort,
274         splice: [].splice
275 };
276
277 // Give the init function the jQuery prototype for later instantiation
278 jQuery.fn.init.prototype = jQuery.fn;
279
280 jQuery.extend = jQuery.fn.extend = function() {
281         // copy reference to target object
282         var target = arguments[0] || {}, i = 1, length = arguments.length, deep = false, options, name, src, copy;
283
284         // Handle a deep copy situation
285         if ( typeof target === "boolean" ) {
286                 deep = target;
287                 target = arguments[1] || {};
288                 // skip the boolean and the target
289                 i = 2;
290         }
291
292         // Handle case when target is a string or something (possible in deep copy)
293         if ( typeof target !== "object" && !jQuery.isFunction(target) ) {
294                 target = {};
295         }
296
297         // extend jQuery itself if only one argument is passed
298         if ( length === i ) {
299                 target = this;
300                 --i;
301         }
302
303         for ( ; i < length; i++ ) {
304                 // Only deal with non-null/undefined values
305                 if ( (options = arguments[ i ]) != null ) {
306                         // Extend the base object
307                         for ( name in options ) {
308                                 src = target[ name ];
309                                 copy = options[ name ];
310
311                                 // Prevent never-ending loop
312                                 if ( target === copy ) {
313                                         continue;
314                                 }
315
316                                 // Recurse if we're merging object literal values
317                                 if ( deep && copy && jQuery.isPlainObject(copy) ) {
318                                         // Don't extend not object literals
319                                         var clone = src && jQuery.isPlainObject(src) ? src : {};
320
321                                         // Never move original objects, clone them
322                                         target[ name ] = jQuery.extend( deep, clone, copy );
323
324                                 // Don't bring in undefined values
325                                 } else if ( copy !== undefined ) {
326                                         target[ name ] = copy;
327                                 }
328                         }
329                 }
330         }
331
332         // Return the modified object
333         return target;
334 };
335
336 jQuery.extend({
337         noConflict: function( deep ) {
338                 window.$ = _$;
339
340                 if ( deep ) {
341                         window.jQuery = _jQuery;
342                 }
343
344                 return jQuery;
345         },
346         
347         // Is the DOM ready to be used? Set to true once it occurs.
348         isReady: false,
349         
350         // Handle when the DOM is ready
351         ready: function() {
352                 // Make sure that the DOM is not already loaded
353                 if ( !jQuery.isReady ) {
354                         // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443).
355                         if ( !document.body ) {
356                                 return setTimeout( jQuery.ready, 13 );
357                         }
358
359                         // Remember that the DOM is ready
360                         jQuery.isReady = true;
361
362                         // If there are functions bound, to execute
363                         if ( readyList ) {
364                                 // Execute all of them
365                                 var fn, i = 0;
366                                 while ( (fn = readyList[ i++ ]) ) {
367                                         fn.call( document, jQuery );
368                                 }
369
370                                 // Reset the list of functions
371                                 readyList = null;
372                         }
373
374                         // Trigger any bound ready events
375                         if ( jQuery.fn.triggerHandler ) {
376                                 jQuery( document ).triggerHandler( "ready" );
377                         }
378                 }
379         },
380         
381         bindReady: function() {
382                 if ( readyBound ) {
383                         return;
384                 }
385
386                 readyBound = true;
387
388                 // Catch cases where $(document).ready() is called after the
389                 // browser event has already occurred.
390                 if ( document.readyState === "complete" ) {
391                         return jQuery.ready();
392                 }
393
394                 // Mozilla, Opera and webkit nightlies currently support this event
395                 if ( document.addEventListener ) {
396                         // Use the handy event callback
397                         document.addEventListener( "DOMContentLoaded", DOMContentLoaded, false );
398                         
399                         // A fallback to window.onload, that will always work
400                         window.addEventListener( "load", jQuery.ready, false );
401
402                 // If IE event model is used
403                 } else if ( document.attachEvent ) {
404                         // ensure firing before onload,
405                         // maybe late but safe also for iframes
406                         document.attachEvent("onreadystatechange", DOMContentLoaded);
407                         
408                         // A fallback to window.onload, that will always work
409                         window.attachEvent( "onload", jQuery.ready );
410
411                         // If IE and not a frame
412                         // continually check to see if the document is ready
413                         var toplevel = false;
414
415                         try {
416                                 toplevel = window.frameElement == null;
417                         } catch(e) {}
418
419                         if ( document.documentElement.doScroll && toplevel ) {
420                                 doScrollCheck();
421                         }
422                 }
423         },
424
425         // See test/unit/core.js for details concerning isFunction.
426         // Since version 1.3, DOM methods and functions like alert
427         // aren't supported. They return false on IE (#2968).
428         isFunction: function( obj ) {
429                 return toString.call(obj) === "[object Function]";
430         },
431
432         isArray: function( obj ) {
433                 return toString.call(obj) === "[object Array]";
434         },
435
436         isPlainObject: function( obj ) {
437                 // Must be an Object.
438                 // Because of IE, we also have to check the presence of the constructor property.
439                 // Make sure that DOM nodes and window objects don't pass through, as well
440                 if ( !obj || toString.call(obj) !== "[object Object]" || obj.nodeType || obj.setInterval ) {
441                         return false;
442                 }
443                 
444                 // Not own constructor property must be Object
445                 if ( obj.constructor
446                         && !hasOwnProperty.call(obj, "constructor")
447                         && !hasOwnProperty.call(obj.constructor.prototype, "isPrototypeOf") ) {
448                         return false;
449                 }
450                 
451                 // Own properties are enumerated firstly, so to speed up,
452                 // if last one is own, then all properties are own.
453         
454                 var key;
455                 for ( key in obj ) {}
456                 
457                 return key === undefined || hasOwnProperty.call( obj, key );
458         },
459
460         isEmptyObject: function( obj ) {
461                 for ( var name in obj ) {
462                         return false;
463                 }
464                 return true;
465         },
466
467         // Evalulates a script in a global context
468         globalEval: function( data ) {
469                 if ( data && rnotwhite.test(data) ) {
470                         // Inspired by code by Andrea Giammarchi
471                         // http://webreflection.blogspot.com/2007/08/global-scope-evaluation-and-dom.html
472                         var head = document.getElementsByTagName("head")[0] || document.documentElement,
473                                 script = document.createElement("script");
474
475                         script.type = "text/javascript";
476
477                         if ( jQuery.support.scriptEval ) {
478                                 script.appendChild( document.createTextNode( data ) );
479                         } else {
480                                 script.text = data;
481                         }
482
483                         // Use insertBefore instead of appendChild to circumvent an IE6 bug.
484                         // This arises when a base node is used (#2709).
485                         head.insertBefore( script, head.firstChild );
486                         head.removeChild( script );
487                 }
488         },
489
490         nodeName: function( elem, name ) {
491                 return elem.nodeName && elem.nodeName.toUpperCase() === name.toUpperCase();
492         },
493
494         // args is for internal usage only
495         each: function( object, callback, args ) {
496                 var name, i = 0,
497                         length = object.length,
498                         isObj = length === undefined || jQuery.isFunction(object);
499
500                 if ( args ) {
501                         if ( isObj ) {
502                                 for ( name in object ) {
503                                         if ( callback.apply( object[ name ], args ) === false ) {
504                                                 break;
505                                         }
506                                 }
507                         } else {
508                                 for ( ; i < length; ) {
509                                         if ( callback.apply( object[ i++ ], args ) === false ) {
510                                                 break;
511                                         }
512                                 }
513                         }
514
515                 // A special, fast, case for the most common use of each
516                 } else {
517                         if ( isObj ) {
518                                 for ( name in object ) {
519                                         if ( callback.call( object[ name ], name, object[ name ] ) === false ) {
520                                                 break;
521                                         }
522                                 }
523                         } else {
524                                 for ( var value = object[0];
525                                         i < length && callback.call( value, i, value ) !== false; value = object[++i] ) {}
526                         }
527                 }
528
529                 return object;
530         },
531
532         trim: function( text ) {
533                 return (text || "").replace( rtrim, "" );
534         },
535
536         // results is for internal usage only
537         makeArray: function( array, results ) {
538                 var ret = results || [];
539
540                 if ( array != null ) {
541                         // The window, strings (and functions) also have 'length'
542                         // The extra typeof function check is to prevent crashes
543                         // in Safari 2 (See: #3039)
544                         if ( array.length == null || typeof array === "string" || jQuery.isFunction(array) || (typeof array !== "function" && array.setInterval) ) {
545                                 push.call( ret, array );
546                         } else {
547                                 jQuery.merge( ret, array );
548                         }
549                 }
550
551                 return ret;
552         },
553
554         inArray: function( elem, array ) {
555                 if ( array.indexOf ) {
556                         return array.indexOf( elem );
557                 }
558
559                 for ( var i = 0, length = array.length; i < length; i++ ) {
560                         if ( array[ i ] === elem ) {
561                                 return i;
562                         }
563                 }
564
565                 return -1;
566         },
567
568         merge: function( first, second ) {
569                 var i = first.length, j = 0;
570
571                 if ( typeof second.length === "number" ) {
572                         for ( var l = second.length; j < l; j++ ) {
573                                 first[ i++ ] = second[ j ];
574                         }
575                 } else {
576                         while ( second[j] !== undefined ) {
577                                 first[ i++ ] = second[ j++ ];
578                         }
579                 }
580
581                 first.length = i;
582
583                 return first;
584         },
585
586         grep: function( elems, callback, inv ) {
587                 var ret = [];
588
589                 // Go through the array, only saving the items
590                 // that pass the validator function
591                 for ( var i = 0, length = elems.length; i < length; i++ ) {
592                         if ( !inv !== !callback( elems[ i ], i ) ) {
593                                 ret.push( elems[ i ] );
594                         }
595                 }
596
597                 return ret;
598         },
599
600         // arg is for internal usage only
601         map: function( elems, callback, arg ) {
602                 var ret = [], value;
603
604                 // Go through the array, translating each of the items to their
605                 // new value (or values).
606                 for ( var i = 0, length = elems.length; i < length; i++ ) {
607                         value = callback( elems[ i ], i, arg );
608
609                         if ( value != null ) {
610                                 ret[ ret.length ] = value;
611                         }
612                 }
613
614                 return ret.concat.apply( [], ret );
615         },
616
617         // Use of jQuery.browser is frowned upon.
618         // More details: http://docs.jquery.com/Utilities/jQuery.browser
619         browser: {
620                 version: (/.*?(?:firefox|safari|opera|msie)[\/ ]([\d.]+)/.exec(userAgent) || [0,"0"])[1],
621                 safari: /safari/.test( userAgent ),
622                 opera: /opera/.test( userAgent ),
623                 msie: /msie/.test( userAgent ) && !/opera/.test( userAgent ),
624                 firefox: /firefox/.test( userAgent )
625         }
626 });
627
628 // Deprecated
629 jQuery.browser.mozilla = /mozilla/.test( userAgent ) && !/(compatible|webkit)/.test( userAgent );
630
631 if ( indexOf ) {
632         jQuery.inArray = function( elem, array ) {
633                 return indexOf.call( array, elem );
634         };
635 }
636
637 // All jQuery objects should point back to these
638 rootjQuery = jQuery(document);
639
640 // Cleanup functions for the document ready method
641 if ( document.addEventListener ) {
642         DOMContentLoaded = function() {
643                 document.removeEventListener( "DOMContentLoaded", DOMContentLoaded, false );
644                 jQuery.ready();
645         };
646
647 } else if ( document.attachEvent ) {
648         DOMContentLoaded = function() {
649                 // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443).
650                 if ( document.readyState === "complete" ) {
651                         document.detachEvent( "onreadystatechange", DOMContentLoaded );
652                         jQuery.ready();
653                 }
654         };
655 }
656
657 // The DOM ready check for Internet Explorer
658 function doScrollCheck() {
659         if ( jQuery.isReady ) {
660                 return;
661         }
662
663         try {
664                 // If IE is used, use the trick by Diego Perini
665                 // http://javascript.nwbox.com/IEContentLoaded/
666                 document.documentElement.doScroll("left");
667         } catch( error ) {
668                 setTimeout( doScrollCheck, 1 );
669                 return;
670         }
671
672         // and execute any waiting functions
673         jQuery.ready();
674 }
675
676 if ( indexOf ) {
677         jQuery.inArray = function( elem, array ) {
678                 return indexOf.call( array, elem );
679         };
680 }
681
682 function evalScript( i, elem ) {
683         if ( elem.src ) {
684                 jQuery.ajax({
685                         url: elem.src,
686                         async: false,
687                         dataType: "script"
688                 });
689         } else {
690                 jQuery.globalEval( elem.text || elem.textContent || elem.innerHTML || "" );
691         }
692
693         if ( elem.parentNode ) {
694                 elem.parentNode.removeChild( elem );
695         }
696 }
697
698 // Mutifunctional method to get and set values to a collection
699 // The value/s can be optionally by executed if its a function
700 function access( elems, key, value, exec, fn, pass ) {
701         var length = elems.length;
702         
703         // Setting many attributes
704         if ( typeof key === "object" ) {
705                 for ( var k in key ) {
706                         access( elems, k, key[k], exec, fn, value );
707                 }
708                 return elems;
709         }
710         
711         // Setting one attribute
712         if ( value !== undefined ) {
713                 // Optionally, function values get executed if exec is true
714                 exec = exec && jQuery.isFunction(value);
715                 
716                 for ( var i = 0; i < length; i++ ) {
717                         fn( elems[i], key, exec ? value.call( elems[i], i ) : value, pass );
718                 }
719                 
720                 return elems;
721         }
722         
723         // Getting an attribute
724         return length ? fn( elems[0], key ) : null;
725 }
726
727 function now() {
728         return (new Date).getTime();
729 }