mirror of
https://github.com/jquery/jquery.git
synced 2024-11-23 02:54:22 +00:00
565 lines
14 KiB
JavaScript
565 lines
14 KiB
JavaScript
// Define a local copy of jQuery
|
|
var jQuery = function( selector, context ) {
|
|
// The jQuery object is actually just the init constructor 'enhanced'
|
|
return arguments.length === 0 ?
|
|
rootjQuery :
|
|
new jQuery.fn.init( selector, context );
|
|
},
|
|
|
|
// Map over jQuery in case of overwrite
|
|
_jQuery = window.jQuery,
|
|
|
|
// Map over the $ in case of overwrite
|
|
_$ = window.$,
|
|
|
|
// Use the correct document accordingly with window argument (sandbox)
|
|
document = window.document,
|
|
|
|
// A central reference to the root jQuery(document)
|
|
rootjQuery,
|
|
|
|
// A simple way to check for HTML strings or ID strings
|
|
// (both of which we optimize for)
|
|
quickExpr = /^[^<]*(<[\w\W]+>)[^>]*$|^#([\w-]+)$/,
|
|
|
|
// Is it a simple selector
|
|
isSimple = /^.[^:#\[\.,]*$/,
|
|
|
|
// Check if a string has a non-whitespace character in it
|
|
rnotwhite = /\S/,
|
|
|
|
// Used for trimming whitespace
|
|
rtrim = /^\s+|\s+$/g,
|
|
|
|
// Match a standalone tag
|
|
rsingleTag = /<(\w+)\s*\/?>(?:<\/\1>)?$/,
|
|
|
|
// Keep a UserAgent string for use with jQuery.browser
|
|
userAgent = navigator.userAgent.toLowerCase(),
|
|
|
|
// Save a reference to some core methods
|
|
toString = Object.prototype.toString,
|
|
hasOwnProperty = Object.prototype.hasOwnProperty,
|
|
push = Array.prototype.push,
|
|
slice = Array.prototype.slice,
|
|
indexOf = Array.prototype.indexOf;
|
|
|
|
jQuery.fn = jQuery.prototype = {
|
|
init: function( selector, context ) {
|
|
var match, elem, ret, doc;
|
|
|
|
// Handle $(""), $(null), or $(undefined)
|
|
if ( !selector ) {
|
|
return this;
|
|
}
|
|
|
|
// Handle $(DOMElement)
|
|
if ( selector.nodeType ) {
|
|
this.context = this[0] = selector;
|
|
this.length = 1;
|
|
return this;
|
|
}
|
|
|
|
// Handle HTML strings
|
|
if ( typeof selector === "string" ) {
|
|
// Are we dealing with HTML string or an ID?
|
|
match = quickExpr.exec( selector );
|
|
|
|
// Verify a match, and that no context was specified for #id
|
|
if ( match && (match[1] || !context) ) {
|
|
|
|
// HANDLE: $(html) -> $(array)
|
|
if ( match[1] ) {
|
|
doc = (context ? context.ownerDocument || context : document);
|
|
|
|
// If a single string is passed in and it's a single tag
|
|
// just do a createElement and skip the rest
|
|
ret = rsingleTag.exec( selector );
|
|
|
|
if ( ret ) {
|
|
selector = [ doc.createElement( ret[1] ) ];
|
|
|
|
} else {
|
|
ret = buildFragment( [ match[1] ], [ doc ] );
|
|
selector = (ret.cacheable ? ret.fragment.cloneNode(true) : ret.fragment).childNodes;
|
|
}
|
|
|
|
// HANDLE: $("#id")
|
|
} else {
|
|
elem = document.getElementById( match[2] );
|
|
|
|
if ( elem ) {
|
|
// Handle the case where IE and Opera return items
|
|
// by name instead of ID
|
|
if ( elem.id !== match[2] ) {
|
|
return rootjQuery.find( selector );
|
|
}
|
|
|
|
// Otherwise, we inject the element directly into the jQuery object
|
|
this.length = 1;
|
|
this[0] = elem;
|
|
}
|
|
|
|
this.context = document;
|
|
this.selector = selector;
|
|
return this;
|
|
}
|
|
|
|
// HANDLE: $("TAG")
|
|
} else if ( !context && /^\w+$/.test( selector ) ) {
|
|
this.selector = selector;
|
|
this.context = document;
|
|
selector = document.getElementsByTagName( selector );
|
|
|
|
// HANDLE: $(expr, $(...))
|
|
} else if ( !context || context.jquery ) {
|
|
return (context || rootjQuery).find( selector );
|
|
|
|
// HANDLE: $(expr, context)
|
|
// (which is just equivalent to: $(context).find(expr)
|
|
} else {
|
|
return jQuery( context ).find( selector );
|
|
}
|
|
|
|
// HANDLE: $(function)
|
|
// Shortcut for document ready
|
|
} else if ( jQuery.isFunction( selector ) ) {
|
|
return rootjQuery.ready( selector );
|
|
}
|
|
|
|
if (selector.selector !== undefined) {
|
|
this.selector = selector.selector;
|
|
this.context = selector.context;
|
|
}
|
|
|
|
return this.setArray(jQuery.isArray( selector ) ?
|
|
selector :
|
|
jQuery.makeArray(selector));
|
|
},
|
|
|
|
// Start with an empty selector
|
|
selector: "",
|
|
|
|
// The current version of jQuery being used
|
|
jquery: "@VERSION",
|
|
|
|
// The default length of a jQuery object is 0
|
|
length: 0,
|
|
|
|
// The number of elements contained in the matched element set
|
|
size: function() {
|
|
return this.length;
|
|
},
|
|
|
|
toArray: function(){
|
|
return slice.call( this, 0 );
|
|
},
|
|
|
|
// Get the Nth element in the matched element set OR
|
|
// Get the whole matched element set as a clean array
|
|
get: function( num ) {
|
|
return num == null ?
|
|
|
|
// Return a 'clean' array
|
|
this.toArray() :
|
|
|
|
// Return just the object
|
|
( num < 0 ? this.slice(num)[ 0 ] : this[ num ] );
|
|
},
|
|
|
|
// Take an array of elements and push it onto the stack
|
|
// (returning the new matched element set)
|
|
pushStack: function( elems, name, selector ) {
|
|
// Build a new jQuery matched element set
|
|
var ret = jQuery( elems || null );
|
|
|
|
// Add the old object onto the stack (as a reference)
|
|
ret.prevObject = this;
|
|
|
|
ret.context = this.context;
|
|
|
|
if ( name === "find" ) {
|
|
ret.selector = this.selector + (this.selector ? " " : "") + selector;
|
|
} else if ( name ) {
|
|
ret.selector = this.selector + "." + name + "(" + selector + ")";
|
|
}
|
|
|
|
// Return the newly-formed element set
|
|
return ret;
|
|
},
|
|
|
|
// Force the current matched set of elements to become
|
|
// the specified array of elements (destroying the stack in the process)
|
|
// You should use pushStack() in order to do this, but maintain the stack
|
|
setArray: function( elems ) {
|
|
// Resetting the length to 0, then using the native Array push
|
|
// is a super-fast way to populate an object with array-like properties
|
|
this.length = 0;
|
|
push.apply( this, elems );
|
|
|
|
return this;
|
|
},
|
|
|
|
// Execute a callback for every element in the matched set.
|
|
// (You can seed the arguments with an array of args, but this is
|
|
// only used internally.)
|
|
each: function( callback, args ) {
|
|
return jQuery.each( this, callback, args );
|
|
},
|
|
|
|
// Determine the position of an element within
|
|
// the matched set of elements
|
|
index: function( elem ) {
|
|
if ( !elem || typeof elem === "string" ) {
|
|
return jQuery.inArray( this[0],
|
|
// If it receives a string, the selector is used
|
|
// If it receives nothing, the siblings are used
|
|
elem ? jQuery( elem ) : this.parent().children() );
|
|
}
|
|
// Locate the position of the desired element
|
|
return jQuery.inArray(
|
|
// If it receives a jQuery object, the first element is used
|
|
elem.jquery ? elem[0] : elem, this );
|
|
},
|
|
|
|
is: function( selector ) {
|
|
return !!selector && jQuery.filter( selector, this ).length > 0;
|
|
},
|
|
|
|
// For internal use only.
|
|
// Behaves like an Array's method, not like a jQuery method.
|
|
push: push,
|
|
sort: [].sort,
|
|
splice: [].splice
|
|
};
|
|
|
|
// Give the init function the jQuery prototype for later instantiation
|
|
jQuery.fn.init.prototype = jQuery.fn;
|
|
|
|
jQuery.extend = jQuery.fn.extend = function() {
|
|
// copy reference to target object
|
|
var target = arguments[0] || {}, i = 1, length = arguments.length, deep = false, options, name, src, copy;
|
|
|
|
// Handle a deep copy situation
|
|
if ( typeof target === "boolean" ) {
|
|
deep = target;
|
|
target = arguments[1] || {};
|
|
// skip the boolean and the target
|
|
i = 2;
|
|
}
|
|
|
|
// Handle case when target is a string or something (possible in deep copy)
|
|
if ( typeof target !== "object" && !jQuery.isFunction(target) ) {
|
|
target = {};
|
|
}
|
|
|
|
// extend jQuery itself if only one argument is passed
|
|
if ( length === i ) {
|
|
target = this;
|
|
--i;
|
|
}
|
|
|
|
for ( ; i < length; i++ ) {
|
|
// Only deal with non-null/undefined values
|
|
if ( (options = arguments[ i ]) != null ) {
|
|
// Extend the base object
|
|
for ( name in options ) {
|
|
src = target[ name ];
|
|
copy = options[ name ];
|
|
|
|
// Prevent never-ending loop
|
|
if ( target === copy ) {
|
|
continue;
|
|
}
|
|
|
|
// Recurse if we're merging object values
|
|
if ( deep && copy && typeof copy === "object" && !copy.nodeType ) {
|
|
var clone;
|
|
|
|
if ( src ) {
|
|
clone = src;
|
|
} else if ( jQuery.isArray(copy) ) {
|
|
clone = [];
|
|
} else if ( jQuery.isObjectLiteral(copy) ) {
|
|
clone = {};
|
|
} else {
|
|
clone = copy;
|
|
}
|
|
|
|
// Never move original objects, clone them
|
|
target[ name ] = jQuery.extend( deep, clone, copy );
|
|
|
|
// Don't bring in undefined values
|
|
} else if ( copy !== undefined ) {
|
|
target[ name ] = copy;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Return the modified object
|
|
return target;
|
|
};
|
|
|
|
jQuery.extend({
|
|
noConflict: function( deep ) {
|
|
window.$ = _$;
|
|
|
|
if ( deep ) {
|
|
window.jQuery = _jQuery;
|
|
}
|
|
|
|
return jQuery;
|
|
},
|
|
|
|
// See test/unit/core.js for details concerning isFunction.
|
|
// Since version 1.3, DOM methods and functions like alert
|
|
// aren't supported. They return false on IE (#2968).
|
|
isFunction: function( obj ) {
|
|
return toString.call(obj) === "[object Function]";
|
|
},
|
|
|
|
isArray: function( obj ) {
|
|
return toString.call(obj) === "[object Array]";
|
|
},
|
|
|
|
isObjectLiteral: function( obj ) {
|
|
if ( toString.call(obj) !== "[object Object]" ) {
|
|
return false;
|
|
}
|
|
|
|
//own properties are iterated firstly,
|
|
//so to speed up, we can test last one if it is own or not
|
|
|
|
var key;
|
|
for ( key in obj ) {}
|
|
|
|
return !key || hasOwnProperty.call( obj, key );
|
|
},
|
|
|
|
isEmptyObject: function( obj ) {
|
|
for ( var name in obj ) {
|
|
return false;
|
|
}
|
|
return true;
|
|
},
|
|
|
|
// check if an element is in a (or is an) XML document
|
|
isXMLDoc: function( elem ) {
|
|
// documentElement is verified for cases where it doesn't yet exist
|
|
// (such as loading iframes in IE - #4833)
|
|
var documentElement = (elem ? elem.ownerDocument || elem : 0).documentElement;
|
|
return documentElement ? documentElement.nodeName !== "HTML" : false;
|
|
},
|
|
|
|
// Evalulates a script in a global context
|
|
globalEval: function( data ) {
|
|
if ( data && rnotwhite.test(data) ) {
|
|
// Inspired by code by Andrea Giammarchi
|
|
// http://webreflection.blogspot.com/2007/08/global-scope-evaluation-and-dom.html
|
|
var head = document.getElementsByTagName("head")[0] || document.documentElement,
|
|
script = document.createElement("script");
|
|
|
|
script.type = "text/javascript";
|
|
|
|
if ( jQuery.support.scriptEval ) {
|
|
script.appendChild( document.createTextNode( data ) );
|
|
} else {
|
|
script.text = data;
|
|
}
|
|
|
|
// Use insertBefore instead of appendChild to circumvent an IE6 bug.
|
|
// This arises when a base node is used (#2709).
|
|
head.insertBefore( script, head.firstChild );
|
|
head.removeChild( script );
|
|
}
|
|
},
|
|
|
|
nodeName: function( elem, name ) {
|
|
return elem.nodeName && elem.nodeName.toUpperCase() === name.toUpperCase();
|
|
},
|
|
|
|
// args is for internal usage only
|
|
each: function( object, callback, args ) {
|
|
var name, i = 0,
|
|
length = object.length,
|
|
isObj = length === undefined || jQuery.isFunction(object);
|
|
|
|
if ( args ) {
|
|
if ( isObj ) {
|
|
for ( name in object ) {
|
|
if ( callback.apply( object[ name ], args ) === false ) {
|
|
break;
|
|
}
|
|
}
|
|
} else {
|
|
for ( ; i < length; ) {
|
|
if ( callback.apply( object[ i++ ], args ) === false ) {
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
// A special, fast, case for the most common use of each
|
|
} else {
|
|
if ( isObj ) {
|
|
for ( name in object ) {
|
|
if ( callback.call( object[ name ], name, object[ name ] ) === false ) {
|
|
break;
|
|
}
|
|
}
|
|
} else {
|
|
for ( var value = object[0];
|
|
i < length && callback.call( value, i, value ) !== false; value = object[++i] ) {}
|
|
}
|
|
}
|
|
|
|
return object;
|
|
},
|
|
|
|
trim: function( text ) {
|
|
return (text || "").replace( rtrim, "" );
|
|
},
|
|
|
|
makeArray: function( array ) {
|
|
var ret = [], i;
|
|
|
|
if ( array != null ) {
|
|
i = array.length;
|
|
|
|
// The window, strings (and functions) also have 'length'
|
|
if ( i == null || typeof array === "string" || jQuery.isFunction(array) || array.setInterval ) {
|
|
ret[0] = array;
|
|
} else {
|
|
while ( i ) {
|
|
ret[--i] = array[i];
|
|
}
|
|
}
|
|
}
|
|
|
|
return ret;
|
|
},
|
|
|
|
inArray: function( elem, array ) {
|
|
for ( var i = 0, length = array.length; i < length; i++ ) {
|
|
if ( array[ i ] === elem ) {
|
|
return i;
|
|
}
|
|
}
|
|
|
|
return -1;
|
|
},
|
|
|
|
merge: function( first, second ) {
|
|
// We have to loop this way because IE & Opera overwrite the length
|
|
// expando of getElementsByTagName
|
|
var i = 0, elem, pos = first.length;
|
|
|
|
while ( (elem = second[ i++ ]) != null ) {
|
|
first[ pos++ ] = elem;
|
|
}
|
|
|
|
return first;
|
|
},
|
|
|
|
grep: function( elems, callback, inv ) {
|
|
var ret = [];
|
|
|
|
// Go through the array, only saving the items
|
|
// that pass the validator function
|
|
for ( var i = 0, length = elems.length; i < length; i++ ) {
|
|
if ( !inv !== !callback( elems[ i ], i ) ) {
|
|
ret.push( elems[ i ] );
|
|
}
|
|
}
|
|
|
|
return ret;
|
|
},
|
|
|
|
map: function( elems, callback ) {
|
|
var ret = [], value;
|
|
|
|
// Go through the array, translating each of the items to their
|
|
// new value (or values).
|
|
for ( var i = 0, length = elems.length; i < length; i++ ) {
|
|
value = callback( elems[ i ], i );
|
|
|
|
if ( value != null ) {
|
|
ret[ ret.length ] = value;
|
|
}
|
|
}
|
|
|
|
return ret.concat.apply( [], ret );
|
|
},
|
|
|
|
// Use of jQuery.browser is deprecated.
|
|
// It's included for backwards compatibility and plugins,
|
|
// although they should work to migrate away.
|
|
browser: {
|
|
version: (/.+(?:rv|it|ra|ie)[\/: ]([\d.]+)/.exec(userAgent) || [0,'0'])[1],
|
|
safari: /webkit/.test( userAgent ),
|
|
opera: /opera/.test( userAgent ),
|
|
msie: /msie/.test( userAgent ) && !/opera/.test( userAgent ),
|
|
mozilla: /mozilla/.test( userAgent ) && !/(compatible|webkit)/.test( userAgent )
|
|
}
|
|
});
|
|
|
|
if ( indexOf ) {
|
|
jQuery.inArray = function( elem, array ) {
|
|
return indexOf.call( array, elem );
|
|
};
|
|
}
|
|
|
|
// All jQuery objects should point back to these
|
|
rootjQuery = jQuery(document);
|
|
|
|
function evalScript( i, elem ) {
|
|
if ( elem.src ) {
|
|
jQuery.ajax({
|
|
url: elem.src,
|
|
async: false,
|
|
dataType: "script"
|
|
});
|
|
} else {
|
|
jQuery.globalEval( elem.text || elem.textContent || elem.innerHTML || "" );
|
|
}
|
|
|
|
if ( elem.parentNode ) {
|
|
elem.parentNode.removeChild( elem );
|
|
}
|
|
}
|
|
|
|
// Mutifunctional method to get and set values to a collection
|
|
// The value/s can be optionally by executed if its a function
|
|
function access( elems, key, value, exec, fn ) {
|
|
var l = elems.length;
|
|
|
|
// Setting many attributes
|
|
if ( typeof key === "object" ) {
|
|
for (var k in key) {
|
|
access(elems, k, key[k], exec, fn);
|
|
}
|
|
return elems;
|
|
}
|
|
|
|
// Setting one attribute
|
|
if (value !== undefined) {
|
|
// Optionally, function values get executed if exec is true
|
|
exec = exec && jQuery.isFunction(value);
|
|
|
|
for (var i = 0; i < l; i++) {
|
|
var elem = elems[i],
|
|
val = exec ? value.call(elem, i) : value;
|
|
fn(elem, key, val);
|
|
}
|
|
return elems;
|
|
}
|
|
|
|
// Getting an attribute
|
|
return l ? fn(elems[0], key) : null;
|
|
}
|
|
|
|
function now() {
|
|
return (new Date).getTime();
|
|
}
|