DIV CSS 佈局教程網

jQuery ready 方法原始碼解析:它到底怎麼知道 DOM 已經準備好了?
編輯:JQuery入門技巧     

研究 jQuery 原始碼常常會有一種「每個字母都認識,連起來不知道是什麼」的挫折感,ready() 的實作就是經典案例。本文把它的運作機制拆開來講,順便釐清一個很多人一輩子沒搞懂的差別:ready 和 window.onload 根本不是同一件事。

先分清楚兩個時機

window.onload 要等頁面上所有資源都下載完成才觸發,包含圖片、iframe、廣告腳本。只要有一張大圖或一個慢的外部資源,它就會遲遲不觸發。

DOM Ready 則是HTML 結構解析完成就觸發,不等圖片。這才是我們真正想要的時機——DOM 已經可以操作了,為什麼要等圖片?jQuery 的 ready() 實作的就是這件事。

但要注意:它並不是 window.onload 或 document.onload 的包裝,而是靠標準 W3C 的 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()。

第二段:如何判斷該用哪種策略

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

        // 情況一:文件已經 complete,直接排入佇列
        if (document.readyState === "complete") {
            // 注意:部分瀏覽器 setTimeout 的最小延遲是 4ms,不能寫 0
            setTimeout(jQuery.ready);
        }
        // 情況二:標準瀏覽器,監聽 DOMContentLoaded
        else if (document.addEventListener) {
            document.addEventListener("DOMContentLoaded", DOMContentLoaded, false);
            // 保險:window load 時也會呼叫一次。
            // 因為 ready 內部有 isReady 旗標,第二次呼叫會被 return 中斷,
            // 所以掛兩個監聽不會重複執行。
            window.addEventListener("load", jQuery.ready, false);
        }
        // 情況三:低版本 IE 的變通做法
        else {
            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 {
                            // 利用 IE 的缺陷:DOM 未就緒時呼叫 doScroll 會丟例外
                            top.doScroll("left");
                        } catch (e) {
                            // IE 的 onreadystatechange 不可靠,只能重試
                            return setTimeout(doScrollCheck, 50);
                        }
                        jQuery.ready();
                    }
                })();
            }
        }
    }
    return readyList.promise(obj);
};

那段最神奇的 doScroll 是什麼?

低版本 IE 的 onreadystatechange 判斷不準,會提早或延後觸發。工程師找到一個巧妙的替代品:document.documentElement.doScroll("left") 這個方法在 DOM 完全就緒前呼叫會丟出例外,就緒後則正常執行。於是用 try/catch 當探針,每 50 毫秒試一次,成功就代表可以跑 ready 了。

這段程式碼還刻意檢查 window.frameElement == null,因為在 iframe 裡 doScroll 的行為會出問題,必須跳過。

第三段:真正執行的 ready

ready: function(wait) {
    if (wait === true ? --jQuery.readyWait : jQuery.isReady) {
        // 已完成載入且已執行過 ready,直接返回
        return;
    }
    if (!document.body) {
        // 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");
    }
};

幾個值得注意的地方:

jQuery.isReady 是 idempotency 的關鍵。無論前面掛了多少個監聽器,這個旗標保證回呼只會真正執行一次。

readyWait 支援「延後 ready」。jQuery.holdReady(true) 就是靠遞增這個計數器,讓 ready 等你手動放行,這在需要等某個非同步設定完成時很好用。

if (!document.body) return setTimeout(...) 是最後一道防線。如果整份文件連 body 都還沒解析出來,再等一拍。

用 Deferred 串接回呼。所以 ready() 才能用 $.when() 那套 Promise 語法來組合,這也是 jQuery 1.8 之後的設計。

寫在最後

讀完這段原始碼,你會發現一件很有意思的事:現代瀏覽器只需要一行 DOMContentLoaded 就解決了,剩下百分之八十的程式碼都是在跟十幾年前的 IE 搏鬥。那些看似優雅的設計,背後往往是無數個瀏覽器 bug 逼出來的結果。

實務上的結論很簡單:ready() 該用就用,不用擔心效能;但如果你把 script 放在 body 尾端,其實連它都可以省下來。

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