萬盛學電腦網

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

$(document).ready() vs window.onload 完整對比:觸發時機、執行順序、共存陷阱與遷移建議

jQuery $(document).ready() 與原生 window.onload 是兩種不同階段的「頁面就緒」信號。混淆兩者會導致初始化邏輯錯位、圖片尺寸獲取失敗、事件綁定失效。本文從觸發條件、執行順序、共存風險、遷移策略四個維度徹底釐清。

1. 核心差異對比

維度$(document).ready()window.onload
觸發條件DOM 樹構建完成(HTML 解析完畢)所有外部資源加載完成(CSS、圖片、iframe、字體、腳本)
觸發時間早(通常 100-300ms 內)晚(視資源大小/網絡,可能秒級)
適用場景DOM 操作、事件綁定、UI 初始化、數據請求發起需獲取圖片原始尺寸、計算佈局、依賴完整資源的邏輯
多次註冊支持無限次,按註冊順序執行後註冊覆蓋前者(傳統 onload=),addEventListener 可多次
jQuery 內部實現DOMContentLoaded + IE readyState 輪詢原生 load 事件封裝

2. 執行順序演示

<script>
console.log('1. 全局腳本開始');

$(document).ready(function () {
    console.log('2. ready 回調 1');
});

$(document).ready(function () {
    console.log('3. ready 回調 2');
});

window.addEventListener('load', function () {
    console.log('4. load 回調 1');
});

window.onload = function () {
    console.log('5. window.onload 覆蓋前者'); // 只有這個執行
};

console.log('6. 全局腳本結束');
</script>

// 輸出順序:
// 1. 全局腳本開始
// 6. 全局腳本結束
// 2. ready 回調 1
// 3. ready 回調 2
// 4. load 回調 1 (若用 addEventListener)
// 5. window.onload 覆蓋前者 (若直接賦值,則 4 不執行)

3. 共存陷阱:body onload 導致 ready 失效(舊版 jQuery)

<body onload="legacyInit()">
// jQuery 1.x 早期版本:若檢測到 window.onload 已被佔用,可能不綁定 DOMContentLoaded
// 現代 jQuery (3.x) 已修復,但最佳實踐:避免使用內聯 onload
</body>
解決:統一使用 window.addEventListener('load', ...) 或 $(window).on('load', ...),勿用 window.onload = 或 <body onload>。

4. 實際開發選型決策樹

需要操作 DOM / 綁定事件 / 發起請求?
    ├─ 是 → $(document).ready() / DOMContentLoaded
    └─ 否 → 需要圖片寬高 / 字體載入 / 完整佈局計算?
              ├─ 是 → $(window).on('load', ...) / window.addEventListener('load')
              └─ 否 → 可能不需要等待,放在 </body> 前即可

5. 遷移建議:從 onload 到 ready

  1. 將 <body onload="init()"> 改為 $(init) 或 document.addEventListener('DOMContentLoaded', init)。
  2. 若 init() 內有 img.width 等依賴資源加載的代碼,拆分為兩階段:
    $(function () { bindEvents(); fetchData(); });
    $(window).on('load', function () { calcLayout(); });
  3. 移除所有 window.onload = 賦值,改用 addEventListener 避免互相覆蓋。

6. 現代無 jQuery 寫法

// DOM 就緒
document.addEventListener('DOMContentLoaded', () => {
    // 初始化
});

// 資源完全加載
window.addEventListener('load', () => {
    // 圖片尺寸、佈局計算
});

7. 總結

  • 90% 場景用 ready/DOMContentLoaded,響應快、不阻塞首屏渲染。
  • 僅在需資源尺寸時用 load,避免不必要的延遲。
  • 禁用內聯 onload/onclick,統一用事件監聽器,便於模組化、避免覆蓋。

清晰區分兩個就緒階段,是前端性能優化與穩定性的基礎功夫。

copyright © 萬盛學電腦網 all rights reserved