DIV CSS 佈局教程網

jQuery extend 完全解析:靜態方法與實例方法的分野
編輯:JQuery特效代碼     

extend() 是 jQuery 中舉足輕重的函式,用途是擴展物件。它同時是外掛開發的基礎工具,也是 jQuery 內部擴充自身能力的手段——上一篇提到的 noConflict,正是用它掛上去的。

同一份程式碼,兩種用途

查閱 API 手冊會發現,extend 其實同時掛在 jQuery 與 jQuery.fn 上。內部雖然共用同一份實作,功能卻不同:

  • jQuery.extend():把兩個或多個物件合併進「第一個物件」。
  • jQuery.fn.extend():把物件掛到 jQuery 的 prototype 上,藉此新增「實例方法」。

對應到 jQuery 的靜態方法與實例方法之分,這兩者的差別就很清楚了:一個擴充類別本身,一個擴充由它產生的每一個物件。

用法對照

// 擴充靜態方法,用 $.sayhello() 呼叫
jQuery.extend({
  sayhello: function () {
    console.log("Hello, This is jQuery Library");
  }
});
$.sayhello();

// 擴充實例方法,用 $("selector").check() 呼叫
jQuery.fn.extend({
  check: function () {
    return this.each(function () { this.checked = true; });
  },
  uncheck: function () {
    return this.each(function () { this.checked = false; });
  }
});
$("input[type='checkbox']").check();

注意呼叫方式的差異:靜態方法直接接在 $ 後面,實例方法必須先選取元素。另外,extend 接受多個參數;只傳一個時,該物件的屬性會被附加到 jQuery(或 jQuery.fn)上;傳多個時,後者會覆寫前者。

原始碼

jQuery.extend = jQuery.fn.extend = function () {
  var options, name, src, copy, copyIsArray, clone,
      target = arguments[0] || {},
      i = 1,
      length = arguments.length,
      deep = false;

  // 第一個參數是布林值時,代表要進行深拷貝
  if (typeof target === "boolean") {
    deep = target;
    target = arguments[1] || {};
    i = 2;   // 跳過布林值與 target
  }

  // target 若是字串或其他型別,一律改成空物件
  if (typeof target !== "object" && !jQuery.isFunction(target)) {
    target = {};
  }

  // 只有一個參數時,被擴充的對象就是 this(jQuery 或 jQuery.fn)
  if (length === i) {
    target = this;
    --i;
  }

  for (; i < length; i++) {
    if ((options = arguments[i]) != null) {   // 忽略 null / undefined
      for (name in options) {
        src = target[name];
        copy = options[name];

        if (target === copy) continue;        // 防止循環引用

        // 深拷貝:遞迴處理純物件與陣列
        if (deep && copy && (jQuery.isPlainObject(copy) ||
            (copyIsArray = jQuery.isArray(copy)))) {
          if (copyIsArray) {
            copyIsArray = false;
            clone = src && jQuery.isArray(src) ? src : [];
          } else {
            clone = src && jQuery.isPlainObject(src) ? src : {};
          }
          target[name] = jQuery.extend(deep, clone, copy);
        } else if (copy !== undefined) {      // 不帶入 undefined
          target[name] = copy;
        }
      }
    }
  }

  return target;
};

把多餘功能拿掉會更清楚

這一大段程式碼,扣除「多參數合併」與「深拷貝」之後,本質其實非常樸素:

jQuery.extend = jQuery.fn.extend = function (obj) {
  var target = this;
  for (var name in obj) {
    var copy = obj[name];
    if (target === copy) continue;              // 避免循環
    if (typeof copy === 'undefined') continue;  // 跳過未定義
    target[name] = copy;
  }
  return target;
};

幾個值得記住的分支設計

布林值優先。jQuery.extend(true, a, b) 這種寫法之所以成立,是因為開頭就檢查了 typeof target === "boolean",並把起始索引推到 2。

單參數時 target 變成 this。這一行解釋了為什麼同一份程式碼能同時服務靜態與實例兩種場景——呼叫者不同,this 就不同。

undefined 不覆寫,null 會覆寫。這是刻意的設計,讓「只傳想改的欄位」成為可能,同時保留「明確設為 null 清空值」的能力。

淺拷貝是預設。深拷貝需要顯式傳 true,因為遞迴有成本,而且多數場景只需要淺層合併。

把這幾個分支想通,寫 jQuery 外掛時就不必再為「方法該掛在哪裡」而猶豫了。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved