jQuery 的核心思想可以濃縮成一句話——「查詢 DOM 並操作它」。而這句話的入口,就是 jQuery.prototype.init 這個構造函式,也就是 $() 執行時真正跑的那段程式。以下先整理它需要處理的八種參數情境,再對照原始碼逐段說明(以 jQuery 1.8.3 為基準)。
每一種情境最後都會回傳一個選擇器實例(慣例稱為 jQuery 物件,本質是類陣列的 nodeList 包裝),裡面裝著查到的 DOM 節點。
1. 處理 $("")、$(null)、$(undefined)、$(false)
參數是這類「假值」時,jQuery 物件裡不含任何 DOM 節點。
2. 處理 $(DOMElement)
參數是原生節點時,直接把它放進去,並補上 context、length 屬性與 [0] 的索引存取:
var obj = document.getElementById('container'),
jq = $(obj);
console.log(jq.length); // 1
console.log(jq.context); // obj
console.log(jq[0]); // obj
3. 處理 $(HTML字符串)
jQuery 物件會包含由 jQuery.clean 建立的文件碎片中的 childNodes:
var jqHTML = $('<h1>文章標題</h1><p>內容</p>');
console.log(jqHTML); // [<h1>, <p>]
若第一個參數是「空的單標籤」且第二個參數是非空純物件,該物件的屬性會被套用到這個新元素上:
var jqHTML = $('<div></div>', { class: 'css-class', 'data-name': 'data-val' });
console.log(jqHTML.attr['class']); // css-class
console.log(jqHTML.attr['data-name']); // data-val
4. 處理 $("#id")
var jq = $('#container');
console.log(jq[0]); // 對應的 DOM 節點
console.log(jq.length); // 1
console.log(jq.context); // document
console.log(jq.selector); // container
5. 處理 $(".className")
實際執行的是 return jQuery(document).find(className);
6. 處理 $(".className", context)
第二個參數是上下文(可以是選擇器字串、jQuery 物件或 DOM 節點),實際執行 return jQuery(context).find(className);:
<div class="main"> <h2 class="title">主內容標題</h2> <p>主標題</p> </div> <div class="sub"> <h2 class="title">次內容標題</h2> <p>次標題</p> </div>
var jq, context;
context = '.sub';
jq = $('.title', context);
console.log(jq.text()); // 次內容標題
console.log(jq.context); // document
console.log(jq.selector); // .sub .title
context = $('.sub'); // 傳 jQuery 物件,結果相同
jq = $('.title', context);
context = $('.sub')[0]; // 傳原生節點
jq = $('.title', context);
console.log(jq.text()); // 次內容標題
console.log(jq.context); // class 為 sub 的節點
console.log(jq.selector); // .title
值得注意:selector 屬性會依傳入的上下文型態不同而改變,這在除錯時是很好的線索。
7. 處理 $(fn)
等價於 $(document).ready(fn):
$(function(e){ console.log('DOMContent is loaded'); });
// 等同於
jQuery(document).ready(function(e) { console.log('DOMContent is loaded'); });
8. 處理 $(jQuery對象)
把原物件的 selector 與 context 沿用過來:
var jq = $('#container');
console.log(jq.selector); // #container
console.log(jq.context); // document
var jq2 = $($('#container'));
console.log(jq2.selector); // #container
console.log(jq2.context); // document
var rootjQuery = $(document),
rquickExpr = /^(?:[^<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/;
jQuery.fn = jQuery.prototype = {
init: function( selector, context, rootjQuery ) {
var match, elem, ret, doc;
// 處理 $(""), $(null), $(undefined), $(false)
if ( !selector ) { return this; }
// 處理 $(DOMElement)
if ( selector.nodeType ) {
this.context = this[0] = selector;
this.length = 1;
return this;
}
// 處理 HTML 字串
if ( typeof selector === "string" ) {
// 判斷式:前後都是 < > 且長度足夠,直接視為 HTML,跳過正則檢查
if ( selector.charAt(0) === "<" &&
selector.charAt( selector.length - 1 ) === ">" &&
selector.length >= 3 ) {
match = [ null, selector, null ];
} else {
match = rquickExpr.exec( selector );
}
// match[1] 不為 null 表示 HTML 字串;match[2] 不為 null 表示元素 id
if ( match && (match[1] || !context) ) {
// HANDLE: $(html) -> $(array)
if ( match[1] ) {
context = context instanceof jQuery ? context[0] : context;
doc = ( context && context.nodeType ? context.ownerDocument || context : document );
// selector 是文件碎片 childNodes 組成的陣列
selector = jQuery.parseHTML( match[1], doc, true );
// 空的單標籤 + context 為物件字面量時,把屬性套上去
if ( rsingleTag.test( match[1] ) && jQuery.isPlainObject( context ) ) {
this.attr.call( selector, context, true );
}
// merge 把第二個陣列的項目併入第一個;this 繼承了 length(預設 0),
// 因此可被視為類陣列,理解 merge 的源碼是這裡的關鍵
return jQuery.merge( this, selector );
// HANDLE: $(#id)
} else {
elem = document.getElementById( match[2] );
// 檢查 parentNode,過濾已經不在文件上的節點(#6963)
if ( elem && elem.parentNode ) {
// IE6/7 與 Opera 存在 name 與 id 混淆的 bug,
// 若傳回的元素 id 與查詢值不符,退回用 find 重新查
if ( elem.id !== match[2] ) {
return rootjQuery.find( selector );
}
this.length = 1;
this[0] = elem;
}
this.context = document;
this.selector = selector;
return this;
}
// HANDLE: $(expr, $(...)) context 不存在或本身就是 jQuery 物件
} else if ( !context || context.jquery ) {
return ( context || rootjQuery ).find( selector );
// HANDLE: $(expr, context) 等同於 $(context).find(expr)
} else {
return this.constructor( context ).find( selector );
}
// 處理 $(fn) === $(document).ready(fn)
} else if ( jQuery.isFunction( selector ) ) {
return rootjQuery.ready( selector );
}
// 處理 $(jQuery物件)
if ( selector.selector !== undefined ) {
this.selector = selector.selector;
this.context = selector.context;
}
return jQuery.makeArray( selector, this );
}
};
三個值得記下的細節:
rquickExpr 正則只用來分辨「HTML 字串」與「#id」兩種情況,其餘複雜選擇器一律往 find() 丟,職責切得很乾淨。elem.id !== match[2] 這個看似多餘的檢查,其實是為了繞過老 IE 與 Opera 把 name 當成 id 回傳的歷史 bug,這種相容性代碼正是框架「看似簡單卻處處是坑」的地方。jQuery.merge(this, selector) 之所以能把 DOM 併進 jQuery 物件,關鍵在於 this 繼承了 length 屬性、是個類陣列。理解這一點,很多 jQuery 的「魔法語法」就不再神祕。