在 jQuery 開發中,經常會看到兩種看似相似卻功能迥異的寫法:jQuery(function(){}) 與 (function($){})(jQuery)。許多初學者容易混淆它們的用途,甚至導致頁面渲染異常或插件開發失敗。本文將從原理、執行時機、適用場景三個維度深度剖析兩者的區別,助你精準選擇正確模式。
這其實是 $(document).ready(function(){}) 的語法糖。當瀏覽器完成 DOM 樹構構建後,會立即執行回調函數內的代碼。此時頁面結構已就緒,但圖片、樣式表等資源可能尚未加載完成。
// 完整寫法
$(document).ready(function() {
// DOM 操作代碼
});
// 簡寫等價形式
jQuery(function($) {
// 此處 $ 參數已安全映射為 jQuery
$('#myDiv').hide();
});
這是一種 JavaScript 設計模式,通過匿名函數自執行創建私有作用域,並將 jQuery 實例作為參數 $ 傳入。其核心目的是避免全局命名空間污染與解決 $ 符號衝突。
(function($) {
// 閉包內部 $ 專指 jQuery,不受外部影響
$.fn.myPlugin = function() { ... };
})(jQuery);
| 維度 | jQuery(function(){}) | (function($){})(jQuery) |
|---|---|---|
| 執行時機 | DOMContentLoaded 事件觸發後 | 腳本解析到該行時立即執行 |
| DOM 可用性 | 保證 DOM 完全就緒 | 不保證,需自行判斷 |
| 主要用途 | 頁面初始化、事件綁定、DOM 操作 | 插件開發、模組封裝、命名空間隔離 |
| $ 符號保護 | 回調參數局部有效 | 閉包內全局有效 |
| 典型問題 | 若插件代碼放此處,外部無法調用 | 若直接操作 DOM 可能報錯 |
// 錯誤:外部無法訪問 myPlugin
jQuery(function($) {
$.fn.myPlugin = function() { console.log('init'); };
});
// 其他文件調用 $('#el').myPlugin() → TypeError
// 正確:插件掛載到 jQuery 原型,全局可用
(function($) {
$.fn.myPlugin = function(options) {
return this.each(function() {
// 插件邏輯
});
};
})(jQuery);
(function($) {
// 錯誤:此時 DOM 可能未就緒
// $('#sidebar').hide();
// 正確:內部再包一層 ready
$(function() {
$('#sidebar').hide(); // 安全操作 DOM
});
})(jQuery);
現代 jQuery 專案常採用「外層 IIFE 隔離作用域 + 內層 ready 確保 DOM 就緒」的雙層結構:
(function($, window, document, undefined) {
// 1. 插件/組件定義區(立即執行)
$.fn.carousel = function() { ... };
// 2. 頁面級業務邏輯(DOM 就緒後執行)
$(function() {
$('.banner').carousel(); // 初始化輪播
bindGlobalEvents(); // 綁定全局事件
});
// 3. 私有輔助函數
function bindGlobalEvents() { ... }
})(jQuery, window, document);
visibility:hidden。jQuery(function($){}) 參數必須叫 $」——參數名可任意(如 jq),但慣例用 $ 保持代碼風格一致。jQuery(function($){ ... }) 確保 DOM 就緒。(function($){ ... })(jQuery) 構建閉包,最後再 $.fn.xxx = ... 暴露接口。掌握這兩種模式的本質區別,能讓你在 jQuery 開發中遊刃有餘,避免 90% 的作用域與時序相關 Bug。下次動筆前,先問自己:「我要操作 DOM,還要封裝復用?」答案自然清晰。