jquery 1.2.6 中文注释解析
* This file has been commented to support Visual Studio Intellisense.
* You should not use this file at runtime inside the browser--it is only
* intended to be used only for design-time IntelliSense. Please use the
* standard jQuery library for all production use.
* Comment version: 1.2.6a
*/
/*
*billsquall汉化
*感谢之前为API1.1 1.2汉化的各位高手，参考了不少^^
*感谢shawphy，鼓励我的好人！
*不知道有没有侵权的说法，反正这汉化仅供大家参考，版权方面不负任何责任。
*估计不会有人拿去做什么吧？不要用做商业用途，否则后果自负。
*/
(function(){
/*
* jQuery 1.2.6 - New Wave Javascript
*
* Copyright (c) 2008 John Resig, http://jquery.com/
*
* Permission is hereby granted, free of charge, to any person obtaining
* a copy of this software and associated documentation files (the
* "Software"), to deal in the Software without restriction, including
* without limitation the rights to use, copy, modify, merge, publish,
* distribute, sublicense, and/or sell copies of the Software, and to
* permit persons to whom the Software is furnished to do so, subject to
* the following conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
* LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
* OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*
* $Date: 2008-05-24 14:22:17 -0400 (Sat, 24 May 2008) $
* $Rev: 5685 $
*/
// Map over jQuery in case of overwrite
var _jQuery = window.jQuery,
// Map over the $ in case of overwrite
_$ = window.$;
var jQuery = window.jQuery = window.$ = function( selector, context ) {
/// <summary>
/// 1: $(expression, context) - 这个函数接收一个包含 CSS 选择器的字符串，然后用这个字符串去匹配一组元素。
/// 2: $(html) - 根据提供的原始 HTML 标记字符串，动态创建由 jQuery 对象包装的 DOM 元素。
/// 3: $(elements) - 将一个或多个DOM元素转化为jQuery对象。
/// 4: $(callback) - $(document).ready()的简写。
/// </summary>
/// <param name="selector" type="String">
/// 1: expression - 用来查找的表达式。
/// 2: html -用于动态创建DOM元素的HTML标记字符串
/// 3: elements - 用于封装成jQuery对象的DOM元素
/// 4: callback - 当DOM加载完成后，执行其中的函数。
/// </param>
/// <param name="context" type="jQuery">
/// 1: context - (可选) 作为待查找的 DOM 元素集、文档或 jQuery 对象。
/// </param>
/// <returns type="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)
var quickExpr = /^[^<]*(<(.|\s)+>)[^>]*$|^#(\w+)$/,
// Is it a simple selector
isSimple = /^.[^:#\[\.]*$/,
// Will speed up references to undefined, and allows munging its name.
undefined;
jQuery.fn = jQuery.prototype = {
init: function( selector, context ) {
/// <summary>
/// 1: $(expression, context) - 这个函数接收一个包含 CSS 选择器的字符串，然后用这个字符串去匹配一组元素。
/// 2: $(html) - 根据提供的原始 HTML 标记字符串，动态创建由 jQuery 对象包装的 DOM 元素。
/// 3: $(elements) - 将一个或多个DOM元素转化为jQuery对象。
/// 4: $(callback) - $(document).ready()的简写。
/// </summary>
/// <param name="selector" type="String">
/// 1: expression - 用来查找的表达式。
/// 2: html -用于动态创建DOM元素的HTML标记字符串
/// 3: elements - 用于封装成jQuery对象的DOM元素
/// 4: callback - 当DOM加载完成后，执行其中的函数。
/// </param>
/// <param name="context" type="jQuery">
/// 1: context - (可选) 作为待查找的 DOM 元素集、文档或 jQuery 对象。
/// </param>
/// <returns type="jQuery" />
// Make sure that a selection was provided
selector = selector || document;
// Handle $(DOMElement)
if ( selector.nodeType ) {
this[0] = selector;
this.length = 1;
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] );
// Make sure an element was located
if ( elem ){
// Handle the case where IE and Opera return items
// by name instead of ID
if ( elem.id != match[3] )
return jQuery().find( selector );
// Otherwise, we inject the element directly into the jQuery object
return jQuery( elem );
}
selector = [];
}
// 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 )[ jQuery.fn.ready ? "ready" : "load" ]( selector );
return this.setArray(jQuery.makeArray(selector));
},
// The current version of jQuery being used
jquery: "1.2.6",
// The number of elements contained in the matched element set
size: function() {
/// <summary>
/// The number of elements currently matched.
/// Part of Core
/// </summary>
/// <returns type="Number" />
return this.length;
},
// The number of elements contained in the matched element set
length: 0,
// Get the Nth element in the matched element set OR
// Get the whole matched element set as a clean array
get: function( num ) {
/// <summary>
/// Access a single matched element. num is used to access the
/// Nth element matched.
/// Part of Core
/// </summary>
/// <returns type="Element" />
/// <param name="num" type="Number">
/// Access the element in the Nth position.
/// </param>
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 ) {
/// <summary>
/// Set the jQuery object to an array of elements, while maintaining
/// the stack.
/// Part of Core
/// </summary>
/// <returns type="jQuery" />
/// <param name="elems" type="Elements">
/// An array of elements
/// </param>
// Build a new jQuery matched element set
var ret = jQuery( elems );
// Add the old object onto the stack (as a reference)
ret.prevObject = this;
// 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 ) {
/// <summary>
/// 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
/// </summary>
/// <returns type="jQuery" />
/// <param name="elems" type="Elements">
/// An array of elements
/// </param>
// 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 ) {
/// <summary>
/// 以每一个匹配的元素作为上下文来执行一个函数。
/// 意味着，每次执行传递进来的函数时，
/// 函数中的this关键字都指向一个不同的DOM元素
/// （每次都是一个不同的匹配元素）。
/// 而且，在每次执行函数时，
/// 都会给函数传递一个表示作为执行环境的元素在匹配的元素集合中所处位置的数字值作为参数
/// （从零开始的整形）。
/// </summary>
/// <returns type="jQuery" />
/// <param name="callback" type="Function">
/// 对于每个匹配的元素所要执行的函数
/// </param>
return jQuery.each( this, callback, args );
},
// Determine the position of an element within
// the matched set of elements
index: function( elem ) {
/// <summary>
/// 搜索与参数表示的对象匹配的元素，
/// 并返回相应元素的索引值值。
/// 如果找到了匹配的元素，从0开始返回；如果没有找到匹配的元素，返回-1。
/// Part of Core
/// </summary>
/// <returns type="Number" />
/// <param name="elem" type="Element">
/// 要搜索的对象
/// </param>
var ret = -1;
// 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 ) {
/// <summary>
/// 为所有匹配的元素设置一个计算的属性值。
/// 不提供值，而是提供一个函数，由这个函数计算的值作为属性值。
/// Part of DOM/Attributes
/// </summary>
/// <returns type="jQuery" />
/// <param name="name" type="String">
/// 属性名称
/// </param>
/// <param name="value" type="Function">
/// 返回值的函数 范围:当前元素, 参数: 当前元素的索引值
/// </param>
var options = name;
// Look for the case where we're accessing a style value
if ( name.constructor == 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 ) {
/// <summary>
/// 在所有匹配的元素中，设置一个样式属性的值。
/// 数字将自动转化为像素值
/// Part of CSS
/// </summary>
/// <returns type="jQuery" />
/// <param name="key" type="String">
/// 属性名
/// </param>
/// <param name="value" type="String">
/// 属性值
/// </param>
// 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 ) {
/// <summary>
/// 设置所有匹配元素的文本内容
/// 与 html() 类似, 但将编码 HTML (将 "<" 和 ">" 替换成相应的HTML实体)。
/// Part of DOM/Attributes
/// </summary>
/// <returns type="String" />
/// <param name="text" type="String">
/// 用于设置元素内容的文本
/// </param>
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 ) {
/// <summary>
/// 将所有匹配的元素用单个元素包裹起来
/// 这于 '.wrap()' 是不同的，
/// '.wrap()'为每一个匹配的元素都包裹一次。
/// 这种包装对于在文档中插入额外的结构化标记最有用，
/// 而且它不会破坏原始文档的语义品质。
/// 这个函数的原理是检查提供的第一个元素并在它的代码结构中找到最上层的祖先元素－－这个祖先元素就是包装元素。
/// Part of DOM/Manipulation
/// </summary>
/// <returns type="jQuery" />
/// <param name="html" type="Element">
/// HTML标记代码字符串，用于动态生成元素并包装目标元素
/// </param>
if ( this[0] )
// The elements to wrap the target around
jQuery( html, this[0].ownerDocument )
.clone()
.insertBefore( this[0] )
.map(function(){
var elem = this;
while ( elem.firstChild )
elem = elem.firstChild;
return elem;
})
.append(this);
return this;
},
wrapInner: function( html ) {
/// <summary>
/// 将每一个匹配的元素的子内容(包括文本节点)用一个HTML结构包裹起来。
/// </summary>
/// <param name="html" type="String">
/// HTML标记代码字符串，用于动态生成元素并包装目标元素
/// </param>
/// <returns type="jQuery" />
return this.each(function(){
jQuery( this ).contents().wrapAll( html );
});
},
wrap: function( html ) {
/// <summary>
/// 把所有匹配的元素用其他元素的结构化标记包裹起来。
/// 这种包装对于在文档中插入额外的结构化标记最有用，
/// 而且它不会破坏原始文档的语义品质。
/// 这个函数的原理是检查提供的第一个元素
/// （它是由所提供的HTML标记代码动态生成的），
/// 并在它的代码结构中找到最上层的祖先元素－－这个祖先元素就是包裹元素。
/// 当HTML标记代码中的元素包含文本时无法使用这个函数。
/// 因此，如果要添加文本应该在包裹完成之后再行添加。
/// Part of DOM/Manipulation
/// </summary>
/// <returns type="jQuery" />
/// <param name="html" type="Element">
/// HTML标记代码字符串，用于动态生成元素并包裹目标元素
/// </param>
return this.each(function(){
jQuery( this ).wrapAll( html );
});
},
append: function() {
/// <summary>
/// 向每个匹配的元素内部追加内容。
/// 这个操作与对指定的元素执行appendChild方法，
/// 将它们添加到文档中的情况类似。
/// Part of DOM/Manipulation
/// </summary>
/// <returns type="jQuery" />
/// <param name="content" type="Content">
/// 要追加到目标中的内容
/// </param>
return this.domManip(arguments, true, false, function(elem){
if (this.nodeType == 1)
this.appendChild( elem );
});
},
prepend: function() {
/// <summary>
/// 向每个匹配的元素内部前置内容。
/// 这是向所有匹配元素内部的开始处插入内容的最佳方式。
/// Part of DOM/Manipulation
/// </summary>
/// <returns type="jQuery" />
/// <param name="" type="Content">
/// 要插入到目标元素内部前端的内容
/// </param>
return this.domManip(arguments, true, true, function(elem){
if (this.nodeType == 1)
this.insertBefore( elem, this.firstChild );
});
},
before: function() {
/// <summary>
/// 在每个匹配的元素之前插入内容。
/// Part of DOM/Manipulation
/// </summary>
/// <returns type="jQuery" />
/// <param name="" type="Content">
/// 在所有段落之前插入一些HTML标记代码。
/// </param>
return this.domManip(arguments, false, false, function(elem){
this.parentNode.insertBefore( elem, this );
});
},
after: function() {
/// <summary>
/// 在每个匹配的元素之后插入内容。
/// Part of DOM/Manipulation
/// </summary>
/// <returns type="jQuery" />
/// <param name="" type="Content">
/// 插入到每个目标后的内容
/// </param>
return this.domManip(arguments, false, true, function(elem){
this.parentNode.insertBefore( elem, this.nextSibling );
});
},
end: function() {
/// <summary>
/// 回到最近的一个"破坏性"操作之前。
/// 即，将匹配的元素列表变为前一次的状态。
/// 如果之前没有破坏性操作，则返回一个空集。
/// 所谓的"破坏性"就是指任何改变所匹配的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
/// </summary>
/// <returns type="jQuery" />
return this.prevObject || jQuery( [] );
},
find: function( selector ) {
/// <summary>
/// 搜索所有与指定表达式匹配的元素。
/// 这个函数是找出正在处理的元素的后代元素的好方法。
/// 所有搜索都依靠jQuery表达式来完成。
/// 这个表达式可以使用CSS1-3的选择器，或简单的XPATH语法来写。
/// Part of DOM/Traversing
/// </summary>
/// <returns type="jQuery" />
/// <param name="selector" type="String">
/// 用于查找的表达式
/// </param>
/// <returns type="jQuery" />
var elems = jQuery.map(this, function(elem){
return jQuery.find( selector, elem );
});
return this.pushStack( /[^+>] [^+>]/.test( selector ) || selector.indexOf("..") > -1 ?
jQuery.unique( elems ) :
elems );
},
clone: function( events ) {
/// <summary>
/// 克隆匹配的DOM元素并且选中这些克隆的副本。
/// 在想把DOM文档中元素的副本添加到其他位置时这个函数非常有用。
/// Part of DOM/Manipulation
/// </summary>
/// <returns type="jQuery" />
/// <param name="deep" type="Boolean" optional="true">
/// (可选) 如果你不想克隆后代的所有节点，除了本身的元素，可以设置为False
/// </param>
// Do the clone
var ret = this.map(function(){
if ( jQuery.browser.msie && !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 ) {
/// <summary>
/// 筛选出与指定函数返回值匹配的元素集合
/// 这个函数内部将对每个对象计算一次 (正如 '$.each').
/// 如果调用的函数返回false则这个元素被删除，否则就会保留。
/// })
/// Part of DOM/Traversing
/// </summary>
/// <returns type="jQuery" />
/// <param name="filter" type="Function">
/// 传递进filter的函数
/// </param>
/// <returns type="jQuery" />
return this.pushStack(
jQuery.isFunction( selector ) &&
jQuery.grep(this, function(elem, i){
return selector.call( elem, i );
}) ||
jQuery.multiFilter( selector, this ) );
},
not: function( selector ) {
/// <summary>
/// 将元素集合中所有与指定元素匹配的元素删除。
/// 这个方法被用来删除一个jQuery对象中一个或多个元素。
/// Part of DOM/Traversing
/// </summary>
/// <param name="selector" type="jQuery">
/// jQuery对象中一组要被删除的元素。
/// </param>
/// <returns type="jQuery" />
if ( selector.constructor == String )
// test special case where just one selector is passed in
if ( isSimple.test( selector ) )
return this.pushStack( jQuery.multiFilter( selector, this, true ) );
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 ) {
/// <summary>
/// 把与表达式匹配的元素添加到jQuery对象中。
/// 这个函数可以用于连接分别与两个表达式匹配的元素结果集。
/// Part of DOM/Traversing
/// </summary>
/// <param name="elements" type="Element">
/// 一个或多个要添加的元素
/// </param>
/// <returns type="jQuery" />
return this.pushStack( jQuery.unique( jQuery.merge(
this.get(),
typeof selector == 'string' ?
jQuery( selector ) :
jQuery.makeArray( selector )
)));
},
is: function( selector ) {
/// <summary>
/// 用一个表达式来检查当前选择的元素集合，
/// 如果其中至少有一个元素符合这个给定的表达式就返回true。
/// 如果没有元素符合，或者表达式无效，都返回'false'.
/// 'filter' 内部实际也是在调用这个函数，
/// 所以，filter()函数原有的规则在这里也适用。
/// Part of DOM/Traversing
/// </summary>
/// <returns type="Boolean" />
/// <param name="expr" type="String">
/// 用于筛选的表达式
/// </param>
return !!selector && jQuery.multiFilter( selector, this ).length > 0;
},
hasClass: function( selector ) {
/// <summary>
/// 检查当前的元素是否含有某个特定的类，如果有，则返回true。这其实就是 is("." + class)。
/// </summary>
/// <param name="selector" type="String">用于匹配的类名</param>
/// <returns type="Boolean">如果有，则返回true，否则返回false.</returns>
return this.is( "." + selector );
},
val: function( value ) {
/// <summary>
/// 设置每一个匹配元素的值。在 jQuery 1.2, 这也可以为select元件赋值
/// Part of DOM/Attributes
/// </summary>
/// <returns type="jQuery" />
/// <param name="val" type="String">
/// 要设置的值。
/// </param>
if ( value == undefined ) {
if ( this.length ) {
var elem = this[0];
// 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.browser.msie && !option.attributes.value.specified ? option.text : option.value;
// 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
} else
return (this[0].value || "").replace(/\r/g, "");
}
return undefined;
}
if( value.constructor == Number )
value += '';
return this.each(function(){
if ( this.nodeType != 1 )
return;
if ( value.constructor == Array && /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 ) {
/// <summary>
/// 设置每一个匹配元素的html内容。
/// 这个函数不能用于XML文档。但可以用于XHTML文档。
/// Part of DOM/Attributes
/// </summary>
/// <returns type="jQuery" />
/// <param name="val" type="String">
/// 用于设定HTML内容的值
/// </param>
return value == undefined ?
(this[0] ?
this[0].innerHTML :
null) :
this.empty().append( value );
},
replaceWith: function( value ) {
/// <summary>
/// 将所有匹配的元素替换成指定的HTML或DOM元素。
/// </summary>
/// <param name="value" type="String">
/// 用于将匹配元素替换掉的内容
/// </param>
/// <returns type="jQuery">刚替换的元素</returns>
return this.after( value ).remove();
},
eq: function( i ) {
/// <summary>
/// 匹配一个给定索引值的元素。
/// 从 0 开始计数
/// Part of Core
/// </summary>
/// <returns type="jQuery" />
/// <param name="num" type="Number">
/// 你想要的那个元素的索引值
/// </param>
return this.slice( i, i + 1 );
},
slice: function() {
/// <summary>
/// 选取一个匹配的子集。与原来的slice方法类似。
/// </summary>
/// <param name="start" type="Number" integer="true">开始选取子集的位置。（从0开始，负数是从集合的尾部开始选起）</param>
/// <param name="end" optional="true" type="Number" integer="true"> (可选) 结束选取自己的位置，
/// 如果不指定，则就是本身的结尾。</param>
/// <returns type="jQuery">被选择的元素</returns>
return this.pushStack(Array.prototype.slice.apply(this, arguments));
},
map: function( callback ) {
/// <summary>
/// 将一组元素转换成其他数组（不论是否是元素数组）This member is internal.
/// 你可以用这个函数来建立一个列表，不论是值、属性还是CSS样式，或者其他特别形式。
/// 这都可以用'$.map()'来方便的建立。
/// </summary>
/// <private />
/// <returns type="jQuery" />
return this.pushStack( jQuery.map(this, function(elem, i){
return callback.call( elem, i, elem );
}));
},
andSelf: function() {
/// <summary>
/// 加入先前所选的加入当前元素中。
/// 对于筛选或查找后的元素，要加入先前所选元素时将会很有用。
/// </summary>
/// <returns type="jQuery" />
return this.add( this.prevObject );
},
data: function( key, value ){
/// <summary>
/// 在元素上存放数据，同时也返回value。
/// 如果jQuery集合指向多个元素，那将在所有元素上设置对应数据。
/// 这个函数不用建立一个新的expando，就能在一个元素上存放任何格式的数据，而不仅仅是字符串。
/// </summary>
/// <param name="key" type="String">存储的数据名</param>
/// <param name="value" type="Any">将要存储的任意数据</param>
/// <returns type="Any">值存储在指定的数据名上</returns>
var parts = key.split(".");
parts[1] = parts[1] ? "." + parts[1] : "";
if ( value === undefined ) {
var data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]);
if ( data === undefined && this.length )
data = jQuery.data( this[0], key );
return data === undefined && parts[1] ?
this.data( parts[0] ) :
data;
} else
return this.trigger("setData" + parts[1] + "!", [parts[0], value]).each(function(){
jQuery.data( this, key, value );
});
},
removeData: function( key ){
/// <summary>
/// 在元素上移除存放的数据
/// </summary>
/// <param name="key" type="Element">存储数据中要被删除的元素</param>
return this.each(function(){
jQuery.removeData( this, key );
});
},
domManip: function( args, table, reverse, callback ) {
/// <param name="args" type="Array">
/// Args
/// </param>
/// <param name="table" type="Boolean">
/// 如果没有就在table元素中插入tbody。
/// </param>
/// <param name="dir" type="Number">
/// 如果dir小于0，则以相反的程序处理参数
/// </param>
/// <param name="fn" type="Function">
/// 执行DOM处理的函数
/// </param>
/// <returns type="jQuery" />
/// <summary>
/// Part of Core
/// </summary>
var clone = this.length > 1, elems;
return this.each(function(){
if ( !elems ) {
elems = jQuery.clean( args, this.ownerDocument );
if ( reverse )
elems.reverse();
}
var obj = this;
if ( table && jQuery.nodeName( this, "table" ) && jQuery.nodeName( elems[0], "tr" ) )
obj = this.getElementsByTagName("tbody")[0] || this.appendChild( this.ownerDocument.createElement("tbody") );
var scripts = jQuery( [] );
jQuery.each(elems, function(){
var elem = clone ?
jQuery( this ).clone( true )[0] :
this;
// execute all scripts after the elements have been injected
if ( jQuery.nodeName( elem, "script" ) )
scripts = scripts.add( elem );
else {
// Remove any inner scripts for later evaluation
if ( elem.nodeType == 1 )
scripts = scripts.add( jQuery( "script", elem ).remove() );
// Inject the elements into the document
callback.call( obj, elem );
}
});
scripts.each( evalScript );
});
}
};
// Give the init function the jQuery prototype for later instantiation
jQuery.fn.init.prototype = jQuery.fn;
function evalScript( i, elem ) {
/// <summary>
/// 这是内部方法。
/// </summary>
/// <private />
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(){
/// <summary>
/// 获得当前日期。
/// </summary>
/// <returns type="Date">当前日期</returns>
return +new Date;
}
jQuery.extend = jQuery.fn.extend = function() {
/// <summary>
/// 用一个或多个其他对象来扩展一个对象，返回被扩展的对象。
/// 用于简化继承。
/// jQuery.extend(settings, options);
/// var settings = jQuery.extend({}, defaults, options);
/// Part of JavaScript
/// </summary>
/// <param name="target" type="Object">
/// 待修改对象。
/// </param>
/// <param name="prop1" type="Object">
/// 待合并到第一个对象的对象。
/// </param>
/// <param name="propN" type="Object" optional="true" parameterArray="true">
/// (可选) 待合并到第一个对象的对象。
/// </param>
/// <returns type="Object" />
// copy reference to target object
var target = arguments[0] || {}, i = 1, length = arguments.length, deep = false, options;
// Handle a deep copy situation
if ( target.constructor == 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" && typeof target != "function" )
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;
};
var expando = "jQuery" + now(), uuid = 0, windowData = {},
// exclude the following css properties to add px
exclude = /z-?index|font-?weight|opacity|zoom|line-?height/i,
// cache defaultView
defaultView = document.defaultView || {};
jQuery.extend({
noConflict: function( deep ) {
/// <summary>
/// 扩展jQuery对象本身。
/// 用来在jQuery命名空间上增加新函数。
/// 使用这个函数必须以jQuery 开头，不能用$开头
/// Part of Core
/// </summary>
/// <returns type="undefined" />
window.$ = _$;
if ( deep )
window.jQuery = _jQuery;
return jQuery;
},
// See test/unit/core.js for details concerning this function.
isFunction: function( fn ) {
/// <summary>
/// 确定是否通过参数是一个函数。
/// </summary>
/// <param name="fn" type="Object">要检查的对象</param>
/// <returns type="Boolean">参数是函数就返回true，否则返回false。</returns>
return !!fn && typeof fn != "string" && !fn.nodeName &&
fn.constructor != Array && /^[\s[]?function/.test( fn + "" );
},
// check if an element is in a (or is an) XML document
isXMLDoc: function( elem ) {
/// <summary>
/// 确定是否通过参数是一个XML文档。
/// </summary>
/// <param name="elem" type="Object">要监察的对象</param>
/// <returns type="Boolean">参数是XML文档就返回true，否则返回false。</returns>
return elem.documentElement && !elem.body ||
elem.tagName && elem.ownerDocument && !elem.ownerDocument.body;
},
// Evalulates a script in a global context
globalEval: function( data ) {
/// <summary>
/// Internally evaluates a script in a global context.
/// </summary>
/// <private />
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.browser.msie )
script.text = data;
else
script.appendChild( document.createTextNode( 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 ) {
/// <summary>
/// 检查指定的元素里是否有指定的DOM节点的名称。
/// </summary>
/// <param name="elem" type="Element">要检查的元素</param>
/// <param name="name" type="String">要确认的节点名称</param>
/// <returns type="Boolean">如果指定的节点名称匹配对应的节点的DOM节点名称返回true; 否则返回 false</returns>
return elem.nodeName && elem.nodeName.toUpperCase() == name.toUpperCase();
},
cache: {},
data: function( elem, name, data ) {
/// <summary>
/// 在元素上存放数据，同时也返回value。
/// </summary>
/// <param name="elem" type="Element">要存放数据的元素</param>
/// <param name="name" type="String">存储的数据名</param>
/// <param name="data" type="Object">要存储的数据</param>
/// <returns type="Object">数据参数已经存储</returns>
elem = elem == window ?
windowData :
elem;
var id = elem[ expando ];
// Compute a unique ID for the element
if ( !id )
id = elem[ expando ] = ++uuid;
// Only generate the data cache if we're
// trying to access or manipulate it
if ( name && !jQuery.cache[ id ] )
jQuery.cache[ id ] = {};
// Prevent overriding the named cache with undefined values
if ( data !== undefined )
jQuery.cache[ id ][ name ] = data;
// Return the named cache data, or the ID for the element
return name ?
jQuery.cache[ id ][ name ] :
id;
},
removeData: function( elem, name ) {
/// <summary>
/// 在元素上移除存放的数据，与$(...).data(name, value)函数作用相反
/// </summary>
/// <param name="elem" type="Element">要删除数据的元素名</param>
/// <param name="name" type="String">要删除的的数据名</param>
elem = elem == window ?
windowData :
elem;
var id = elem[ expando ];
// If we want to remove a specific section of the element's data
if ( name ) {
if ( jQuery.cache[ id ] ) {
// Remove the section of cache data
delete jQuery.cache[ id ][ name ];
// If we've removed all the data, remove the element's cache
name = "";
for ( name in jQuery.cache[ id ] )
break;
if ( !name )
jQuery.removeData( elem );
}
// Otherwise, we want to remove all of the element's data
} else {
// Clean up the element expando
try {
delete elem[ expando ];
} catch(e){
// IE has trouble directly removing the expando
// but it's ok with using removeAttribute
if ( elem.removeAttribute )
elem.removeAttribute( expando );
}
// Completely remove the data cache
delete jQuery.cache[ id ];
}
},
// args is for internal usage only
each: function( object, callback, args ) {
/// <summary>
/// 以每一个匹配的元素作为上下文来执行一个函数。
/// 意味着，每次执行传递进来的函数时，
/// 函数中的this关键字都指向一个不同的DOM元素（每次都是一个不同的匹配元素）。
/// 而且，在每次执行函数时，都会给函数传递一个表示作为执行环境的元素在匹配的元素集合中所处位置的数字值作为参数（从零开始的整形）。
/// 返回 'false' 将停止循环 (就像在普通的循环中使用 'break')。
/// 返回 'true' 跳至下一个循环(就像在普通的循环中使用'continue')。
/// Part of JavaScript
/// </summary>
/// <param name="obj" type="Object">
/// 要迭代的对象或数组
/// </param>
/// <param name="fn" type="Function">
/// 对于每个匹配的元素所要执行的函数
/// </param>
/// <returns type="Object" />
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 ) {
/// <summary>
/// This method is internal.
/// </summary>
/// <private />
// 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 value && value.constructor == Number && type == "curCSS" && !exclude.test( name ) ?
value + "px" :
value;
},
className: {
// internal only, use addClass("class")
add: function( elem, classNames ) {
/// <summary>
/// Internal use only; use addClass('class')
/// </summary>
/// <private />
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 ) {
/// <summary>
/// Internal use only; use removeClass('class')
/// </summary>
/// <private />
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 ) {
/// <summary>
/// Internal use only; use hasClass('class')
/// </summary>
/// <private />
return 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 ) {
/// <summary>
/// Swap in/out style options.
/// </summary>
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 ) {
/// <summary>
/// 在所有匹配的元素中，设置或取得一个样式属性的值。数字将自动转化为像素值
/// </summary>
/// <private />
// 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 ) {
/// <summary>
/// This method is internal only.
/// </summary>
/// <private />
// This method is undocumented in jQuery API: http://docs.jquery.com/action/edit/Internals/jQuery.curCSS
var ret, style = elem.style;
// A helper method for determining if an element's values are broken
function color( elem ) {
if ( !jQuery.browser.safari )
return false;
// defaultView is cached
var ret = defaultView.getComputedStyle( elem, null );
return !ret || ret.getPropertyValue("color") == "";
}
// We need to handle opacity special in IE
if ( name == "opacity" && jQuery.browser.msie ) {
ret = jQuery.attr( style, "opacity" );
return ret == "" ?
"1" :
ret;
}
// Opera sometimes will give the wrong display answer, this fixes it, see #2037
if ( jQuery.browser.opera && name == "display" ) {
var save = style.outline;
style.outline = "0 solid black";
style.outline = save;
}
// 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 && !color( elem ) )
ret = computedStyle.getPropertyValue( name );
// If the element isn't reporting its values properly in Safari
// then some display: none elements are involved
else {
var swap = [], stack = [], a = elem, i = 0;
// Locate all of the parent display: none elements
for ( ; a && color(a); a = a.parentNode )
stack.unshift(a);
// Go through and make them visible, but in reverse
// (It would be better if we knew the exact display type that they had)
for ( ; i < stack.length; i++ )
if ( color( stack[ i ] ) ) {
swap[ i ] = stack[ i ].style.display;
stack[ i ].style.display = "block";
}
// Since we flip the display style, we have to handle that
// one special, otherwise get the value
ret = name == "display" && swap[ stack.length - 1 ] != null ?
"none" :
( computedStyle && computedStyle.getPropertyValue( name ) ) || "";
// Finally, revert the display styles back
for ( i = 0; i < swap.length; i++ )
if ( swap[ i ] != null )
stack[ i ].style.display = swap[ i ];
}
// 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 ) {
/// <summary>
/// This method is internal only.
/// </summary>
/// <private />
// This method is undocumented in the jQuery API: http://docs.jquery.com/action/edit/Internals/jQuery.clean
var ret = [];
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;
jQuery.each(elems, function(i, elem){
if ( !elem )
return;
if ( elem.constructor == Number )
elem += '';
// 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(), div = context.createElement("div");
var wrap =
// option or optgroup
!tags.indexOf("<opt") &&
[ 1, "<select multiple='multiple'>", "</select>" ] ||
!tags.indexOf("<leg") &&
[ 1, "<fieldset>", "</fieldset>" ] ||
tags.match(/^<(thead|tbody|tfoot|colg|cap)/) &&
[ 1, "<table>", "</table>" ] ||
!tags.indexOf("<tr") &&
[ 2, "<table><tbody>", "</tbody></table>" ] ||
// <thead> matched above
(!tags.indexOf("<td") || !tags.indexOf("<th")) &&
[ 3, "<table><tbody><tr>", "</tr></tbody></table>" ] ||
!tags.indexOf("<col") &&
[ 2, "<table><tbody></tbody><colgroup>", "</colgroup></table>" ] ||
// IE can't serialize <link> and <script> tags normally
jQuery.browser.msie &&
[ 1, "div<div>", "</div>" ] ||
[ 0, "", "" ];
// Go to html and back, then peel off extra wrappers
div.innerHTML = wrap[1] + elem + wrap[2];
// Move to the right depth
while ( wrap[0]-- )
div = div.lastChild;
// Remove IE's autoinserted <tbody> from table fragments
if ( jQuery.browser.msie ) {
// String was a <table>, *may* have spurious <tbody>
var tbody = !tags.indexOf("<table") && tags.indexOf("<tbody") < 0 ?
div.firstChild && div.firstChild.childNodes :
// String was a bare <thead> or <tfoot>
wrap[1] == "<table>" && tags.indexOf("<tbody") < 0 ?
div.childNodes :
[];
for ( var j = tbody.length - 1; j >= 0 ; --j )
if ( jQuery.nodeName( tbody[ j ], "tbody" ) && !tbody[ j ].childNodes.length )
tbody[ j ].parentNode.removeChild( tbody[ j ] );
// IE completely kills leading whitespace when innerHTML is used
if ( /^\s/.test( elem ) )
div.insertBefore( context.createTextNode( elem.match(/^\s*/)[0] ), div.firstChild );
}
elem = jQuery.makeArray( div.childNodes );
}
if ( elem.length === 0 && (!jQuery.nodeName( elem, "form" ) && !jQuery.nodeName( elem, "select" )) )
return;
if ( elem[0] == undefined || jQuery.nodeName( elem, "form" ) || elem.options )
ret.push( elem );
else
ret = jQuery.merge( ret, elem );
});
return ret;
},
attr: function( elem, name, value ) {
/// <summary>
/// 取得第一个匹配元素的属性值。通过这个方法可以方便地从第一个匹配元素中获取一个属性的值。
/// 如果元素没有相应属性，则返回 undefined 。
/// </summary>
/// <private />
// don't set attributes on text and comment nodes
if (!elem || elem.nodeType == 3 || elem.nodeType == 8)
return undefined;
var notxml = !jQuery.isXMLDoc( elem ),
// Whether we are setting (or getting)
set = value !== undefined,
msie = jQuery.browser.msie;
// Try to normalize/fix the name
name = notxml && jQuery.props[ name ] || name;
// Only do all the following if this is a node (faster for style)
// IE elem.getAttribute passes even for style
if ( elem.tagName ) {
// These attributes require special treatment
var special = /href|src|style/.test( name );
// Safari mis-reports the default selected property of a hidden option
// Accessing the parent's selectedIndex property fixes it
if ( name == "selected" && jQuery.browser.safari )
elem.parentNode.selectedIndex;
// If applicable, access the attribute via the DOM 0 way
if ( name in elem && notxml && !special ) {
if ( set ){
// We can't allow the type property to be changed (since it causes problems in IE)
if ( name == "type" && jQuery.nodeName( elem, "input" ) && elem.parentNode )
throw "type property can't be changed";
elem[ name ] = value;
}
// browsers index elements by id/name on forms, give priority to attributes.
if( jQuery.nodeName( elem, "form" ) && elem.getAttributeNode(name) )
return elem.getAttributeNode( name ).nodeValue;
return elem[ name ];
}
if ( msie && notxml && name == "style" )
return jQuery.attr( elem.style, "cssText", value );
if ( set )
// convert the value to a string (all browsers do this but IE) see #1070
elem.setAttribute( name, "" + value );
var attr = msie && notxml && special
// Some attributes require a special call on IE
? elem.getAttribute( name, 2 )
: elem.getAttribute( name );
// Non-existent attributes return null, we normalize to undefined
return attr === null ? undefined : attr;
}
// elem is actually elem.style ... set the style
// IE uses filters for opacity
if ( msie && name == "opacity" ) {
if ( set ) {
// IE has trouble with opacity if it does not have layout
// Force it by setting the zoom level
elem.zoom = 1;
// Set the alpha filter to set the opacity
elem.filter = (elem.filter || "").replace( /alpha\([^)]*\)/, "" ) +
(parseInt( value ) + '' == "NaN" ? "" : "alpha(opacity=" + value * 100 + ")");
}
return elem.filter && elem.filter.indexOf("opacity=") >= 0 ?
(parseFloat( elem.filter.match(/opacity=([^)]*)/)[1] ) / 100) + '':
"";
}
name = name.replace(/-([a-z])/ig, function(all, letter){
return letter.toUpperCase();
});
if ( set )
elem[ name ] = value;
return elem[ name ];
},
trim: function( text ) {
/// <summary>
/// 去掉字符串起始和结尾的空格。
/// Part of JavaScript
/// </summary>
/// <returns type="String" />
/// <param name="text" type="String">
/// 要去空格的字符串
/// </param>
return (text || "").replace( /^\s+|\s+$/g, "" );
},
makeArray: function( array ) {
/// <summary>
/// 将类数组对象转换为数组对象。
/// 类数组对象有 length 属性，其成员索引为 0 至 length - 1。实际中此函数在 jQuery 中将自动使用而无需特意转换。
/// </summary>
/// <param name="array" type="Object">要转换为数组对象的类数组对象。</param>
/// <returns type="Array" />
/// <private />
var ret = [];
if( array != null ){
var i = array.length;
//the window, strings and functions also have 'length'
if( i == null || array.split || array.setInterval || array.call )
ret[0] = array;
else
while( i )
ret[--i] = array[i];
}
return ret;
},
inArray: function( elem, array ) {
/// <summary>
/// 确定第一个参数在数组中的位置(如果没有找到则返回 -1 )。
/// </summary>
/// <param name="elem">用于在数组中查找是否存在的值</param>
/// <param name="array" type="Array">待处理数组。</param>
/// <returns type="Number" integer="true">如果找到，则从0开始累计，没有找到则返回 -1</returns>
for ( var i = 0, length = array.length; i < length; i++ )
// Use === because on IE, window == document
if ( array[ i ] === elem )
return i;
return -1;
},
merge: function( first, second ) {
/// <summary>
/// 两个参数都是数组，排除第二个数组中与第一个相同的，再将两个数组合并
/// Part of JavaScript
/// </summary>
/// <returns type="Array" />
/// <param name="first" type="Array">
/// The first array to merge.
/// </param>
/// <param name="second" type="Array">
/// The second array to merge.
/// </param>
// We have to loop this way because IE & Opera overwrite the length
// expando of getElementsByTagName
var i = 0, elem, pos = first.length;
// Also, we need to make sure that the correct elements are being returned
// (IE returns comment nodes in a '*' query)
if ( jQuery.browser.msie ) {
while ( elem = second[ i++ ] )
if ( elem.nodeType != 8 )
first[ pos++ ] = elem;
} else
while ( elem = second[ i++ ] )
first[ pos++ ] = elem;
return first;
},
unique: function( array ) {
/// <summary>
/// 删除元素数组中所有的重复元素。
/// </summary>
/// <param name="array" type="Array<Element>">要转换的数组</param>
/// <returns type="Array<Element>">转换后的数组</returns>
var ret = [], done = {};
try {
for ( var i = 0, length = array.length; i < length; i++ ) {
var id = jQuery.data( array[ i ] );
if ( !done[ id ] ) {
done[ id ] = true;
ret.push( array[ i ] );
}
}
} catch( e ) {
ret = array;
}
return ret;
},
grep: function( elems, callback, inv ) {
/// <summary>
/// 使用过滤函数过滤数组元素。
/// 此函数至少传递两个参数：待过滤数组和过滤函数。
/// 过滤函数必须返回 true 以保留元素或 false 以删除元素。
/// });
/// Part of JavaScript
/// </summary>
/// <returns type="Array" />
/// <param name="elems" type="Array">
/// 待过滤数组。
/// </param>
/// <param name="fn" type="Function">
/// 此函数将处理数组每个元素。第一个参数为当前元素，第二个参数而元素索引值。
/// 此函数应返回一个布尔值。另外，此函数可设置为一个字符串，当设置为字符串时，将视为“lambda-form”（缩写形式？），
/// 其中 a 代表数组元素，i 代表元素索引值。如“a > 0”代表“function(a){ return a > 0; }”。
/// </param>
/// <param name="inv" type="Boolean">
/// (可选) 如果 "invert" 为 false 或为设置，则函数返回数组中由过滤函数返回 true 的元素，
/// 当"invert" 为 true，则返回过滤函数中返回 false 的元素集。
/// </param>
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 ) {
/// <summary>
/// 将一个数组中的元素转换到另一个数组中。
/// 作为参数的转换函数会为每个数组元素调用，
/// 而且会给这个转换函数传递一个表示被转换的元素作为参数。
/// 转换函数可以返回转换后的值、null（删除数组中的项目）
/// 或一个包含值的数组，并扩展至原始数组中。
/// Part of JavaScript
/// </summary>
/// <returns type="Array" />
/// <param name="elems" type="Array">
/// 待转换数组。
/// </param>
/// <param name="fn" type="Function">
/// 为每个数组元素调用，而且会给这个转换函数传递一个表示被转换的元素作为参数。函数可返回任何值。
/// 另外，此函数可设置为一个字符串，当设置为字符串时，将视为“lambda-form”（缩写形式？）
/// ，其中 a 代表数组元素。如“a * a”代表“function(a){ return a * a; }”。
/// </param>
var ret = [];
// 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++ ) {
var value = callback( elems[ i ], i );
if ( value != null )
ret[ ret.length ] = value;
}
return ret.concat.apply( [], ret );
}
});
var userAgent = navigator.userAgent.toLowerCase();
// Figure out what browser is being used
jQuery.browser = {
version: (userAgent.match( /.+(?:rv|it|ra|ie)[\/: ]([\d.]+)/ ) || [])[1],
safari: /webkit/.test( userAgent ),
opera: /opera/.test( userAgent ),
msie: /msie/.test( userAgent ) && !/opera/.test( userAgent ),
mozilla: /mozilla/.test( userAgent ) && !/(compatible|webkit)/.test( userAgent )
};
var styleFloat = jQuery.browser.msie ?
"styleFloat" :
"cssFloat";
jQuery.extend({
// Check to see if the W3C box model is being used
boxModel: !jQuery.browser.msie || document.compatMode == "CSS1Compat",
props: {
"for": "htmlFor",
"class": "className",
"float": styleFloat,
cssFloat: styleFloat,
styleFloat: styleFloat,
readonly: "readOnly",
maxlength: "maxLength",
cellspacing: "cellSpacing"
}
});
jQuery.each({
parent: function(elem){return elem.parentNode;}
}, function(name, fn){
jQuery.fn[ name ] = function( selector ) {
/// <summary>
/// 取得一个包含着所有匹配元素的唯一父元素的元素集合。
/// 你可以使用可选的表达式来筛选。
/// Part of DOM/Traversing
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选)用来筛选的表达式
/// </param>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
parents: function(elem){return jQuery.dir(elem,"parentNode");}
}, function(name, fn){
jQuery.fn[ name ] = function( selector ) {
/// <summary>
/// 取得一组包含唯一祖先元素的比配元素
/// （除了根元素）
/// 你可以使用可选的表达式来筛选。
/// Part of DOM/Traversing
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选) 用来筛选元素的表达式
/// </param>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
next: function(elem){return jQuery.nth(elem,2,"nextSibling");}
}, function(name, fn){
jQuery.fn[ name ] = function( selector ) {
/// <summary>
/// 取得一组包含唯一后一个兄弟元素的比配元素
/// 它只能返回下一个子元素，而不是所有的子元素
/// 你可以使用可选的表达式来筛选。
/// Part of DOM/Traversing
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选) 用来筛选兄弟元素的表达式
/// </param>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
prev: function(elem){return jQuery.nth(elem,2,"previousSibling");}
}, function(name, fn){
jQuery.fn[ name ] = function( selector ) {
/// <summary>
/// 取得一组包含唯一前一个兄弟元素的比配元素
/// 它只能返回前一个子元素，而不是所有的子元素
/// 你可以使用可选的表达式来筛选。
/// Part of DOM/Traversing
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选) 用来筛选兄弟元素的表达式
/// </param>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
nextAll: function(elem){return jQuery.dir(elem,"nextSibling");}
}, function(name, fn){
jQuery.fn[name] = function(selector) {
/// <summary>
/// 找出当前元素后的所有元素
/// 你可以使用可选的表达式来筛选。
/// Part of DOM/Traversing
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选) 用来筛选元素的表达式
/// </param>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
prevAll: function(elem){return jQuery.dir(elem,"previousSibling");}
}, function(name, fn){
jQuery.fn[ name ] = function( selector ) {
/// <summary>
/// 找出当前元素前面的所有兄弟元素
/// 你可以使用可选的表达式来筛选。
/// Part of DOM/Traversing
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选) 用来筛选兄弟元素的表达式
/// </param>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
siblings: function(elem){return jQuery.sibling(elem.parentNode.firstChild,elem);}
}, function(name, fn){
jQuery.fn[ name ] = function( selector ) {
/// <summary>
/// 迭代并取得一组包含唯一所有兄弟元素的比配元素
/// 你可以使用可选的表达式来筛选。
/// Part of DOM/Traversing
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选) 用来筛选兄弟元素的表达式
/// </param>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
children: function(elem){return jQuery.sibling(elem.firstChild);}
}, function(name, fn){
jQuery.fn[ name ] = function( selector ) {
/// <summary>
/// 迭代并取得一组包含唯一所有子元素的比配元素
/// 你可以使用可选的表达式来筛选。
/// Part of DOM/Traversing
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选) 用来筛选子元素的表达式
/// </param>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
contents: function(elem){return jQuery.nodeName(elem,"iframe")?elem.contentDocument||elem.contentWindow.document:jQuery.makeArray(elem.childNodes);}
}, function(name, fn){
jQuery.fn[ name ] = function( selector ) {
/// <summary>找出下一结点（如果元素是一个iframe，就是文档内容）中所有匹配元素的子节点</summary>
/// <returns type="jQuery" />
var ret = jQuery.map( this, fn );
if ( selector && typeof selector == "string" )
ret = jQuery.multiFilter( selector, ret );
return this.pushStack( jQuery.unique( ret ) );
};
});
jQuery.each({
appendTo: "append"
}, function(name, original){
jQuery.fn[ name ] = function() {
/// <summary>
/// 把所有匹配的元素追加到另一个、指定的元素元素集合中。
/// 实际上，使用这个方法是颠倒了常规的$(A).append(B)的操作，
/// 即不是把B追加到A中，而是把A追加到B中。
/// Part of DOM/Manipulation
/// </summary>
/// <param name="content" type="Content">
/// 用于被追加的内容
/// </param>
/// <returns type="jQuery" />
var args = arguments;
return this.each(function(){
for ( var i = 0, length = args.length; i < length; i++ )
jQuery( args[ i ] )[ original ]( this );
});
};
});
jQuery.each({
prependTo: "prepend"
}, function(name, original){
jQuery.fn[ name ] = function() {
/// <summary>
/// 把所有匹配的元素前置到另一个、指定的元素元素集合中。
/// 实际上，使用这个方法是颠倒了常规的$(A).prepend(B)的操作，
/// 即不是把B前置到A中，而是把A前置到B中。
/// Part of DOM/Manipulation
/// </summary>
/// <param name="content" type="Content">
/// 用于匹配元素的内容
/// </param>
/// <returns type="jQuery" />
var args = arguments;
return this.each(function(){
for ( var i = 0, length = args.length; i < length; i++ )
jQuery( args[ i ] )[ original ]( this );
});
};
});
jQuery.each({
insertBefore: "before"
}, function(name, original){
jQuery.fn[ name ] = function() {
/// <summary>
/// 把所有匹配的元素插入到另一个、指定的元素元素集合的前面。
/// 实际上，使用这个方法是颠倒了常规的$(A).before(B)的操作，
/// 即不是把B插入到A前面，而是把A插入到B前面。
/// Part of DOM/Manipulation
/// </summary>
/// <param name="content" type="Content">
/// 用于匹配元素的内容
/// </param>
/// <returns type="jQuery" />
var args = arguments;
return this.each(function(){
for ( var i = 0, length = args.length; i < length; i++ )
jQuery( args[ i ] )[ original ]( this );
});
};
});
jQuery.each({
insertAfter: "after"
}, function(name, original){
jQuery.fn[ name ] = function() {
/// <summary>
/// 把所有匹配的元素插入到另一个、指定的元素元素集合的后面。
/// 实际上，使用这个方法是颠倒了常规的$(A).after(B)的操作，
/// 即不是把B插入到A后面，而是把A插入到B后面。
/// Part of DOM/Manipulation
/// </summary>
/// <param name="content" type="Content">
/// 用于匹配元素的内容
/// </param>
/// <returns type="jQuery" />
var args = arguments;
return this.each(function(){
for ( var i = 0, length = args.length; i < length; i++ )
jQuery( args[ i ] )[ original ]( this );
});
};
});
jQuery.each({
replaceAll: "replaceWith"
}, function(name, original){
jQuery.fn[ name ] = function() {
/// <summary>用匹配的元素替换掉所有 （selector选择器）匹配到的元素。</summary>
/// <param name="selector" type="String">（selector选择器）用于查找所要被替换的元素</param>
/// <returns type="jQuery" />
var args = arguments;
return this.each(function(){
for ( var i = 0, length = args.length; i < length; i++ )
jQuery( args[ i ] )[ original ]( this );
});
};
});
jQuery.each({
removeAttr: function( name ) {
jQuery.attr( this, name, "" );
if (this.nodeType == 1)
this.removeAttribute( name );
}
}, function(name, fn){
jQuery.fn[ name ] = function(){
/// <summary>
/// 从每一个匹配的元素中删除一个属性
/// Part of DOM/Attributes
/// </summary>
/// <param name="key" type="String">
/// 要删除的属性名
/// </param>
/// <returns type="jQuery" />
return this.each(fn, arguments);
};
});
jQuery.each({
addClass: function(classNames) {
/// <summary>
/// 为每个匹配的元素添加指定的类名。
/// Part of DOM/Attributes
/// </summary>
/// <param name="classNames" type="String">
/// 一个或多个要添加到元素中的CSS类名，请用空格分开
/// </param>
/// <returns type="jQuery" />
jQuery.className.add(this, classNames);
}
}, function(name, fn) {
jQuery.fn[name] = function() {
/// <summary>
/// 为每个匹配的元素添加指定的类名。
/// Part of DOM/Attributes
/// </summary>
/// <param name="classNames" type="String">
/// 一个或多个要添加到元素中的CSS类名，请用空格分开
/// </param>
/// <returns type="jQuery" />
return this.each(fn, arguments);
};
});
jQuery.each({
removeClass: function( classNames ) {
jQuery.className.remove( this, classNames );
}
}, function(name, fn){
jQuery.fn[ name ] = function(){
/// <summary>
/// 从所有匹配的元素中删除全部或者指定的类。
/// Part of DOM/Attributes
/// </summary>
/// <param name="cssClasses" type="String" optional="true">
/// (可选) 一个或多个要删除的CSS类名，请用空格分开
/// </param>
/// <returns type="jQuery" />
return this.each(fn, arguments);
};
});
jQuery.each({
toggleClass: function( classNames ) {
jQuery.className[ jQuery.className.has( this, classNames ) ? "remove" : "add" ]( this, classNames );
}
}, function(name, fn){
jQuery.fn[ name ] = function(){
/// <summary>
/// 如果存在（不存在）就删除（添加）一个类。
/// Part of DOM/Attributes
/// </summary>
/// <param name="cssClass" type="String">
/// CSS类名
/// </param>
/// <returns type="jQuery" />
return this.each(fn, arguments);
};
});
jQuery.each({
remove: function( selector ) {
if ( !selector || jQuery.filter( selector, [ this ] ).r.length ) {
// Prevent memory leaks
jQuery( "*", this ).add(this).each(function(){
jQuery.event.remove(this);
jQuery.removeData(this);
});
if (this.parentNode)
this.parentNode.removeChild( this );
}
}
}, function(name, fn){
jQuery.fn[ name ] = function(){
/// <summary>
/// 从DOM中删除所有匹配的元素。
/// 这个方法不会把匹配的元素从jQuery对象中删除，
/// 因而可以在将来再使用这些匹配的元素。
/// Part of DOM/Manipulation
/// </summary>
/// <param name="expr" type="String" optional="true">
/// (可选) 用于筛选元素的jQuery表达式
/// </param>
/// <returns type="jQuery" />
return this.each(fn, arguments);
};
});
jQuery.each({
empty: function() {
// Remove element nodes and prevent memory leaks
jQuery( ">*", this ).remove();
// Remove any remaining nodes
while ( this.firstChild )
this.removeChild( this.firstChild );
}
}, function(name, fn){
jQuery.fn[ name ] = function(){
/// <summary>
/// 删除匹配的元素集合中所有的子节点。
/// Part of DOM/Manipulation
/// </summary>
/// <returns type="jQuery" />
return this.each( fn, arguments );
};
});
jQuery.each([ "Height" ], function(i, name){
var type = name.toLowerCase();
jQuery.fn[ type ] = function( size ) {
/// <summary>
/// 为每个匹配的元素设置CSS高度(hidth)属性的值。
/// 如果没有明确指定单位（如：em或%），使用px。
/// 如果没有指定参数，就会得到第一个匹配元素的当前计算高度。
/// Part of CSS
/// </summary>
/// <returns type="jQuery" type="jQuery" />
/// <param name="cssProperty" type="String">
/// 设定CSS中 'height' 的值
/// </param>
// Get window width or height
return this[0] == window ?
// Opera reports document.body.client[Width/Height] properly in both quirks and standards
jQuery.browser.opera && document.body[ "client" + name ] ||
// Safari reports inner[Width/Height] just fine (Mozilla and Opera include scroll bar widths)
jQuery.browser.safari && window[ "inner" + name ] ||
// Everyone else use document.documentElement or document.body depending on Quirks vs Standards mode
document.compatMode == "CSS1Compat" && document.documentElement[ "client" + name ] || document.body[ "client" + name ] :
// Get document width or height
this[0] == document ?
// Either scroll[Width/Height] or offset[Width/Height], whichever is greater
Math.max(
Math.max(document.body["scroll" + name], document.documentElement["scroll" + name]),
Math.max(document.body["offset" + name], document.documentElement["offset" + name])
) :
// Get or set width or height on the element
size == undefined ?
// Get width or height on the element
(this.length ? jQuery.css( this[0], type ) : null) :
// Set the width or height on the element (default to pixels if value is unitless)
this.css( type, size.constructor == String ? size : size + "px" );
};
});
jQuery.each([ "Width" ], function(i, name){
var type = name.toLowerCase();
jQuery.fn[ type ] = function( size ) {
/// <summary>
/// 为每个匹配的元素设置CSS宽度(width)属性的值。
/// 如果没有明确指定单位（如：em或%），使用px。
/// 如果没有指定参数，就会得到第一个匹配元素的当前计算宽度。
/// Part of CSS
/// </summary>
/// <returns type="jQuery" type="jQuery" />
/// <param name="cssProperty" type="String">
/// 设定 CSS 'width' 的属性值
/// </param>
// Get window width or height
return this[0] == window ?
// Opera reports document.body.client[Width/Height] properly in both quirks and standards
jQuery.browser.opera && document.body[ "client" + name ] ||
// Safari reports inner[Width/Height] just fine (Mozilla and Opera include scroll bar widths)
jQuery.browser.safari && window[ "inner" + name ] ||
// Everyone else use document.documentElement or document.body depending on Quirks vs Standards mode
document.compatMode == "CSS1Compat" && document.documentElement[ "client" + name ] || document.body[ "client" + name ] :
// Get document width or height
this[0] == document ?
// Either scroll[Width/Height] or offset[Width/Height], whichever is greater
Math.max(
Math.max(document.body["scroll" + name], document.documentElement["scroll" + name]),
Math.max(document.body["offset" + name], document.documentElement["offset" + name])
) :
// Get or set width or height on the element
size == undefined ?
// Get width or height on the element
(this.length ? jQuery.css( this[0], type ) : null) :
// Set the width or height on the element (default to pixels if value is unitless)
this.css( type, size.constructor == String ? size : size + "px" );
};
});
// Helper function used by the dimensions and offset modules
function num(elem, prop) {
return elem[0] && parseInt( jQuery.curCSS(elem[0], prop, true), 10 ) || 0;
}var chars = jQuery.browser.safari && parseInt(jQuery.browser.version) < 417 ?
"(?:[\\w*_-]|\\\\.)" :
"(?:[\\w\u0128-\uFFFF*_-]|\\\\.)",
quickChild = new RegExp("^>\\s*(" + chars + "+)"),
quickID = new RegExp("^(" + chars + "+)(#)(" + chars + "+)"),
quickClass = new RegExp("^([#.]?)(" + chars + "*)");
jQuery.extend({
expr: {
"": function(a,i,m){return m[2]=="*"||jQuery.nodeName(a,m[2]);},
"#": function(a,i,m){return a.getAttribute("id")==m[2];},
":": {
// Position Checks
lt: function(a,i,m){return i<m[3]-0;},
gt: function(a,i,m){return i>m[3]-0;},
nth: function(a,i,m){return m[3]-0==i;},
eq: function(a,i,m){return m[3]-0==i;},
first: function(a,i){return i==0;},
last: function(a,i,m,r){return i==r.length-1;},
even: function(a,i){return i%2==0;},
odd: function(a,i){return i%2;},
// Child Checks
"first-child": function(a){return a.parentNode.getElementsByTagName("*")[0]==a;},
"last-child": function(a){return jQuery.nth(a.parentNode.lastChild,1,"previousSibling")==a;},
"only-child": function(a){return !jQuery.nth(a.parentNode.lastChild,2,"previousSibling");},
// Parent Checks
parent: function(a){return a.firstChild;},
empty: function(a){return !a.firstChild;},
// Text Check
contains: function(a,i,m){return (a.textContent||a.innerText||jQuery(a).text()||"").indexOf(m[3])>=0;},
// Visibility
visible: function(a){return "hidden"!=a.type&&jQuery.css(a,"display")!="none"&&jQuery.css(a,"visibility")!="hidden";},
hidden: function(a){return "hidden"==a.type||jQuery.css(a,"display")=="none"||jQuery.css(a,"visibility")=="hidden";},
// Form attributes
enabled: function(a){return !a.disabled;},
disabled: function(a){return a.disabled;},
checked: function(a){return a.checked;},
selected: function(a){return a.selected||jQuery.attr(a,"selected");},
// Form elements
text: function(a){return "text"==a.type;},
radio: function(a){return "radio"==a.type;},
checkbox: function(a){return "checkbox"==a.type;},
file: function(a){return "file"==a.type;},
password: function(a){return "password"==a.type;},
submit: function(a){return "submit"==a.type;},
image: function(a){return "image"==a.type;},
reset: function(a){return "reset"==a.type;},
button: function(a){return "button"==a.type||jQuery.nodeName(a,"button");},
input: function(a){return /input|select|textarea|button/i.test(a.nodeName);},
// :has()
has: function(a,i,m){return jQuery.find(m[3],a).length;},
// :header
header: function(a){return /h\d/i.test(a.nodeName);},
// :animated
animated: function(a){return jQuery.grep(jQuery.timers,function(fn){return a==fn.elem;}).length;}
}
},
// The regular expressions that power the parsing engine
parse: [
// Match: [@value='test'], [@foo]
/^(\[) *@?([\w-]+) *([!*$^~=]*) *('?"?)(.*?)\4 *\]/,
// Match: :contains('foo')
/^(:)([\w-]+)\("?'?(.*?(\(.*?\))?[^(]*?)"?'?\)/,
// Match: :even, :last-child, #id, .class
new RegExp("^([:.#]*)(" + chars + "+)")
],
multiFilter: function(expr, elems, not) {
/// <summary>
/// This member is internal only.
/// </summary>
/// <private />
// This member is not documented in the jQuery API: http://docs.jquery.com/action/edit/Internals/jQuery.multiFilter
var old, cur = [];
while ( expr && expr != old ) {
old = expr;
var f = jQuery.filter( expr, elems, not );
expr = f.t.replace(/^\s*,\s*/, "" );
cur = not ? elems = f.r : jQuery.merge( cur, f.r );
}
return cur;
},
find: function( t, context ) {
/// <summary>
/// This member is internal only.
/// </summary>
/// <private />
// This member is not documented in the jQuery API: http://docs.jquery.com/action/edit/Internals/jQuery.find
// Quickly handle non-string expressions
if ( typeof t != "string" )
return [ t ];
// check to make sure context is a DOM element or a document
if ( context && context.nodeType != 1 && context.nodeType != 9)
return [ ];
// Set the correct context (if none is provided)
context = context || document;
// Initialize the search
var ret = [context], done = [], last, nodeName;
// Continue while a selector expression exists, and while
// we're no longer looping upon ourselves
while ( t && last != t ) {
var r = [];
last = t;
t = jQuery.trim(t);
var foundToken = false,
// An attempt at speeding up child selectors that
// point to a specific element tag
re = quickChild,
m = re.exec(t);
if ( m ) {
nodeName = m[1].toUpperCase();
// Perform our own iteration and filter
for ( var i = 0; ret[i]; i++ )
for ( var c = ret[i].firstChild; c; c = c.nextSibling )
if ( c.nodeType == 1 && (nodeName == "*" || c.nodeName.toUpperCase() == nodeName) )
r.push( c );
ret = r;
t = t.replace( re, "" );
if ( t.indexOf(" ") == 0 ) continue;
foundToken = true;
} else {
re = /^([>+~])\s*(\w*)/i;
if ( (m = re.exec(t)) != null ) {
r = [];
var merge = {};
nodeName = m[2].toUpperCase();
m = m[1];
for ( var j = 0, rl = ret.length; j < rl; j++ ) {
var n = m == "~" || m == "+" ? ret[j].nextSibling : ret[j].firstChild;
for ( ; n; n = n.nextSibling )
if ( n.nodeType == 1 ) {
var id = jQuery.data(n);
if ( m == "~" && merge[id] ) break;
if (!nodeName || n.nodeName.toUpperCase() == nodeName ) {
if ( m == "~" ) merge[id] = true;
r.push( n );
}
if ( m == "+" ) break;
}
}
ret = r;
// And remove the token
t = jQuery.trim( t.replace( re, "" ) );
foundToken = true;
}
}
// See if there's still an expression, and that we haven't already
// matched a token
if ( t && !foundToken ) {
// Handle multiple expressions
if ( !t.indexOf(",") ) {
// Clean the result set
if ( context == ret[0] ) ret.shift();
// Merge the result sets
done = jQuery.merge( done, ret );
// Reset the context
r = ret = [context];
// Touch up the selector string
t = " " + t.substr(1,t.length);
} else {
// Optimize for the case nodeName#idName
var re2 = quickID;
var m = re2.exec(t);
// Re-organize the results, so that they're consistent
if ( m ) {
m = [ 0, m[2], m[3], m[1] ];
} else {
// Otherwise, do a traditional filter check for
// ID, class, and element selectors
re2 = quickClass;
m = re2.exec(t);
}
m[2] = m[2].replace(/\\/g, "");
var elem = ret[ret.length-1];
// Try to do a global search by ID, where we can
if ( m[1] == "#" && elem && elem.getElementById && !jQuery.isXMLDoc(elem) ) {
// Optimization for HTML document case
var oid = elem.getElementById(m[2]);
// Do a quick check for the existence of the actual ID attribute
// to avoid selecting by the name attribute in IE
// also check to insure id is a string to avoid selecting an element with the name of 'id' inside a form
if ( (jQuery.browser.msie||jQuery.browser.opera) && oid && typeof oid.id == "string" && oid.id != m[2] )
oid = jQuery('[@ + br) : 0);
};
});})();