$(document).ready() 讓我們能在 DOM 就緒後立刻執行程式,不必等圖片下載完畢。但它並不是 window.onload 或 document.onload 的包裝,而是靠標準 W3C 的 DOMContentLoaded 事件加上舊版 IE 的一個渲染缺陷湊出來的。以下拆解原始碼。
DOMContentLoaded = function () {
if (document.addEventListener) {
// 標準瀏覽器:事件只會觸發一次,聽完就移除
document.removeEventListener("DOMContentLoaded", DOMContentLoaded, false);
jQuery.ready();
} else if (document.readyState === "complete") {
document.detachEvent("onreadystatechange", DOMContentLoaded);
jQuery.ready();
}
};
這段有兩個分支:支援 addEventListener 的瀏覽器走 DOMContentLoaded;舊版 IE 沒有這個事件,只能退而監聽 readystatechange 並檢查 readyState。
jQuery.ready.promise = function (obj) {
if (!readyList) {
readyList = jQuery.Deferred();
// 文件已經 complete,直接排入非同步佇列
if (document.readyState === "complete") {
// 刻意延遲 1 毫秒(部分瀏覽器最小 4 毫秒)
setTimeout(jQuery.ready);
} else if (document.addEventListener) {
document.addEventListener("DOMContentLoaded", DOMContentLoaded, false);
// 保底:window load 也會呼叫 ready。
// 但 ready 內部有 isReady 旗標,執行過一次後
// 第二次呼叫會被 return 中斷,所以不會重複執行
window.addEventListener("load", jQuery.ready, false);
} else {
// 舊版 IE 的兩段式保險
document.attachEvent("onreadystatechange", DOMContentLoaded);
window.attachEvent("onload", jQuery.ready);
var top = false;
try {
top = window.frameElement == null && document.documentElement;
} catch (e) {}
if (top && top.doScroll) {
(function doScrollCheck() {
if (!jQuery.isReady) {
try {
// 利用 IE 的 doScroll 缺陷判斷 DOM 是否就緒
top.doScroll("left");
} catch (e) {
// 尚未就緒會拋例外,那就再等 50ms
return setTimeout(doScrollCheck, 50);
}
jQuery.ready();
}
})();
}
}
}
return readyList.promise(obj);
};
這裡最巧妙的是 doScroll 那招。舊版 IE 有個特性:當 DOM 尚未完全載入時呼叫 document.documentElement.doScroll("left") 會丟出例外,DOM 就緒後則不會。jQuery 就靠這個「呼叫它、失敗就重試」的迴圈來模擬 DOMContentLoaded。為什麼非得這樣繞?因為舊 IE 的 readystatechange 在許多情境下不可靠(例如頁面內含 iframe 或 defer 腳本時會提早或延後觸發),doScroll 反而更準。另外 window.frameElement == null 這個檢查是為了排除 iframe 內部的情況——在 iframe 裡 doScroll 的行為不同,會誤判。
ready: function (wait) {
if (wait === true ? --jQuery.readyWait : jQuery.isReady) {
return; // 已經執行過,直接返回
}
if (!document.body) {
return setTimeout(jQuery.ready); // body 還不存在,再等
}
jQuery.isReady = true; // 升起旗標
if (wait !== true && --jQuery.readyWait > 0) {
return; // 還有 holdReady 的計數未歸零
}
readyList.resolveWith(document, [jQuery]);
if (jQuery.fn.trigger) {
jQuery(document).trigger("ready").off("ready");
}
}
三個防護機制值得注意:
isReady 旗標——確保 DOMContentLoaded 與 window load 兩個來源不會讓回呼跑兩次。document.body 檢查——若腳本放在 head 且 DOM 極不完整,body 可能還不存在,此時遞迴排隊等待。readyWait 計數——對應 jQuery.holdReady(true)。有些情境需要延後所有 ready 回呼(例如等某個非同步設定檔載入完),用它把 ready 掛住,最後 holdReady(false) 才放行。因為 onload 要等所有外部資源(圖片、iframe、廣告腳本)都下載完才觸發。一個頁面十幾張圖,onload 可能要等好幾秒,其間使用者已經在看畫面卻什麼都不能操作。DOMContentLoaded 只等 HTML 解析完、DOM 樹建立好,通常快得多——這就是 ready 存在的全部意義。