DIV CSS 佈局教程網

jQuery 的 ready 方法到底怎麼實作的
編輯:JQuery入門技巧     

$(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。

二、Promise 化的 ready 註冊流程

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 本體:只執行一次的守門員

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) 才放行。

為什麼不用 window.onload

因為 onload 要等所有外部資源(圖片、iframe、廣告腳本)都下載完才觸發。一個頁面十幾張圖,onload 可能要等好幾秒,其間使用者已經在看畫面卻什麼都不能操作。DOMContentLoaded 只等 HTML 解析完、DOM 樹建立好,通常快得多——這就是 ready 存在的全部意義。

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