DIV CSS 佈局教程網

徹底搞懂 jQuery 的 $.extend()、$.fn 與 $.fn.extend()
編輯:JQuery入門技巧     

寫 jQuery 插件一定會遇到這三個東西,而它們的關係只要有一步沒想通,就會變成複製貼上而不自知為何能動。本文把它們一次講清楚。

一、jQuery.fn 就是 jQuery.prototype

jQuery.fn = jQuery.prototype = {
  init: function( selector, context ) {
    // ……
  }
};

JavaScript 雖然沒有明確的 class 概念,但用「類」來理解會方便很多。jQuery 本身可以看成一個封裝良好的類,$("#btn1") 就是建立這個類的實例。而 fn 只是 prototype 的別名,寫 fn 比較短,效果完全一樣。

二、jQuery.extend(object):加「靜態方法」

挂在 jQuery 上、屬於類本身的方法,用 jQuery.min(2,3) 這種方式呼叫,實例拿不到:

jQuery.extend({
  min: function(a, b) { return a < b ? a : b; },
  max: function(a, b) { return a > b ? a : b; }
});

jQuery.min(2, 3); // 2
jQuery.max(4, 5); // 5

另一個常見用法是合併物件:用一個或多個來源物件去擴展目標物件,回傳被擴展的那個。

var settings = { validate: false, limit: 5, name: "foo" };
var options  = { validate: true, name: "bar" };

jQuery.extend(settings, options);
// 結果:settings == { validate: true, limit: 5, name: "bar" }

注意它是「覆寫」而非新增:options 有的屬性會蓋掉 settings 的同名屬性,settings 獨有的 limit 則保留下來。插件裡的 $.extend(defaults, userOptions) 就是靠這個特性運作。

三、jQuery.fn.extend(object):加「實例方法」

對 jQuery.prototype 擴展,等於替所有實例加上成員函數。做一個「點擊時跳出目前內容」的插件:

$.fn.extend({
  alertWhileClick: function() {
    $(this).click(function(){
      alert($(this).val());
    });
  }
});

$("#input1").alertWhileClick();

$("#input1") 是一個 jQuery 實例,呼叫 alertWhileClick 之後就具備了這個行為,之後每次點擊都會先彈出輸入框內容。

四、兩者的本質差異

$.extend() 把方法掛在 jQuery 這個函式物件上,必須透過 jQuery.xxx() 呼叫,例如 jQuery.noConflict()、jQuery.ajax();$.fn.extend() 把方法掛到 prototype 上,因此每個 $() 產生的實例都能直接呼叫。

而在原始碼中,兩者其實是同一個函式:

jQuery.fn.extend = jQuery.prototype.extend;

差別只在於呼叫時 this 指向誰:用 jQuery.extend() 呼叫時 this 是 jQuery 類本身,用 $('#x').extend() 或 $.fn.extend() 呼叫時 this 是 prototype。

五、插件為什麼都長這樣

(function( $ ){
  $.fn.tooltip = function( options ) {
    // 插件內容
  };
  // 等價於
  // var tooltip = { function(options){ } };
  // $.fn.extend(tooltip);
})( jQuery );

外面那層立即執行函式有兩個作用:一是把 $ 作為參數傳入,避免與其他函式庫(例如 Prototype)的 $ 衝突;二是讓插件內部的變數自成作用域,不污染全域。

實作插件時的兩個約定:

1. 用 $.fn.extend 或 $.fn.xxx 掛方法,而不是 $.extend,否則使用者只能 jQuery.xxx() 呼叫。

2. 記得 return this,這樣才能維持鏈式呼叫,例如 $('#a').tooltip().css('color','red')。

把這三個 API 的關係想通,之後看任何 jQuery 插件原始碼都會順暢很多。

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