DIV CSS 佈局教程網

jQuery.prototype.init 源碼解析:$() 裡的參數到底怎麼被處理
編輯:JQuery特效代碼     

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 的「魔法語法」就不再神祕。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved