jQuery $(document).ready() (簡稱 $()) 與原生 window.onload 執行時機本質不同,直接影響頁面初始化邏輯編寫。本文從瀏覽器事件模型、jQuery 源碼實現、實際應用場景三個維度深度對比。
| 事件 | 觸發時機 | 典型用途 |
|---|---|---|
| DOMContentLoaded | HTML 文件完全載入並解析完成,**不等待** 樣式表、圖片、子框架載入 | DOM 操作初始化、事件綁定、UI 元件建構、資料請求發起 |
| load (window.onload) | **所有資源** (CSS、JS、圖片、字體、iframe) 完全載入完成 | 需圖片尺寸計算、完整頁面截圖、依賴外部資源載入完成的邏輯 |
關鍵結論:ready() 遠早於 onload 觸發 (通常快數百毫秒至數秒),是頁面初始化的最佳時機。
// jQuery 核心 ready 實現 (簡化版)
ready: function() {
// 1. 防重複執行
if (!jQuery.isReady) {
// 2. 確保 body 存在 (修復 IE 早期 body 為 null 問題)
if (!document.body) {
return setTimeout(jQuery.ready, 13);
}
// 3. 標記就緒
jQuery.isReady = true;
// 4. 執行所有就緒回呼
if (readyList) {
var fn, i = 0;
while ((fn = readyList[i++])) {
fn.call(document, jQuery); // this 指向 document
}
readyList = null; // 清空隊列
}
// 5. 觸發自定義 ready 事件 (供 .on('ready') 監聽)
if (jQuery.fn.triggerHandler) {
jQuery(document).triggerHandler('ready');
}
}
}
document.addEventListener('DOMContentLoaded', completed)。document.attachEvent('onreadystatechange', ...) 監聽 document.readyState === 'complete',並嘗試 document.documentElement.doScroll('left') 技巧 (文件就緒時 doScroll 不拋錯)。window.addEventListener('load', completed) 確保極端情況下必定觸發。| 場景 | 推薦事件 | 理由 |
|---|---|---|
| 綁定點擊/提交/表單事件 | ready() | DOM 就緒即可綁定,無需等圖片 |
| 初始化輪播圖/燈箱 (需圖片尺寸) | onload | 需 img.naturalWidth 等屬性,必須圖片載入完 |
| 發起 AJAX 請求渲染列表 | ready() | 越早請求越早回應,不阻塞視覺渲染 |
| 第三方廣告/分析碼載入 | onload | 不阻塞主頁面關鍵渲染路徑 |
| 計算元素佈局/位置 (受圖片影響) | onload | 圖片未載入時 offsetWidth/Height 為 0 |
| Service Worker 註冊 | ready() 後 | 不阻塞首屏,但需 DOM 就緒 |
// DOMContentLoaded
document.addEventListener('DOMContentLoaded', function() {
console.log('DOM 就緒');
});
// load
window.addEventListener('load', function() {
console.log('所有資源載入完成');
});
// 兼容 IE9+ 簡寫
function ready(fn) {
if (document.readyState !== 'loading') fn();
else document.addEventListener('DOMContentLoaded', fn);
}
ready(function() { /* ... */ });
$(window).load(function(){...}) 等同 $(document).ready()。事實:前者綁定 load,後者綁定 DOMContentLoaded。ready() 回呼中 this 指向 window。事實:this === document (源碼 fn.call(document, jQuery))。ready() 會覆蓋。事實:全部加入隊列依序執行。90% 以上初始化邏輯應放在 ready()/DOMContentLoaded,僅在確實需要完整資源載入時才用 onload。理解兩者時機差異,是優化首屏渲染速度、避免「白屏等待」的關鍵認知。