在傳統 JavaScript 中,我們習慣使用 window.onload 或 <body onload="..."> 來確保頁面載入完成後再執行腳本。然而,window.onload 必須等待「所有資源」載入完畢——包含圖片、樣式表、iframe、外部字體等——才會觸發。若頁面有大量圖片,使用者可能長時間看不到互動效果。
jQuery 提供的 $(document).ready()(或簡寫 $(function(){...}))只等待 DOM 樹構建完成 即觸發,不需等待圖片等外部資源。這意味著:
| 特性 | window.onload | $(document).ready() |
|---|---|---|
| 觸發時機 | 所有資源載入完畢 | DOM 結構就緒即觸發 |
| 可重複註冊 | 否(後者覆蓋前者) | 是(依序執行) |
| 跨框架支援 | 原生支援 | 需注意 iframe 內部 ready 時機 |
| 語法簡潔度 | 需定義函式名稱 | 匿名函式、鏈式呼叫 |
// 推薦寫法(簡潔、語意明確)
$(function() {
// DOM 就緒後執行的程式碼
alert("DOM 已就緒,可以安全操作元素了!");
});
// 完整寫法(等價)
$(document).ready(function() {
// ...
});
若頁面同時存在 <body onload="load()"> 與 $(document).ready(),舊版瀏覽器可能導致 ready 不觸發。建議:統一使用 jQuery 方式,移除內聯 onload。
<script src="jquery.js"></script>
<script>
// 這裡的 ready 會等待 jquery.js 載入完成
$(function() { console.log("A"); });
</script>
<script src="plugin.js"></script>
<script>
// plugin.js 可能尚未載入完成就執行
$(function() { console.log("B"); });
</script>
解決:將所有依賴外部庫的 ready 回調放在所有 <script src> 之後,或使用模組化載入器。
若透過 .load()、.ajax() 載入 HTML 片段,片段內的 $(document).ready() 不會執行。需改用腳本標籤直接執行,或在成功回調中手動初始化。
jQuery 透過監聽 DOMContentLoaded 事件(現代瀏覽器)或 document.readyState === "complete"(舊版 IE)實現。原始碼中維護一個回調隊列,當 DOM 就緒時依序執行並清空隊列。這也是為何可重複註冊的原因。
$(function(){...}),語意清晰且最短window.onload,除非確需等待圖片尺寸計算import + DOMContentLoaded 原生事件requestIdleCallback 延遲非關鍵初始化掌握 $(document).ready() 的觸發時機與限制,是撰寫健壯前端程式碼的基礎。隨著現代瀏覽器普及,原生 DOMContentLoaded 加上 ES Module 已能覆蓋大多數場景,但在維護既有 jQuery 專案時,正確使用 ready 仍是關鍵技能。