| 方法 | 掛載目標 | 用途 | 呼叫方式 |
|---|---|---|---|
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;
};
true 啟用,遞迴合併巢狀物件/陣列,避免污染來源物件。$.extend({a:1}) 等同 $.fn.extend({a:1}) 視呼叫上下文而定(靜態/實例)。$.extend({}, defaults, options) 將 options 合併到 defaults 副本並回傳新物件,常用於插件預設值合併。if (target === copy) continue; 避免自我引用導致無限遞迴。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 插件生態仍存續於大量存量專案中。