jQuery 的 ready 實現了「頁面結構載入完成後才執行」的效果,但它並不是 window.onload 或 document.onload 的簡易封裝,而是靠標準瀏覽器的 DOM 事件與對 IE 缺陷的補救來完成。以下直接看原始碼。
DOMContentLoaded = function()
{
// 取消事件監聽,執行 ready 方法
if ( document.addEventListener )
{
document.removeEventListener( "DOMContentLoaded", DOMContentLoaded, false );
jQuery.ready();
}
else if ( document.readyState === "complete" )
{
document.detachEvent( "onreadystatechange", DOMContentLoaded );
jQuery.ready();
}
};
jQuery.ready.promise = function( obj ) {
if ( !readyList ) {
readyList = jQuery.Deferred();
// 表示頁面已經載入完成,直接呼叫 ready 方法
if ( document.readyState === "complete" ) {
// 將 jQuery.ready 壓入異步訊息佇列,延遲 1 毫秒(部分瀏覽器延遲不能小於 4 毫秒)
setTimeout( jQuery.ready );
}
else if ( document.addEventListener )
{
// 監聽 DOM 載入完成
document.addEventListener( "DOMContentLoaded", DOMContentLoaded, false );
// 這是為了確保所有 ready 都執行結束。DOMContentLoaded 執行後會把 isReady 設為 true,
// 因此 ready 只會執行一次,window 上的 ready 監聽會被 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 ) // 排除 iframe 的情況
{
(function doScrollCheck() {
if ( !jQuery.isReady ) {
try {
// 依據 bug 來相容低版本 IE
top.doScroll("left");
} catch(e) {
// 低版本 IE 的 onreadystatechange 不可靠,因此要依各自的 bug 判斷頁面是否載入完成
return setTimeout( doScrollCheck, 50 );
}
jQuery.ready();
}
})();
}
}
}
return readyList.promise( obj );
};
這段最值得玩味的是 IE 分支裡的 doScroll 技巧:在 IE 中對 documentElement 呼叫 doScroll("left"),若 DOM 尚未準備好就會丟出例外,於是就用「試到不丟例外為止」的方式反推 DOM 就緒,繞過了老 IE 事件不可靠的問題。
ready: function( wait )
{
if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
// 判斷頁面是否已完成載入並且不需等待
return;
}
if ( !document.body ) {
return setTimeout( jQuery.ready );
}
jQuery.isReady = true; // 指示 ready 方法已被執行
if ( wait !== true && --jQuery.readyWait > 0 ) {
return;
}
readyList.resolveWith( document, [ jQuery ] );
if ( jQuery.fn.trigger ) {
jQuery( document ).trigger("ready").off("ready");
}
},
頁面載入完成有兩種時機:一是 ready,代表文件結構已載入完成,但不包含圖片等非文字媒體;二是 onload,代表包含圖片在內的所有資源都載入完畢。也就是說,ready 一定早於 onload。
實務上的分工建議是:需要圖片實際尺寸才能計算的樣式控制放 onload;純粹的事件綁定與 DOM 操作則放 ready,能讓使用者更早看到互動結果。