DIV CSS 佈局教程網

深入 jQuery 的 ready 機制:原始碼逐段解析
編輯:JQuery特效代碼     

寫過 jQuery 的人,大概都寫過 $(function(){}) 或 $(document).ready(function(){})。它好用到讓人很少去想:jQuery 究竟是怎麼知道「DOM 已經準備好了」?本文以 jQuery 1.12.0 的原始碼為例,把這件事拆開來看。

先釐清 ready 與 onload 的差別

window.onload 要等到 DOM 樹建立完成、並且頁面中所有外部資源(圖片、樣式表、iframe 等)都下載完畢才會觸發。document.ready 則是 DOM 樹一建好就執行,不等圖片。

這個差別在實務上很關鍵:如果頁面掛了大量圖片,onload 可能拖到好幾秒後才觸發,這段期間使用者點擊按鈕卻沒有任何反應,因為事件還沒綁上——對體驗是種傷害。這也是 ready 存在的理由。

原始碼(jQuery 1.12.0)

jQuery.ready.promise = function( obj ) {
    if ( !readyList ) {
        readyList = jQuery.Deferred();

        // 處理 $(document).ready() 在瀏覽器事件已經發生之後才被呼叫的情況
        // 我們曾經嘗試在此使用 readyState "interactive",
        // 但會造成類似 ChrisS 發現的問題:
        // https://bugs.jquery.com/ticket/12282#comment:15
        if ( document.readyState === "complete" ) {
            // 非同步處理,讓其他 script 有機會延後 ready
            window.setTimeout( jQuery.ready );

        // 標準瀏覽器支援 DOMContentLoaded
        } else if ( document.addEventListener ) {
            document.addEventListener( "DOMContentLoaded", completed );
            // 保底方案,一定會成功
            window.addEventListener( "load", completed );

        // 走 IE 的事件模型
        } else {
            // 確保在 onload 之前觸發,也許稍晚,但對 iframe 同樣安全
            document.attachEvent( "onreadystatechange", completed );
            window.attachEvent( "onload", completed );

            // 若是 IE 且不在 frame 中,持續輪詢檢查文件是否就緒
            var top = false;
            try {
                top = window.frameElement == null && document.documentElement;
            } catch ( e ) {}

            if ( top && top.doScroll ) {
                ( function doScrollCheck() {
                    if ( !jQuery.isReady ) {
                        try {
                            // 技巧來自 Diego Perini
                            // https://javascript.nwbox.com/IEContentLoaded/
                            top.doScroll( "left" );
                        } catch ( e ) {
                            return window.setTimeout( doScrollCheck, 50 );
                        }
                        detach();          // 移除所有 DOM ready 事件
                        jQuery.ready();    // 執行等待中的函式
                    }
                } )();
            }
        }
    }
    return readyList.promise( obj );
};

從這段程式碼可以看出,jQuery 一共動用了四種手段來判斷 DOM 是否就緒:document.readyState、DOMContentLoaded 事件、onreadystatechange 事件,以及 IE 專屬的 doScroll 技巧。以下逐一說明。

一、document.readyState

readyState 是 document 的屬性,回報目前文件的載入狀態,可能的值有四種:

uninitialized:尚未開始載入。
loading:載入中。
interactive:文件已載入完成,可與使用者互動,但圖片等資源仍在下載。
complete:文件與所有資源都載入完成。

所以判斷 document.readyState === "complete" 就能確認 DOM 已就緒。但原始碼註解(第 6–11 行)提到 ChrisS 發現了一個特殊問題,因此這裡執行 jQuery.ready 時刻意「延遲一下」。

仔細看會發現程式碼裡並沒有寫出延遲時間——setTimeout(jQuery.ready) 少了第二個參數。這是因為不指定延遲時,瀏覽器會依當前的環境與系統負擔,自行給定一個最小延遲值,剛好達到「讓出一個事件循環」的效果。

二、DOMContentLoaded 事件

這是基於標準的做法。當 HTML 被完整解析、DOM 樹建構完成時,瀏覽器就會觸發 DOMContentLoaded,此時不等圖片、不等樣式表下載結束。因此在支援標準的瀏覽器中,只要監聽這個事件就能準確掌握 DOM 就緒的時機,這也是現代瀏覽器走的主要分支。

三、onreadystatechange 事件

不支援標準的老 IE 則走 onreadystatechange。這個名字如果用過 Ajax 應該很熟悉——在 IE 中它是「私有」的,幾乎所有元素都有這個事件;而 W3C 標準裡只有 XMLHttpRequest 物件才有。當 readyState 變成 complete 時,即可視為 DOM 樹載入完成。

四、doScroll:為什麼還要多一道保險

既然 onreadystatechange 已經能判斷,為什麼還需要 Diego Perini 提出的 doScroll 技巧?

因為 onreadystatechange 等的是 complete,而 complete 的定義包含「所有資源都載入完成」。也就是說,只要頁面上還有一張圖沒下載完,狀態就不會是 complete, ready 反而會被拖到比 onload 還晚。這顯然不是我們想要的。

doScroll 的原理很樸素:在 DOM 尚未建構完成時呼叫 doScroll() 會丟出例外;一旦 DOM 足夠就緒,呼叫便不再報錯。於是只要用 try...catch 包住它,並在失敗時每 50 毫秒重試一次,就能得到一個不受圖片影響的就緒判斷。

小結

jQuery 的 ready 之所以看起來「哪個瀏覽器都能用」,靠的不是單一魔法,而是一層一層的向下相容:先看 readyState 是否已完成,再依能力偵測分別掛上標準事件或 IE 私有事件,最後用 doScroll 輪詢補上老 IE 的漏洞。理解這條鏈條,對排查「事件沒綁上」這類老問題很有幫助。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved