JQuery文档以及文件包

/* prevent execution of jQuery if included more than once */ if(typeof window.jQuery == "undefined") { /* * jQuery 1.1.1 - New Wave Javascript * * Copyright (c) 2007 John Resig (jquery.com) * Dual licensed under the MIT (MIT-LICENSE.txt) * and GPL (GPL-LICENSE.txt) licenses. * * $Date: 2007-01-22 00:27:54 -0500 (Mon, 22 Jan 2007) $ * $Rev: 1153 $ */ // Global undefined variable window.undefined = window.undefined; /** * Create a new jQuery Object * * @constructor * @private * @name jQuery * @param String|Function|Element|Array<Element>|jQuery a selector * @param jQuery|Element|Array<Element> c context * @cat Core */ var jQuery = function(a,c) { // If the context is global, return a new object if ( window == this ) return new jQuery(a,c); // Make sure that a selection was provided a = a || document; // HANDLE: $(function) // Shortcut for document ready if ( jQuery.isFunction(a) ) return new jQuery(document)[ jQuery.fn.ready ? "ready" : "load" ]( a ); // Handle HTML strings if ( typeof a == "string" ) { // HANDLE: $(html) -> $(array) var m = /^[^<]*(<(.|\n)+>)[^>]*$/.exec(a); if ( m ) a = jQuery.clean( [ m[1] ] ); // HANDLE: $(expr) else return new jQuery( c ).find( a ); } return this.setArray( // HANDLE: $(array) a.constructor == Array && a || // HANDLE: $(arraylike) // Watch for when an array-like object is passed as the selector (a.jquery || a.length && a != window && !a.nodeType && a[0] != undefined && a[0].nodeType) && jQuery.makeArray( a ) || // HANDLE: $(*) [ a ] ); }; // Map over the $ in case of overwrite if ( typeof $ != "undefined" ) jQuery._$ = $; // Map the jQuery namespace to the '$' one var $ = jQuery; /** * This function accepts a string containing a CSS or * basic XPath selector which is then used to match a set of elements. * * The core functionality of jQuery centers around this function. * Everything in jQuery is based upon this, or uses this in some way. * The most basic use of this function is to pass in an expression * (usually consisting of CSS or XPath), which then finds all matching * elements. * * By default, $() looks for DOM elements within the context of the * current HTML document. * * @example $("div > p") * @desc Finds all p elements that are children of a div element. * @before <p>one</p> <div><p>two</p></div> <p>three</p> * @result [ <p>two</p> ] * * @example $("input:radio", document.forms[0]) * @desc Searches for all inputs of type radio within the first form in the document * * @example $("div", xml.responseXML) * @desc This finds all div elements within the specified XML document. * * @name $ * @param String expr An expression to search with * @param Element|jQuery context (optional) A DOM Element, Document or jQuery to use as context * @cat Core * @type jQuery * @see $(Element) * @see $(Element<Array>) */ /** * Create DOM elements on-the-fly from the provided String of raw HTML. * * @example $("<div><p>Hello</p></div>").appendTo("#body") * @desc Creates a div element (and all of its contents) dynamically, * and appends it to the element with the ID of body. Internally, an * element is created and it's innerHTML property set to the given markup. * It is therefore both quite flexible and limited. * * @name $ * @param String html A string of HTML to create on the fly. * @cat Core * @type jQuery * @see appendTo(String) */ /** * Wrap jQuery functionality around a single or multiple DOM Element(s). * * This function also accepts XML Documents and Window objects * as valid arguments (even though they are not DOM Elements). * * @example $(document.body).background( "black" ); * @desc Sets the background color of the page to black. * * @example $( myForm.elements ).hide() * @desc Hides all the input elements within a form * * @name $ * @param Element|Array<Element> elems DOM element(s) to be encapsulated by a jQuery object. * @cat Core * @type jQuery */ /** * A shorthand for $(document).ready(), allowing you to bind a function * to be executed when the DOM document has finished loading. This function * behaves just like $(document).ready(), in that it should be used to wrap * all of the other $() operations on your page. While this function is, * technically, chainable - there really isn't much use for chaining against it. * You can have as many $(document).ready events on your page as you like. * * See ready(Function) for details about the ready event. * * @example $(function(){ * // Document is ready * }); * @desc Executes the function when the DOM is ready to be used. * * @example jQuery(function($) { * // Your code using failsafe $ alias here... * }); * @desc Uses both the shortcut for $(document).ready() and the argument * to write failsafe jQuery code using the $ alias, without relying on the * global alias. * * @name $ * @param Function fn The function to execute when the DOM is ready. * @cat Core * @type jQuery * @see ready(Function) */ jQuery.fn = jQuery.prototype = { /** * The current version of jQuery. * * @private * @property * @name jquery * @type String * @cat Core */ jquery: "1.1.1", /** * The number of elements currently matched. * * @example $("img").length; * @before <img src="test1.jpg"/> <img src="test2.jpg"/> * @result 2 * * @property * @name length * @type Number * @cat Core */ /** * The number of elements currently matched. * * @example $("img").size(); * @before <img src="test1.jpg"/> <img src="test2.jpg"/> * @result 2 * * @name size * @type Number * @cat Core */ size: function() { return this.length; }, length: 0, /** * Access all matched elements. This serves as a backwards-compatible * way of accessing all matched elements (other than the jQuery object * itself, which is, in fact, an array of elements). * * @example $("img").get(); * @before <img src="test1.jpg"/> <img src="test2.jpg"/> * @result [ <img src="test1.jpg"/> <img src="test2.jpg"/> ] * @desc Selects all images in the document and returns the DOM Elements as an Array * * @name get * @type Array<Element> * @cat Core */ /** * Access a single matched element. num is used to access the * Nth element matched. * * @example $("img").get(0); * @before <img src="test1.jpg"/> <img src="test2.jpg"/> * @result [ <img src="test1.jpg"/> ] * @desc Selects all images in the document and returns the first one * * @name get * @type Element * @param Number num Access the element in the Nth position. * @cat Core */ get: function( num ) { return num == undefined ? // Return a 'clean' array jQuery.makeArray( this ) : // Return just the object this[num]; }, /** * Set the jQuery object to an array of elements, while maintaining * the stack. * * @example $("img").pushStack([ document.body ]); * @result $("img").pushStack() == [ document.body ] * * @private * @name pushStack * @type jQuery * @param Elements elems An array of elements * @cat Core */ pushStack: function( a ) { var ret = jQuery(this); ret.prevObject = this; return ret.setArray( a ); }, /** * Set the jQuery object to an array of elements. This operation is * completely destructive - be sure to use .pushStack() if you wish to maintain * the jQuery stack. * * @example $("img").setArray([ document.body ]); * @result $("img").setArray() == [ document.body ] * * @private * @name setArray * @type jQuery * @param Elements elems An array of elements * @cat Core */ setArray: function( a ) { this.length = 0; [].push.apply( this, a ); return this; }, /** * Execute a function within the context of every matched element. * This means that every time the passed-in function is executed * (which is once for every element matched) the 'this' keyword * points to the specific element. * * Additionally, the f