jQuery源码解析2(Core)

 在上一篇中，我们介绍了jQuery Utilities部分的代码。 这一部分要看看Core部分的。

 

我们知道 $('#id') 或 jQuery('#id') 将会返回一个对象， 这个对象的构造函数是：jQuery.fn.init

 

	jQuery = window.jQuery = window.$ = function( selector, context ) {
		return new jQuery.fn.init( selector, context );
	},

 

jQuery.fn.init.prototype = jQuery.fn;

 

让我们先看看 jQuery.fn.init

 

jQuery.fn = jQuery.prototype = {
	init: function( selector, context ) {
		selector = selector || document;

 

selector 可以指定不同的数据类型，我们一个一个来：

 

1.  jQuery(element);  // an html dom element

 

		// Handle $(DOMElement)
		if ( selector.nodeType ) {
			this[0] = selector;
			this.length = 1;
			this.context = selector;
			return this;
		}

 

 所以我们可以这样使用：

 

var elem = $(element); // 用于包装一个html dom元素, 以便使用jQuery操作它。

 

注意到以上代码，所以我们还可以像数组一样使用它：）

 

elem[0]; // return html dom element

elem.length; //

 

 

2. jQuery(html, [context]),  jQuery(elements, [context])

 

 

		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 );

 

quickExpr 是一个正则式，用于匹配一个html string 或 id 字符串 (见第1篇)

 

以上部分处理这样的调用：

 

$('<div id="new-div" />')   

 

稍微浏览一下jQuery.clean， 知道它解析字符串，返回 html dom 元素的数组。 

 

解析之后， selector 是一个 html dom 元素的数组。

 

然后： 

 

		return this.setArray(jQuery.isArray( selector ) ?
			selector :
			jQuery.makeArray(selector));

 

// setArray 马上就会分析到（因为下面用到）

 

jQuery(elements, [context])

 

这个直接调用上面的setArray。

 

 

3. jQuery('#id')

 

如果是id字符串

 

 

				// 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;
				}

 

除去 IE 的 hack 部分

 

$('#id') 相当于：

 

var dom = document.getElementById('#id');

var elm = $(dom);
elm.context = document;
elm.selector = '#id'';

 

所以，使用 $('#id') 是非常快的，因为它直接调用 document.getElement 取得元素，不需要额外的解析。

 

//---

 

4. jQuery(callback);

 

 

			} else if ( jQuery.isFunction( selector ) )
				return jQuery( document ).ready( selector );

 

 

// 以下三个看喜欢选用。

$(function() {...}) ;

$(document).ready(function() {...}); 

$().ready(function() {...});

 

 

5. jQuery(css_selector, [context]); 

 

 

		if ( typeof selector === "string" ) {
			var match = quickExpr.exec( selector );
			if ( match && (match[1] || !context) ) {
				...
			} else
				return jQuery( context ).find( selector );

 

如果是除id 以外的 css 选择器， 那么就把这个艰巨任务的任务交给 

 

 jQuery( context ).find( selector );

 

6.  jQuery(jq)

 

		if ( selector.selector && selector.context ) {
			this.selector = selector.selector;
			this.context = selector.context;
		}

		return this.setArray(jQuery.isArray( selector ) ?
			selector :
			jQuery.makeArray(selector));

 

有时候我们这样：

 

var a = $('#id');

...

...

在某一个地方

$(a).click(...) 

 

就是重复包装了一个jquery对象(有时候忘记了，是一个jq对象还是一个html dom)。

这个速度也挺快的，因为只是进行简单的引用赋值。

 

---

setArray很简单：

 

 

	setArray: function( elems ) {
		this.length = 0;
		Array.prototype.push.apply( this, elems );
		return this;
	}

 

所以我们可以像使用数组一样引用jQuery中的dom元素

 

分析了 jQuery 的构造函数，下面看一些API 文档 Core 部分的方法。

 

先看 jQuery Object Accessors 部分

 

1. each(callback)

 

	each: function( callback, args ) {
		return jQuery.each( this, callback, args );
	},

 

args 内部使用。

 

2. size()

 

	size: function() {
		return this.length;
	},

 

3. length, selector, context

 

构造函数中已分析过

 

4. eq(i)

 

 

	eq: function( i ) {
		return this.slice( i, +i + 1 );
	},

 

 

+i, 就是 0+i, 常用于转成整形（如 +new Date())

 

