一般做法是在 body 上掛 onload 監聽 window 的 load 事件。問題是 load 要等頁面所有資源都載入完成才觸發,如果頁面上圖片多或檔案大,使用者早就開始操作了,你的初始化程式卻還沒跑。
jQuery 提供的 $(selector).ready() 解決了這個問題:它讓你在 DOM 建好之后就能動作,不必等圖片。例如:
$(document).ready(function(){
alert('寫在頁面 script 標籤中');
});
// 也可以寫在外掛的 js 檔裡
$(document).ready(function(){
alert('寫在外部 js 檔中');
});
jQuery 腳本載入時會設定一個 isReady 旗標,並嘗試監聽 DOMContentLoaded 事件。呼叫 ready 時若 isReady 尚未成立,代表 DOM 還沒就緒,於是把要執行的函式推進一個陣列暫存;等 DOM 就緒後,再把暫存的函式逐一執行。
ready: function(fn) {
bindReady(); // 掛上監聽器
if (jQuery.isReady) {
fn.call(document, jQuery); // DOM 已就緒,直接執行
} else {
// 否則先存起來
jQuery.readyList.push(function() {
return fn.call(this, jQuery);
});
}
return this;
}
var readyBound = false;
function bindReady() {
if (readyBound) return;
readyBound = true;
// Mozilla、Opera、WebKit 都支援 DOMContentLoaded
if (document.addEventListener && !jQuery.browser.opera) {
document.addEventListener("DOMContentLoaded", jQuery.ready, false);
}
// IE 且不在 iframe 中:用 doScroll 的技巧輪詢
if (jQuery.browser.msie && window == top) (function(){
if (jQuery.isReady) return;
try {
document.documentElement.doScroll("left");
} catch (error) {
setTimeout(arguments.callee, 0);
return;
}
jQuery.ready();
})();
// Opera 的樣式表可能還沒就緒,需額外檢查
if (jQuery.browser.opera) {
document.addEventListener("DOMContentLoaded", function () {
if (jQuery.isReady) return;
for (var i = 0; i < document.styleSheets.length; i++)
if (document.styleSheets[i].disabled) {
setTimeout(arguments.callee, 0);
return;
}
jQuery.ready();
}, false);
}
// Safari:需同時確認 readyState 與樣式表數量
if (jQuery.browser.safari) {
var numStyles;
(function(){
if (jQuery.isReady) return;
if (document.readyState != "loaded" && document.readyState != "complete") {
setTimeout(arguments.callee, 0);
return;
}
if (numStyles === undefined)
numStyles = jQuery("style, link[rel=stylesheet]").length;
if (document.styleSheets.length != numStyles) {
setTimeout(arguments.callee, 0);
return;
}
jQuery.ready();
})();
}
// 最後的保底方案
jQuery.event.add(window, "load", jQuery.ready);
}
(1) IE 的 doScroll 技巧。在 IE 下,當 DOM 尚未完成解析時,呼叫 document.documentElement.doScroll("left") 會丟出例外。這個「故意出錯」的行為正好可以當作探針:出錯就代表 DOM 還沒好,沒出錯就代表已就緒。IE 當年沒有 DOMContentLoaded 事件,這是找到時機最可靠的方法。
(2) setTimeout(fn, 0)。並非真的等 0 秒,而是「盡快執行」——瀏覽器會在目前所有掛起的事件處理完、文件狀態更新完之後才呼叫。它本質上是一種讓出執行權的排程技巧。arguments.callee 指向外層的匿名函式本身,讓它可以自我重試。
(3) Opera 的樣式表檢查。為什麼不跟 Mozilla 一起處理?因為 Opera 的 DOMContentLoaded 觸發時,CSS 樣式可能還沒完全可用,所以必須逐一檢查每個樣式表是否已啟用。
(4)(5) Safari 的 readyState 與樣式表數量。Safari 在 readyState 變成 loaded 或 complete 時,仍無法確定外部 CSS 是否解析完畢,因此再比對一次樣式表數量來確認。
(6) 保底方案。如果上面所有 hack 都不適用,就退回最保險的 window load 事件,至少確保初始化程式一定會跑到。
這段程式碼寫在 jQuery 1.3 的年代,當時 IE6~8 佔有可觀份額,DOMContentLoaded 也不是普遍支援的標準。今天的情況完全不同:
DOMContentLoaded 已是所有現代瀏覽器都支援的標準事件,一行 document.addEventListener("DOMContentLoaded", fn) 即可。jQuery.browser 已在 1.9 移除,這段程式碼無法在現代 jQuery 上運行。<script> 標籤加上 defer 屬性,效果與 ready 相近且更簡單。讀這段源碼的價值不在複製它,而在理解一個重要觀念:「DOM 就緒」與「資源載入完成」是兩個不同時機,選錯時機就會出現元件初始化順序錯亂、圖表尺寸算錯、拖曳座標偏移這類難查的 bug。