/*!
* jQuery JavaScript Library v1.3.1
* http://jquery.com/
*
* Copyright (c) 2009 John Resig
* Dual licensed under the MIT and GPL licenses.
* http://docs.jquery.com/License
*
* Date: 2009-01-21 20:42:16 -0500 (Wed, 21 Jan 2009)
* Revision: 6158
*/
(function() {
var
// Will speed up references to window, and allows munging its name.
window = this,
// Will speed up references to undefined, and allows munging its name.
undefined,
// Map over jQuery in case of overwrite
_jQuery = window.jQuery,
// Map over the $ in case of overwrite
_$ = window.$,
jQuery = window.jQuery = window.$ = function(selector, context) {
///
/// 1: $(expression, context) - 这个函数接收一个包含 CSS 选择器的字符串,然后用这个字符串去匹配一组元素。
/// 2: $(html) - 根据提供的原始 HTML 标记字符串,动态创建由 jQuery 对象包装的 DOM 元素。
/// 3: $(elements) - 将一个或多个DOM元素转化为jQuery对象。
/// 4: $(callback) - $(document).ready()的简写。
///
///
/// 1: expression - 用来查找的表达式。
/// 2: html -用于动态创建DOM元素的HTML标记字符串
/// 3: elements - 用于封装成jQuery对象的DOM元素
/// 4: callback - 当DOM加载完成后,执行其中的函数。
///
///
/// 1: context - (可选) 作为待查找的 DOM 元素集、文档或 jQuery 对象。
///
///
// The jQuery object is actually just the init constructor 'enhanced'
return new jQuery.fn.init(selector, context);
},
// A simple way to check for HTML strings or ID strings
// (both of which we optimize for)
quickExpr = /^[^<]*(<(.|\s)+>)[^>]*$|^#([\w-]+)$/,
// Is it a simple selector
isSimple = /^.[^:#\[\.,]*$/;
jQuery.fn = jQuery.prototype = {
init: function(selector, context) {
///
/// 1: $(expression, context) - 这个函数接收一个包含 CSS 选择器的字符串,然后用这个字符串去匹配一组元素。
/// 2: $(html) - 根据提供的原始 HTML 标记字符串,动态创建由 jQuery 对象包装的 DOM 元素。
/// 3: $(elements) - 将一个或多个DOM元素转化为jQuery对象。
/// 4: $(callback) - $(document).ready()的简写。
///
///
/// 1: expression - 用来查找的表达式。
/// 2: html -用于动态创建DOM元素的HTML标记字符串
/// 3: elements - 用于封装成jQuery对象的DOM元素
/// 4: callback - 当DOM加载完成后,执行其中的函数。
///
///
/// 1: context - (可选) 作为待查找的 DOM 元素集、文档或 jQuery 对象。
///
///
// Make sure that a selection was provided
selector = selector || document;
// Handle $(DOMElement)
if (selector.nodeType) {
this[0] = selector;
this.length = 1;
this.context = selector;
return this;
}
// Handle HTML strings
if (typeof selector === "string") {
// Are we dealing with HTML string or an ID?
var 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])
selector = jQuery.clean([match[1]], context);
// HANDLE: $("#id")
else {
var elem = document.getElementById(match[3]);
// Handle the case where IE and Opera return items
// by name instead of ID
if (elem && elem.id != match[3])
return jQuery().find(selector);
// Otherwise, we inject the element directly into the jQuery object
var ret = jQuery(elem || []);
ret.context = document;
ret.selector = selector;
return ret;
}
// HANDLE: $(expr, [context])
// (which is just equivalent to: $(content).find(expr)
} else
return jQuery(context).find(selector);
// HANDLE: $(function)
// Shortcut for document ready
} else if (jQuery.isFunction(selector))
return jQuery(document).ready(selector);
// Make sure that old selector state is passed along
if (selector.selector && selector.context) {
this.selector = selector.selector;
this.context = selector.context;
}
return this.setArray(jQuery.makeArray(selector));
},
// Start with an empty selector
selector: "",
// The current version of jQuery being used
jquery: "1.3.1",
// The number of elements contained in the matched element set
size: function() {
///
/// The number of elements currently matched.
/// Part of Core
///
///
return this.length;
},
// Get the Nth element in the matched element set OR
// Get the whole matched element set as a clean array
get: function(num) {
///
/// Access a single matched element. num is used to access the
/// Nth element matched.
/// Part of Core
///
///
///
/// Access the element in the Nth position.
///
return num === undefined ?
// Return a 'clean' array
jQuery.makeArray(this) :
// Return just the object
this[num];
},
// Take an array of elements and push it onto the stack
// (returning the new matched element set)
pushStack: function(elems, name, selector) {
///
/// Set the jQuery object to an array of elements, while maintaining
/// the stack.
/// Part of Core
///
///
///
/// An array of elements
///
// Build a new jQuery matched element set
var ret = jQuery(elems);
// 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) {
///
/// 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.
/// Part of Core
///
///
///
/// An array of elements
///
// 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;
Array.prototype.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) {
///
/// 以每一个匹配的元素作为上下文来执行一个函数。
/// 意味着,每次执行传递进来的函数时,
/// 函数中的this关键字都指向一个不同的DOM元素
/// (每次都是一个不同的匹配元素)。
/// 而且,在每次执行函数时,
/// 都会给函数传递一个表示作为执行环境的元素在匹配的元素集合中所处位置的数字值作为参数
/// (从零开始的整形)。
///
///
///
/// 对于每个匹配的元素所要执行的函数
///
return jQuery.each(this, callback, args);
},
// Determine the position of an element within
// the matched set of elements
index: function(elem) {
///
/// 搜索与参数表示的对象匹配的元素,
/// 并返回相应元素的索引值值。
/// 如果找到了匹配的元素,从0开始返回;如果没有找到匹配的元素,返回-1。
/// Part of Core
///
///
///
/// 要搜索的对象
///
// Locate the position of the desired element
return jQuery.inArray(
// If it receives a jQuery object, the first element is used
elem && elem.jquery ? elem[0] : elem
, this);
},
attr: function(name, value, type) {
///
/// 为所有匹配的元素设置一个计算的属性值。
/// 不提供值,而是提供一个函数,由这个函数计算的值作为属性值。
/// Part of DOM/Attributes
///
///
///
/// 属性名称
///
///
/// 返回值的函数 范围:当前元素, 参数: 当前元素的索引值
///
var options = name;
// Look for the case where we're accessing a style value
if (typeof name === "string")
if (value === undefined)
return this[0] && jQuery[type || "attr"](this[0], name);
else {
options = {};
options[name] = value;
}
// Check to see if we're setting style values
return this.each(function(i) {
// Set all the styles
for (name in options)
jQuery.attr(
type ?
this.style :
this,
name, jQuery.prop(this, options[name], type, i, name)
);
});
},
css: function(key, value) {
///
/// 在所有匹配的元素中,设置一个样式属性的值。
/// 数字将自动转化为像素值
/// Part of CSS
///
///
///
/// 属性名
///
///
/// 属性值
///
// ignore negative width and height values
if ((key == 'width' || key == 'height') && parseFloat(value) < 0)
value = undefined;
return this.attr(key, value, "curCSS");
},
text: function(text) {
///
/// 设置所有匹配元素的文本内容
/// 与 html() 类似, 但将编码 HTML (将 "<" 和 ">" 替换成相应的HTML实体)。
/// Part of DOM/Attributes
///
///
///
/// 用于设置元素内容的文本
///
if (typeof text !== "object" && text != null)
return this.empty().append((this[0] && this[0].ownerDocument || document).createTextNode(text));
var ret = "";
jQuery.each(text || this, function() {
jQuery.each(this.childNodes, function() {
if (this.nodeType != 8)
ret += this.nodeType != 1 ?
this.nodeValue :
jQuery.fn.text([this]);
});
});
return ret;
},
wrapAll: function(html) {
///
/// 将所有匹配的元素用单个元素包裹起来
/// 这于 '.wrap()' 是不同的,
/// '.wrap()'为每一个匹配的元素都包裹一次。
/// 这种包装对于在文档中插入额外的结构化标记最有用,
/// 而且它不会破坏原始文档的语义品质。
/// 这个函数的原理是检查提供的第一个元素并在它的代码结构中找到最上层的祖先元素--这个祖先元素就是包装元素。
/// Part of DOM/Manipulation
///
///
///
/// HTML标记代码字符串,用于动态生成元素并包装目标元素
///
if (this[0]) {
// The elements to wrap the target around
var wrap = jQuery(html, this[0].ownerDocument).clone();
if (this[0].parentNode)
wrap.insertBefore(this[0]);
wrap.map(function() {
var elem = this;
while (elem.firstChild)
elem = elem.firstChild;
return elem;
}).append(this);
}
return this;
},
wrapInner: function(html) {
///
/// 将每一个匹配的元素的子内容(包括文本节点)用一个HTML结构包裹起来。
///
///
/// HTML标记代码字符串,用于动态生成元素并包装目标元素
///
///
return this.each(function() {
jQuery(this).contents().wrapAll(html);
});
},
wrap: function(html) {
///
/// 把所有匹配的元素用其他元素的结构化标记包裹起来。
/// 这种包装对于在文档中插入额外的结构化标记最有用,
/// 而且它不会破坏原始文档的语义品质。
/// 这个函数的原理是检查提供的第一个元素
/// (它是由所提供的HTML标记代码动态生成的),
/// 并在它的代码结构中找到最上层的祖先元素--这个祖先元素就是包裹元素。
/// 当HTML标记代码中的元素包含文本时无法使用这个函数。
/// 因此,如果要添加文本应该在包裹完成之后再行添加。
/// Part of DOM/Manipulation
///
///
///
/// HTML标记代码字符串,用于动态生成元素并包裹目标元素
///
return this.each(function() {
jQuery(this).wrapAll(html);
});
},
append: function() {
///
/// 向每个匹配的元素内部追加内容。
/// 这个操作与对指定的元素执行appendChild方法,
/// 将它们添加到文档中的情况类似。
/// Part of DOM/Manipulation
///
///
///
/// 要追加到目标中的内容
///
return this.domManip(arguments, true, function(elem) {
if (this.nodeType == 1)
this.appendChild(elem);
});
},
prepend: function() {
///
/// 向每个匹配的元素内部前置内容。
/// 这是向所有匹配元素内部的开始处插入内容的最佳方式。
/// Part of DOM/Manipulation
///
///
///
/// 要插入到目标元素内部前端的内容
///
return this.domManip(arguments, true, function(elem) {
if (this.nodeType == 1)
this.insertBefore(elem, this.firstChild);
});
},
before: function() {
///
/// 在每个匹配的元素之前插入内容。
/// Part of DOM/Manipulation
///
///
///
/// 在所有段落之前插入一些HTML标记代码。
///
return this.domManip(arguments, false, function(elem) {
this.parentNode.insertBefore(elem, this);
});
},
after: function() {
///
/// 在每个匹配的元素之后插入内容。
/// Part of DOM/Manipulation
///
///
///
/// 插入到每个目标后的内容
///
return this.domManip(arguments, false, function(elem) {
this.parentNode.insertBefore(elem, this.nextSibling);
});
},
end: function() {
///
/// 回到最近的一个"破坏性"操作之前。
/// 即,将匹配的元素列表变为前一次的状态。
/// 如果之前没有破坏性操作,则返回一个空集。
/// 所谓的"破坏性"就是指任何改变所匹配的jQuery元素的操作。
/// 这包括在 Traversing 中任何返回一个jQuery对象的函数--'add', 'andSelf', 'children', 'filter'
/// , 'find', 'map', 'next', 'nextAll', 'not', 'parent', 'parents', 'prev', 'prevAll'
/// , 'siblings' and 'slice'--再加上 Manipulation 中的 'clone'。
/// Part of DOM/Traversing
///
///
return this.prevObject || jQuery([]);
},
// For internal use only.
// Behaves like an Array's .push method, not like a jQuery method.
push: [].push,
find: function(selector) {
///
/// 搜索所有与指定表达式匹配的元素。
/// 这个函数是找出正在处理的元素的后代元素的好方法。
/// 所有搜索都依靠jQuery表达式来完成。
/// 这个表达式可以使用CSS1-3的选择器,或简单的XPATH语法来写。
/// Part of DOM/Traversing
///
///
///
/// 用于查找的表达式
///
///
if (this.length === 1 && !/,/.test(selector)) {
var ret = this.pushStack([], "find", selector);
ret.length = 0;
jQuery.find(selector, this[0], ret);
return ret;
} else {
var elems = jQuery.map(this, function(elem) {
return jQuery.find(selector, elem);
});
return this.pushStack(/[^+>] [^+>]/.test(selector) ?
jQuery.unique(elems) :
elems, "find", selector);
}
},
clone: function(events) {
///
/// 克隆匹配的DOM元素并且选中这些克隆的副本。
/// 在想把DOM文档中元素的副本添加到其他位置时这个函数非常有用。
/// Part of DOM/Manipulation
///
///
///
/// (可选) 如果你不想克隆后代的所有节点,除了本身的元素,可以设置为False
///
// Do the clone
var ret = this.map(function() {
if (!jQuery.support.noCloneEvent && !jQuery.isXMLDoc(this)) {
// IE copies events bound via attachEvent when
// using cloneNode. Calling detachEvent on the
// clone will also remove the events from the orignal
// In order to get around this, we use innerHTML.
// Unfortunately, this means some modifications to
// attributes in IE that are actually only stored
// as properties will not be copied (such as the
// the name attribute on an input).
var clone = this.cloneNode(true),
container = document.createElement("div");
container.appendChild(clone);
return jQuery.clean([container.innerHTML])[0];
} else
return this.cloneNode(true);
});
// Need to set the expando to null on the cloned set if it exists
// removeData doesn't work here, IE removes it from the original as well
// this is primarily for IE but the data expando shouldn't be copied over in any browser
var clone = ret.find("*").andSelf().each(function() {
if (this[expando] !== undefined)
this[expando] = null;
});
// Copy the events from the original to the clone
if (events === true)
this.find("*").andSelf().each(function(i) {
if (this.nodeType == 3)
return;
var events = jQuery.data(this, "events");
for (var type in events)
for (var handler in events[type])
jQuery.event.add(clone[i], type, events[type][handler], events[type][handler].data);
});
// Return the cloned set
return ret;
},
filter: function(selector) {
///
/// 筛选出与指定函数返回值匹配的元素集合
/// 这个函数内部将对每个对象计算一次 (正如 '$.each').
/// 如果调用的函数返回false则这个元素被删除,否则就会保留。
/// })
/// Part of DOM/Traversing
///
///
///
/// 传递进filter的函数
///
///
return this.pushStack(
jQuery.isFunction(selector) &&
jQuery.grep(this, function(elem, i) {
return selector.call(elem, i);
}) ||
jQuery.multiFilter(selector, jQuery.grep(this, function(elem) {
return elem.nodeType === 1;
})), "filter", selector);
},
closest: function(selector) {
var pos = jQuery.expr.match.POS.test(selector) ? jQuery(selector) : null;
return this.map(function() {
var cur = this;
while (cur && cur.ownerDocument) {
if (pos ? pos.index(cur) > -1 : jQuery(cur).is(selector))
return cur;
cur = cur.parentNode;
}
});
},
not: function(selector) {
///
/// 将元素集合中所有与指定元素匹配的元素删除。
/// 这个方法被用来删除一个jQuery对象中一个或多个元素。
/// Part of DOM/Traversing
///
///
/// jQuery对象中一组要被删除的元素。
///
///
if (typeof selector === "string")
// test special case where just one selector is passed in
if (isSimple.test(selector))
return this.pushStack(jQuery.multiFilter(selector, this, true), "not", selector);
else
selector = jQuery.multiFilter(selector, this);
var isArrayLike = selector.length && selector[selector.length - 1] !== undefined && !selector.nodeType;
return this.filter(function() {
return isArrayLike ? jQuery.inArray(this, selector) < 0 : this != selector;
});
},
add: function(selector) {
///
/// 把与表达式匹配的元素添加到jQuery对象中。
/// 这个函数可以用于连接分别与两个表达式匹配的元素结果集。
/// Part of DOM/Traversing
///
///
/// 一个或多个要添加的元素
///
///
return this.pushStack(jQuery.unique(jQuery.merge(
this.get(),
typeof selector === "string" ?
jQuery(selector) :
jQuery.makeArray(selector)
)));
},
is: function(selector) {
///
/// 用一个表达式来检查当前选择的元素集合,
/// 如果其中至少有一个元素符合这个给定的表达式就返回true。
/// 如果没有元素符合,或者表达式无效,都返回'false'.
/// 'filter' 内部实际也是在调用这个函数,
/// 所以,filter()函数原有的规则在这里也适用。
/// Part of DOM/Traversing
///
///
///
/// 用于筛选的表达式
///
return !!selector && jQuery.multiFilter(selector, this).length > 0;
},
hasClass: function(selector) {
///
/// 检查当前的元素是否含有某个特定的类,如果有,则返回true。这其实就是 is("." + class)。
///
/// 用于匹配的类名
/// 如果有,则返回true,否则返回false.
return !!selector && this.is("." + selector);
},
val: function(value) {
///
/// 设置每一个匹配元素的值。在 jQuery 1.2, 这也可以为select元件赋值
/// Part of DOM/Attributes
///
///
///
/// 要设置的值。
///
if (value === undefined) {
var elem = this[0];
if (elem) {
if (jQuery.nodeName(elem, 'option'))
return (elem.attributes.value || {}).specified ? elem.value : elem.text;
// We need to handle select boxes special
if (jQuery.nodeName(elem, "select")) {
var index = elem.selectedIndex,
values = [],
options = elem.options,
one = elem.type == "select-one";
// Nothing was selected
if (index < 0)
return null;
// Loop through all the selected options
for (var i = one ? index : 0, max = one ? index + 1 : options.length; i < max; i++) {
var option = options[i];
if (option.selected) {
// Get the specifc value for the option
value = jQuery(option).val();
// We don't need an array for one selects
if (one)
return value;
// Multi-Selects return an array
values.push(value);
}
}
return values;
}
// Everything else, we just grab the value
return (elem.value || "").replace(/\r/g, "");
}
return undefined;
}
if (typeof value === "number")
value += '';
return this.each(function() {
if (this.nodeType != 1)
return;
if (jQuery.isArray(value) && /radio|checkbox/.test(this.type))
this.checked = (jQuery.inArray(this.value, value) >= 0 ||
jQuery.inArray(this.name, value) >= 0);
else if (jQuery.nodeName(this, "select")) {
var values = jQuery.makeArray(value);
jQuery("option", this).each(function() {
this.selected = (jQuery.inArray(this.value, values) >= 0 ||
jQuery.inArray(this.text, values) >= 0);
});
if (!values.length)
this.selectedIndex = -1;
} else
this.value = value;
});
},
html: function(value) {
///
/// 设置每一个匹配元素的html内容。
/// 这个函数不能用于XML文档。但可以用于XHTML文档。
/// Part of DOM/Attributes
///
///
///
/// 用于设定HTML内容的值
///
return value === undefined ?
(this[0] ?
this[0].innerHTML :
null) :
this.empty().append(value);
},
replaceWith: function(value) {
///
/// 将所有匹配的元素替换成指定的HTML或DOM元素。
///
///
/// 用于将匹配元素替换掉的内容
///
/// 刚替换的元素
return this.after(value).remove();
},
eq: function(i) {
///
/// 匹配一个给定索引值的元素。
/// 从 0 开始计数
/// Part of Core
///
///
///
/// 你想要的那个元素的索引值
///
return this.slice(i, +i + 1);
},
slice: function() {
///
/// 选取一个匹配的子集。与原来的slice方法类似。
///
/// 开始选取子集的位置。(从0开始,负数是从集合的尾部开始选起)
/// (可选) 结束选取自己的位置,
/// 如果不指定,则就是本身的结尾。
/// 被选择的元素
return this.pushStack(Array.prototype.slice.apply(this, arguments),
"slice", Array.prototype.slice.call(arguments).join(","));
},
map: function(callback) {
///
/// 将一组元素转换成其他数组(不论是否是元素数组)This member is internal.
/// 你可以用这个函数来建立一个列表,不论是值、属性还是CSS样式,或者其他特别形式。
/// 这都可以用'$.map()'来方便的建立。
///
///
///
return this.pushStack(jQuery.map(this, function(elem, i) {
return callback.call(elem, i, elem);
}));
},
andSelf: function() {
///
/// 加入先前所选的加入当前元素中。
/// 对于筛选或查找后的元素,要加入先前所选元素时将会很有用。
///
///
return this.add(this.prevObject);
},
domManip: function(args, table, callback) {
///
/// Args
///
///
/// 如果没有就在table元素中插入tbody。
///
///
/// 执行DOM处理的函数
///
///
///
/// Part of Core
///
if (this[0]) {
var fragment = (this[0].ownerDocument || this[0]).createDocumentFragment(),
scripts = jQuery.clean(args, (this[0].ownerDocument || this[0]), fragment),
first = fragment.firstChild,
extra = this.length > 1 ? fragment.cloneNode(true) : fragment;
if (first)
for (var i = 0, l = this.length; i < l; i++)
callback.call(root(this[i], first), i > 0 ? extra.cloneNode(true) : fragment);
if (scripts)
jQuery.each(scripts, evalScript);
}
return this;
function root(elem, cur) {
return table && jQuery.nodeName(elem, "table") && jQuery.nodeName(cur, "tr") ?
(elem.getElementsByTagName("tbody")[0] ||
elem.appendChild(elem.ownerDocument.createElement("tbody"))) :
elem;
}
}
};
// Give the init function the jQuery prototype for later instantiation
jQuery.fn.init.prototype = jQuery.fn;
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);
}
function now() {
///
/// 获得当前日期。
///
/// 当前日期
return +new Date;
}
jQuery.extend = jQuery.fn.extend = function() {
///
/// 用一个或多个其他对象来扩展一个对象,返回被扩展的对象。
/// 用于简化继承。
/// jQuery.extend(settings, options);
/// var settings = jQuery.extend({}, defaults, options);
/// Part of JavaScript
///
///
/// 待修改对象。
///
///
/// 待合并到第一个对象的对象。
///
///
/// (可选) 待合并到第一个对象的对象。
///
///
// copy reference to target object
var target = arguments[0] || {}, i = 1, length = arguments.length, deep = false, options;
// 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 (var name in options) {
var 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)
target[name] = jQuery.extend(deep,
// Never move original objects, clone them
src || (copy.length != null ? [] : {})
, copy);
// Don't bring in undefined values
else if (copy !== undefined)
target[name] = copy;
}
// Return the modified object
return target;
};
// exclude the following css properties to add px
var exclude = /z-?index|font-?weight|opacity|zoom|line-?height/i,
// cache defaultView
defaultView = document.defaultView || {},
toString = Object.prototype.toString;
jQuery.extend({
noConflict: function(deep) {
///
/// 扩展jQuery对象本身。
/// 用来在jQuery命名空间上增加新函数。
/// 使用这个函数必须以jQuery 开头,不能用$开头
/// Part of Core
///
///
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) {
///
/// 确定参数是否是一个函数。
///
/// 要检查的对象
/// 参数是函数就返回true,否则返回false。
return toString.call(obj) === "[object Function]";
},
isArray: function(obj) {
///
/// 确定参数是否是一个数组。
///
/// 要检查的对象
/// 参数是函数就返回true,否则返回false。
return toString.call(obj) === "[object Array]";
},
// check if an element is in a (or is an) XML document
isXMLDoc: function(elem) {
///
/// 确定是否通过参数是一个XML文档。
///
/// 要监察的对象
/// 参数是XML文档就返回true,否则返回false。
return elem.nodeType === 9 && elem.documentElement.nodeName !== "HTML" ||
!!elem.ownerDocument && jQuery.isXMLDoc(elem.ownerDocument);
},
// Evalulates a script in a global context
globalEval: function(data) {
///
/// 在全局环境中执行一段脚本。
///
///
data = jQuery.trim(data);
if (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) {
///
/// 检查指定的元素里是否有指定的DOM节点的名称。
///
/// 要检查的元素
/// 要确认的节点名称
/// 如果指定的节点名称匹配对应的节点的DOM节点名称返回true; 否则返回 false
return elem.nodeName && elem.nodeName.toUpperCase() == name.toUpperCase();
},
// args is for internal usage only
each: function(object, callback, args) {
///
/// 以每一个匹配的元素作为上下文来执行一个函数。
/// 意味着,每次执行传递进来的函数时,
/// 函数中的this关键字都指向一个不同的DOM元素(每次都是一个不同的匹配元素)。
/// 而且,在每次执行函数时,都会给函数传递一个表示作为执行环境的元素在匹配的元素集合中所处位置的数字值作为参数(从零开始的整形)。
/// 返回 'false' 将停止循环 (就像在普通的循环中使用 'break')。
/// 返回 'true' 跳至下一个循环(就像在普通的循环中使用'continue')。
/// Part of JavaScript
///
///
/// 要迭代的对象或数组
///
///
/// 对于每个匹配的元素所要执行的函数
///
///
var name, i = 0, length = object.length;
if (args) {
if (length === undefined) {
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 (length === undefined) {
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;
},
prop: function(elem, value, type, i, name) {
///
/// This method is internal.
///
///
// This member is not documented within the jQuery API: http://docs.jquery.com/action/edit/Internals/jQuery.prop
// Handle executable functions
if (jQuery.isFunction(value))
value = value.call(elem, i);
// Handle passing in a number to a CSS property
return typeof value === "number" && type == "curCSS" && !exclude.test(name) ?
value + "px" :
value;
},
className: {
// internal only, use addClass("class")
add: function(elem, classNames) {
///
/// Internal use only; use addClass('class')
///
///
jQuery.each((classNames || "").split(/\s+/), function(i, className) {
if (elem.nodeType == 1 && !jQuery.className.has(elem.className, className))
elem.className += (elem.className ? " " : "") + className;
});
},
// internal only, use removeClass("class")
remove: function(elem, classNames) {
///
/// Internal use only; use removeClass('class')
///
///
if (elem.nodeType == 1)
elem.className = classNames !== undefined ?
jQuery.grep(elem.className.split(/\s+/), function(className) {
return !jQuery.className.has(classNames, className);
}).join(" ") :
"";
},
// internal only, use hasClass("class")
has: function(elem, className) {
///
/// Internal use only; use hasClass('class')
///
///
return elem && jQuery.inArray(className, (elem.className || elem).toString().split(/\s+/)) > -1;
}
},
// A method for quickly swapping in/out CSS properties to get correct calculations
swap: function(elem, options, callback) {
///
/// Swap in/out style options.
///
var old = {};
// Remember the old values, and insert the new ones
for (var name in options) {
old[name] = elem.style[name];
elem.style[name] = options[name];
}
callback.call(elem);
// Revert the old values
for (var name in options)
elem.style[name] = old[name];
},
css: function(elem, name, force) {
///
/// 在所有匹配的元素中,设置或取得一个样式属性的值。数字将自动转化为像素值
///
///
// This method is undocumented in jQuery API: http://docs.jquery.com/action/edit/Internals/jQuery.css
if (name == "width" || name == "height") {
var val, props = { position: "absolute", visibility: "hidden", display: "block" }, which = name == "width" ? ["Left", "Right"] : ["Top", "Bottom"];
function getWH() {
val = name == "width" ? elem.offsetWidth : elem.offsetHeight;
var padding = 0, border = 0;
jQuery.each(which, function() {
padding += parseFloat(jQuery.curCSS(elem, "padding" + this, true)) || 0;
border += parseFloat(jQuery.curCSS(elem, "border" + this + "Width", true)) || 0;
});
val -= Math.round(padding + border);
}
if (jQuery(elem).is(":visible"))
getWH();
else
jQuery.swap(elem, props, getWH);
return Math.max(0, val);
}
return jQuery.curCSS(elem, name, force);
},
curCSS: function(elem, name, force) {
///
/// This method is internal only.
///
///
// This method is undocumented in jQuery API: http://docs.jquery.com/action/edit/Internals/jQuery.curCSS
var ret, style = elem.style;
// We need to handle opacity special in IE
if (name == "opacity" && !jQuery.support.opacity) {
ret = jQuery.attr(style, "opacity");
return ret == "" ?
"1" :
ret;
}
// Make sure we're using the right name for getting the float value
if (name.match(/float/i))
name = styleFloat;
if (!force && style && style[name])
ret = style[name];
else if (defaultView.getComputedStyle) {
// Only "float" is needed here
if (name.match(/float/i))
name = "float";
name = name.replace(/([A-Z])/g, "-$1").toLowerCase();
var computedStyle = defaultView.getComputedStyle(elem, null);
if (computedStyle)
ret = computedStyle.getPropertyValue(name);
// We should always get a number back from opacity
if (name == "opacity" && ret == "")
ret = "1";
} else if (elem.currentStyle) {
var camelCase = name.replace(/\-(\w)/g, function(all, letter) {
return letter.toUpperCase();
});
ret = elem.currentStyle[name] || elem.currentStyle[camelCase];
// From the awesome hack by Dean Edwards
// http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291
// If we're not dealing with a regular pixel number
// but a number that has a weird ending, we need to convert it to pixels
if (!/^\d+(px)?$/i.test(ret) && /^\d/.test(ret)) {
// Remember the original values
var left = style.left, rsLeft = elem.runtimeStyle.left;
// Put in the new values to get a computed value out
elem.runtimeStyle.left = elem.currentStyle.left;
style.left = ret || 0;
ret = style.pixelLeft + "px";
// Revert the changed values
style.left = left;
elem.runtimeStyle.left = rsLeft;
}
}
return ret;
},
clean: function(elems, context, fragment) {
///
/// This method is internal only.
///
///
// This method is undocumented in the jQuery API: http://docs.jquery.com/action/edit/Internals/jQuery.clean
context = context || document;
// !context.createElement fails in IE with an error but returns typeof 'object'
if (typeof context.createElement === "undefined")
context = context.ownerDocument || context[0] && context[0].ownerDocument || document;
// If a single string is passed in and it's a single tag
// just do a createElement and skip the rest
if (!fragment && elems.length === 1 && typeof elems[0] === "string") {
var match = /^<(\w+)\s*\/?>$/.exec(elems[0]);
if (match)
return [context.createElement(match[1])];
}
var ret = [], scripts = [], div = context.createElement("div");
jQuery.each(elems, function(i, elem) {
if (typeof elem === "number")
elem += '';
if (!elem)
return;
// Convert html string into DOM nodes
if (typeof elem === "string") {
// Fix "XHTML"-style tags in all browsers
elem = elem.replace(/(<(\w+)[^>]*?)\/>/g, function(all, front, tag) {
return tag.match(/^(abbr|br|col|img|input|link|meta|param|hr|area|embed)$/i) ?
all :
front + ">" + tag + ">";
});
// Trim whitespace, otherwise indexOf won't work as expected
var tags = jQuery.trim(elem).toLowerCase();
var wrap =
// option or optgroup
!tags.indexOf("", ""] ||
!tags.indexOf("", ""] ||
tags.match(/^<(thead|tbody|tfoot|colg|cap)/) &&
[1, "