萬盛學電腦網

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

深入理解 jQuery $(document).ready() 與 window.onload 的差異與最佳實踐

為什麼需要 $(document).ready()?

在傳統 JavaScript 中,我們習慣使用 window.onload 或 <body onload="..."> 來確保頁面載入完成後再執行腳本。然而,window.onload 必須等待「所有資源」載入完畢——包含圖片、樣式表、iframe、外部字體等——才會觸發。若頁面有大量圖片,使用者可能長時間看不到互動效果。

jQuery 提供的 $(document).ready()(或簡寫 $(function(){...}))只等待 DOM 樹構建完成 即觸發,不需等待圖片等外部資源。這意味著:

  • 執行時機更早,使用者體驗更流暢
  • 可安全操作 DOM 元素(綁定事件、修改樣式、插入節點)
  • 同一頁面可多次呼叫,回調函式依註冊順序依序執行

核心差異對照表

特性window.onload$(document).ready()
觸發時機所有資源載入完畢DOM 結構就緒即觸發
可重複註冊否(後者覆蓋前者)是(依序執行)
跨框架支援原生支援需注意 iframe 內部 ready 時機
語法簡潔度需定義函式名稱匿名函式、鏈式呼叫

基本用法

// 推薦寫法(簡潔、語意明確)
$(function() {
  // DOM 就緒後執行的程式碼
  alert("DOM 已就緒,可以安全操作元素了!");
});

// 完整寫法(等價)
$(document).ready(function() {
  // ...
});

常見陷阱與解決方案

1. 與 body onload 衝突

若頁面同時存在 <body onload="load()"> 與 $(document).ready(),舊版瀏覽器可能導致 ready 不觸發。建議:統一使用 jQuery 方式,移除內聯 onload。

2. 動態載入的腳本執行順序

<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> 之後,或使用模組化載入器。

3. 在 AJAX 載入的局部頁面中使用

若透過 .load()、.ajax() 載入 HTML 片段,片段內的 $(document).ready() 不會執行。需改用腳本標籤直接執行,或在成功回調中手動初始化。

進階:ready 事件的內部機制

jQuery 透過監聽 DOMContentLoaded 事件(現代瀏覽器)或 document.readyState === "complete"(舊版 IE)實現。原始碼中維護一個回調隊列,當 DOM 就緒時依序執行並清空隊列。這也是為何可重複註冊的原因。

最佳實踐總結

  1. 優先使用 $(function(){...}),語意清晰且最短
  2. 避免混用 window.onload,除非確需等待圖片尺寸計算
  3. 將所有 ready 回調集中在頁面底部,確保依賴庫已載入
  4. 模組化專案中,改用 ES Module import + DOMContentLoaded 原生事件
  5. 效能敏感場景,考慮 requestIdleCallback 延遲非關鍵初始化

掌握 $(document).ready() 的觸發時機與限制,是撰寫健壯前端程式碼的基礎。隨著現代瀏覽器普及,原生 DOMContentLoaded 加上 ES Module 已能覆蓋大多數場景,但在維護既有 jQuery 專案時,正確使用 ready 仍是關鍵技能。

copyright © 萬盛學電腦網 all rights reserved