假设我们有这样的html

<div class="mydiv" /> 
<div class="mydiv" /> 
<div iclass="mydiv" /> 
<div class="mydiv" /> 

<div class="mydiv" /> 

 

我们要对第3个节点进行操作，可以这样:

 

$('.mydiv').eq(3).css(...

 

5. get(), get(index)

 

 

	get: function( num ) {
		return num === undefined ?
			Array.prototype.slice.call( this ) :
			this[ num ];
	},

 

 

代码已直观到超出我的解释能力了。

 

6. index(elem)

 

 

	index: function( elem ) {
		return jQuery.inArray(
			elem && elem.jquery ? elem[0] : elem
		, this );
	},

 

 

inArray返回的是位置，见第1篇

 

index的参数也可以是 jQuery 对象哦

 

 

再看 Data 部分

 

首先来看看一个内部方法 jQuery.data

 

 

function now(){
	return +new Date;
}

 

 

 

var expando = "jQuery" + now(), uuid = 0, windowData = {};

 

 

一个函数，几个变量，我们 go on！

 

jQuery.data 将一个对象和一个 html dom关联。 让我们可以管理节点相关数据。

 

见API文档：http://docs.jquery.com/Internals 

 

 

 

 

jQuery.extend({
	cache: {},  // 实际的数据存放在这里

	data: function( elem, name, data ) {
		elem = elem == window ? // 对 window 进行特殊处理(在IE下 document == window)
			windowData :
			elem;

		var id = elem[ expando ];  // 节点上其实仅仅存一个uuid, expando 是一个串
		if ( !id )
			id = elem[ expando ] = ++uuid;  // 节点没有uuid, 就生成一个

		if ( name && !jQuery.cache[ id ] )
			jQuery.cache[ id ] = {};	// 节点相关的数据保存在这里

		if ( data !== undefined )
			jQuery.cache[ id ][ name ] = data;	// 存数据

		return name ? 
			jQuery.cache[ id ][ name ] :	// 取数据
			id;	// 取ID
	},

 

 

所以可以以下几种方式使用（在jQuery内部使用）：

 

var id = jQuery.data(elm); // 取 uuid,

var value = jQuery.data(elm, name);

var value = jQuery.data(elm, name, value);

 

//---

再看 removeData

 

 

	removeData: function( elem, name ) {
		elem = elem == window ?	// 如上
			windowData :
			elem;

		var id = elem[ expando ];

		if ( name ) {	// 仅仅移除name相关的数据
			if ( jQuery.cache[ id ] ) {
				delete jQuery.cache[ id ][ name ];

				// 如果 jQuery.cache[id] 是空对象，那么就 jQuery.removeData(elem)
				name = "";

				for ( name in jQuery.cache[ id ] )
					break;

				if ( !name )
					jQuery.removeData( elem );
			}
		} else {	// 移除节点的关联数据
			// 先删除dom 节点上的 uuid
			try {
				delete elem[ expando ];
			} catch(e){
				// IE下需要使用removeAttribute进行移除
				if ( elem.removeAttribute )
					elem.removeAttribute( expando );
			}
			// 再删除实际数据
			delete jQuery.cache[ id ];
		}
	},

 

所以可以这样使用(jQuery内部)

 

jQuery.removeData(elem);

jQuery.removeData(elem, name);

 

好了，下面就看看我们经常使用的 data 吧

 

 

1. data(name), data(name, value)

 

 

jQuery.fn.extend({
	data: function( key, value ){
		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 );
			});
	},

 

 

代码很简单，可是应用却让人有点遐想（是否想到了数据绑定?）

 

稍微整理一下先：

$(elem).data('abc.def') :

 triggerHandler('getData.def!', ['abc']) ---> jQuery.data(elem, 'abc.def') --> jQuery.data(elem, 'abc')

 

只作用于第一个元素

 

 

$(elem).data('abc.def', 'hello world!'):

(1)  trigger('setData.def!', ['abc', 'hello world']) 
(2)  jQuery.data(elem, 'abc.def', 'hello world');

 

作用于jQuery对象中的所有元素

 

 

//---看一个例子：

 

 

页面上有一个HTML输入域， 它可以弄入tags

 

 

<input id="tags" type="text" />

 

我们在某个地方这样初始化这个输入域， 它应该按照一定的格式显示tags：

	var tags = ['Javascript', 'jQuery', 'Web前端'];
	$('#tags').data('tags', tags);

 

我们可以这样获取tags:

var tags = $('#tags').data('tags');

 

如何从输入域显示和获取tags， 在最接近输入域的地方有这样的代码：

 

	$('#tags').bind('getData', function(e, name) {
		if (name == 'tags') {
			return $(this).val().split(/\s*;\s*/);
		}
	}).bind('setData', function(e, name, value) {
		if (name == 'tags') {
			$(this).val(value.join('; '));
		}
	});

 

//~ 

 

 2. queue(name), queue(name, callback), queue(name, queue)

 

同样，有我们不好使用，但依然存在的 

jQuery.queue,  jQuery.dequeue

 

 我们可以用它实现Chain of Responsibility 或Active Objects 模式，让我们可以把操作串起来。

 

jQuery.extend({
	...


	queue: function( elem, type, data ) {
		if ( elem ){
			type = (type || "fx") + "queue";

			var q = jQuery.data( elem, type );
	
			if ( !q || jQuery.isArray(data) )
				q = jQuery.data( elem, type, jQuery.makeArray(data) );
			else if( data )
				q.push( data );
	
		}
		return q;
	},

 

(PS: return q 在 if 里面更好?)
 

1. type 默认为 'fx' <-- Effects 将使用此queue

2. data 如果为 array, 则替换原 queue (用makeArray, 是需要创建一个新数组，因为dequeue会修改数组。)

 

下面看degueue:

 

	dequeue: function( elem, type ){
		var queue = jQuery.queue( elem, type ),
			fn = queue.shift();
		
		if( !type || type === "fx" )
			fn = queue[0];
			
		if( fn !== undefined )
			fn.call(elem);
	}

 

代码很简单： 取出第一个操作， 执行它。 (或者说： 执行下一个操作，更恰当些)。

 

 

jQuery.queue 和 jQuery.dequeue 是工具方法， jQuery对象对它们进行了包装，让我们可以使用：

 

jQuery.fn.extend({
	...

	queue: function(type, data){
		if ( typeof type !== "string" ) { 
			data = type;
			type = "fx";
		}

		if ( data === undefined )
			return jQuery.queue( this[0], type );

		return this.each(function(){
			var queue = jQuery.queue( this, type, data );
			
			 if( type == "fx" && queue.length == 1 )
				queue[0].call(this);
		});
	},

 

1.  $('#id').queue(function() ...);   相当于   $('#id').queue('fx', function() ...);   用于添加操作到 fx

2.  $('#id').queue() ;  相当于 $('#id').queue('fx') ; 

 

 

dequeue 很简单， 对每个dom元素， 都调用jQuery.dequeue

 

	dequeue: function(type){
		return this.each(function(){
			jQuery.dequeue( this, type );
		});
	}

 

在API文档中有可运行的demo，可以结合看看。

 

同样，还是总结一下：

 

 
 

 

 

 

评论

4 楼 zachary.guo 2010-09-19  

这幅 uml 图是用什么工具画的？

3 楼 yuyue007 2010-09-03  

初学者收益了

2 楼 oolala 2010-07-24  

好文章，需要仔细读一下。

1 楼 matychen 2010-03-10  

收下，慢慢看!