不知该起什么题目,随便吧。不过我没心情逐一介绍其API,那是文档的事。比起那些随时会被废弃的方法,我更着重其内在的技术,所以我选择读源码。由于我 从不用jQuery,可能理解有些偏差。不过,看了这么多类库,有许多东西都是共通。比如这个jQuery对象就是DOM对象的加工工场,把DOM对象包 裹其中,外围是许多便捷的方法。我们可以想象一下太阳系,DOM就是太阳,css就其中一个行星,attr是另一个……之所以选择类数组形式,是为了用 map,filter等发端于数组的同名方法进行大数量的DOM操作。好了,下面就直接写在注解中吧。
?
var window = this,
undefined,
_jQuery = window.jQuery,
_$ = window.$,
//把window存入闭包中的同名变量,undefined的情形一样,的确是让更内围的作用域的方法调用时,不要跑到那么远
//_jQuery与_$用于以后重写
jQuery = window.jQuery = window.$ = function( selector, context ) {
? //用于返回一个jQuery对象
? return new jQuery.fn.init( selector, context );
},
//这东西看起来很唬人,其实就是想获取元素的标签名或ID
quickExpr = /^[^<]*(<(.|\s)+>)[^>]*$|^#([\w-]+)$/,
//检测是否一个简单的选择器,怎样才为之简单呢?
//就是一重类选择器,也就是这个样子.red,如果.red .dd就不合要求了
//看它的限制,一定要是类选择器,后面不能跟伪类选择器,ID选择器,属性选择器,第二重第三重的类选择器
//与并联选择器
isSimple = /^.[^:#\[\.,]*$/;
jQuery.fn = jQuery.prototype = {
init: function( selector, context ) {
? //如果为空就把document塞进jQuery对象中
? selector = selector || document;
? //如果第一个参数是DOM对象,那它肯定有nodeType吧,
? //是就开始创建索引,创建类数组对象
? //说白了就是一个hash,只不过键是数字,值是DOM对象
? //不过它除了[0],[1]等数字键外,还有"css","attr","addClass"等字符串键,它们的值对应方法
? //length属性是就Array.prototype.slice与map,filter等方法准备
? //this.context是作为下次搜索的起点,如DOMElement.getElementsByTagName("span")
? if ( selector.nodeType ) {
? ? this[0] = selector;
? ? this.length = 1;
? ? this.context = selector;
? ? return this;
? }
? //如果传入的是CSS selector字段
? if ( typeof selector === "string" ) {
? ? //如果是很单的tagName或ID
? ? var match = quickExpr.exec( selector );
? ? //选择器类似h1的情形 ? ? ?
? ? if ( match && (match[1] || !context) ) {
? ? ? //如果是标签
? ? ? if ( match[1] )
? ? ? //clean方法不厚道地放到800行之后,针对许多特殊情况做处理
? ? ? ? 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
? ? ? ? //在IE与Opera中,ID并不一定返回一个元素,这时用name来查找
? ? ? ? if ( elem && elem.id != match[3] )
? ? ? ? ? return jQuery().find( selector );
? ? ? ? //由于ID有排他性,因此需要清空前面的context, ? ? ?
? ? ? ? var ret = jQuery( elem || [] );
? ? ? ? //重设搜索起点,
? ? ? ? ret.context = document;
? ? ? ? //安装DOM对象
? ? ? ? ret.selector = selector;
? ? ? ? return ret;
? ? ? }
? ? ? // HANDLE: $(expr, [context])
? ? ? // (which is just equivalent to: $(content).find(expr)
? ? } else
? ? //处理非常复杂的选择器,如镶嵌的CSS3选择器
? ? ? return jQuery( context ).find( selector );
? ? // HANDLE: $(function)
? ? // Shortcut for document ready
? ? //著名的DOMReady的,就是美元符号里面传入一个匿名函数
? } 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;
? }
? //确保以jQuery的类数组对象返回
? return this.setArray(jQuery.isArray( selector ) ?
? ? selector :
? ? jQuery.makeArray(selector));
},
?
基本上init就是个大熔炉,根据传入参数的类型做出不同的处理,如DOM对象,字符串,数组对象与NodeList这样的类数组对象转换成jQuery对象,如果是函数,则改成DOM加载。
?
// Start with an empty selector
selector: "",
// The current version of jQuery being used
jquery: "1.3.2",
//返回jQuery对象所包裹的DOM对象的数量
size: function() {
? ? return this.length;
},
//jQuery里面的方法都有一个特点,就是功能多
//如著名的css,即是读方法也是写方法
//这个可以返回一个纯数组
//也可以返回一个纯净的DOM对象(根据索引值)
get: function( num ) {
? ? return num === undefined ?
? ? ? ? // Return a 'clean' array
? ? ? ? Array.prototype.slice.call( 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 ) {
? ? ? ? //创建一个新的jQuery对象
? ? ? ? var ret = jQuery( elems );
? ? ? ?//保存原来jQuery对象的引用
? ? ? ? ret.prevObject = this;
? ? ? ? //把原来的context移过来,context在jQuery通常用作搜索的新起点
? ? ? ? ret.context = this.context;
? ? ? ?//把selector标记为一个特殊的字符串,以后再解析为jQuery对象
? ? ? ? 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
? ? //把许多元素一并放置到新的jQuery对象中,由于用Array.prototype.push,不用自己维护长度
? ? setArray: function( elems ) {
? ? ? ? // Resetting the length to 0, then using the native Array push
? ? ? ? // is a super-fast way to populate an object with array-like properties
? ? ? ? this.length = 0;
? ? ? ? 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.)
? ? //类似javascript1.6的forEach迭代器
? ? //这里是原型方法调用静态方法
? ? each: function( callback, args ) {
? ? ? ? return jQuery.each( this, callback, args );
? ? },
?
? ? //返回(DOM对象)elem在jQuery对象的位置(仅指数字键)
? ? //inArray的参数可以是jQuery对象,也可以是DOM对象
? ? //有点类似数组的indexOf
? ? index: function( elem ) {
? ? ? ? // 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 ) {
? ? 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
? ? //真正是用其静态方法工作,静态方法的优先级是相当高的,排列如下:
? ? //foo.abc() 高于 this.abc()
? ? //构造函数内的 this.abc() 高于 原型方法foo.prototype.abc
? ? //极晚绑定 fooInstance.abc()是优先级最低
? ? 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 )
? ? ? ? ? ? );
? ? });
},