jQuery $(document).ready() 與原生 window.onload 是兩種不同階段的「頁面就緒」信號。混淆兩者會導致初始化邏輯錯位、圖片尺寸獲取失敗、事件綁定失效。本文從觸發條件、執行順序、共存風險、遷移策略四個維度徹底釐清。
| 維度 | $(document).ready() | window.onload |
|---|---|---|
| 觸發條件 | DOM 樹構建完成(HTML 解析完畢) | 所有外部資源加載完成(CSS、圖片、iframe、字體、腳本) |
| 觸發時間 | 早(通常 100-300ms 內) | 晚(視資源大小/網絡,可能秒級) |
| 適用場景 | DOM 操作、事件綁定、UI 初始化、數據請求發起 | 需獲取圖片原始尺寸、計算佈局、依賴完整資源的邏輯 |
| 多次註冊 | 支持無限次,按註冊順序執行 | 後註冊覆蓋前者(傳統 onload=),addEventListener 可多次 |
| jQuery 內部實現 | DOMContentLoaded + IE readyState 輪詢 | 原生 load 事件封裝 |
<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 不執行)
<body onload="legacyInit()">
// jQuery 1.x 早期版本:若檢測到 window.onload 已被佔用,可能不綁定 DOMContentLoaded
// 現代 jQuery (3.x) 已修復,但最佳實踐:避免使用內聯 onload
</body>
解決:統一使用window.addEventListener('load', ...)或$(window).on('load', ...),勿用window.onload =或<body onload>。
需要操作 DOM / 綁定事件 / 發起請求?
├─ 是 → $(document).ready() / DOMContentLoaded
└─ 否 → 需要圖片寬高 / 字體載入 / 完整佈局計算?
├─ 是 → $(window).on('load', ...) / window.addEventListener('load')
└─ 否 → 可能不需要等待,放在 </body> 前即可
<body onload="init()"> 改為 $(init) 或 document.addEventListener('DOMContentLoaded', init)。init() 內有 img.width 等依賴資源加載的代碼,拆分為兩階段:
$(function () { bindEvents(); fetchData(); });
$(window).on('load', function () { calcLayout(); });
window.onload = 賦值,改用 addEventListener 避免互相覆蓋。// DOM 就緒
document.addEventListener('DOMContentLoaded', () => {
// 初始化
});
// 資源完全加載
window.addEventListener('load', () => {
// 圖片尺寸、佈局計算
});
清晰區分兩個就緒階段,是前端性能優化與穩定性的基礎功夫。