萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery.extend() 與 jQuery.fn.extend() 深度解析與插件開發實戰

兩者定位差異

方法掛載目標用途呼叫方式
jQuery.extend(obj)jQuery 建構函數(靜態)擴充靜態工具方法$.myUtil()
jQuery.fn.extend(obj)jQuery.prototype (=== jQuery.fn)擴充實例方法(插件)$('#el').myPlugin()

基本用法範例

擴充靜態方法

$.extend({
    sayHello: function() { console.log('Hello, jQuery!'); },
    add: (a, b) => a + b
});
$.sayHello(); // "Hello, jQuery!"
console.log($.add(3, 4)); // 7

擴充實例方法(插件模式)

.fn.extend({
    // 將所有 checkbox 設為勾選
    check: function() {
        return this.each(function() { this.checked = true; });
    },
    // 取消勾選
    uncheck: function() {
        return this.each(function() { this.checked = false; });
    }
});

$('input[type="checkbox"]').check(); // 全選

原始碼核心邏輯(簡化版)

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

    // 處理 deep 參數:$.extend(true, target, obj1, obj2)
    if (typeof target === 'boolean') { deep = target; target = arguments[1] || {}; i = 2; }

    // 單一參數時,target = this (jQuery 或 jQuery.fn)
    if (length === i) { target = this; --i; }

    for (; i < length; i++) {
        var options = arguments[i];
        if (!options) continue;
        for (var name in options) {
            var src = target[name], copy = options[name];
            if (target === copy) continue; // 防循環引用
            if (deep && copy && (jQuery.isPlainObject(copy) || Array.isArray(copy))) {
                // 深度拷貝:遞迴合併
                var clone = src && (Array.isArray(copy) ? (Array.isArray(src) ? src : []) : (jQuery.isPlainObject(src) ? src : {}));
                target[name] = jQuery.extend(deep, clone, copy);
            } else if (copy !== undefined) {
                target[name] = copy; // 淺拷貝
            }
        }
    }
    return target;
};

關鍵細節

  1. 深度拷貝:首參數傳 true 啟用,遞迴合併巢狀物件/陣列,避免污染來源物件。
  2. 單一參數:$.extend({a:1}) 等同 $.fn.extend({a:1}) 視呼叫上下文而定(靜態/實例)。
  3. 多參數合併:$.extend({}, defaults, options) 將 options 合併到 defaults 副本並回傳新物件,常用於插件預設值合併。
  4. 防循環:if (target === copy) continue; 避免自我引用導致無限遞迴。
  5. 忽略 undefined:copy !== undefined 才賦值,保留目標原有屬性。

插件開發最佳實踐模板

(function($) {
    $.fn.myPlugin = function(options) {
        // 1. 預設值合併(深度拷貝)
        var opts = $.extend(true, {}, $.fn.myPlugin.defaults, options);

        // 2. 主邏輯:遍歷每個元素
        return this.each(function() {
            var $this = $(this);
            // 初始化、綁定事件、建立資料結構...
            // 可用 $this.data('myPlugin', instance) 存實例供後續調用
        });
    };

    // 公開預設值,允許全域覆蓋
    $.fn.myPlugin.defaults = {
        color: 'blue',
        speed: 300,
        onComplete: $.noop
    };
})(jQuery);

// 使用
$('.box').myPlugin({ color: 'red', onComplete: function() { console.log('done'); } });

總結

理解 $.extend(靜態)與 $.fn.extend(實例)的分工,掌握深度合併邏輯,即能編寫健壯、可配置、符合社群慣例的 jQuery 插件。現代框架雖主流,但 jQuery 插件生態仍存續於大量存量專案中。

copyright © 萬盛學電腦網 all rights reserved