萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

提取 jQuery ready() 核心邏輯:輕量級 DOM 就緒檢測實現

若僅需「DOM 就緒即執行」功能,引入完整 jQuery 過於沉重。本文解析 jQuery ready() 的核心實現原理,並提供一個無依賴、約 1KB 的獨立實現方案。

為什麼不用 window.onload?

  • onload 等待所有資源(圖片、iframe、樣式表)加載完成
  • 頁面有大圖時,用戶可見內容延遲秒級甚至更久
  • DOM 操作只需 DOM 樹構建完成,無需等待資源

瀏覽器原生支持差異

瀏覽器 事件/機制
Firefox / Opera / Chrome (現代) DOMContentLoaded
Safari (舊版) document.onreadystatechange + readyState === 'complete'
IE (非 iframe) 輪詢 document.documentElement.doScroll('left') 無異常
IE (iframe 內) document.onreadystatechange

核心實現代碼(IIFE 封裝,無污染全局)

(function() {
    var isReady = false;           // 標記是否已觸發
    var readyList = [];            // 待執行回調隊列
    var timer;                     // IE 輪詢定時器

    // 對外暴露的 ready 方法
    window.ready = function(fn) {
        if (isReady) {
            fn.call(document);     // 已就緒,立即執行
        } else {
            readyList.push(function() { return fn.call(this); }); // 入隊
        }
        return this;               // 支持鏈式
    };

    // 執行所有回調
    var onDOMReady = function() {
        for (var i = 0; i < readyList.length; i++) {
            readyList[i].apply(document);
        }
        readyList = null;          // 釋放引用
    };

    // 綁定/解綁事件
    var bindReady = function(evt) {
        if (isReady) return;
        isReady = true;
        onDOMReady.call(window);

        if (document.removeEventListener) {
            document.removeEventListener("DOMContentLoaded", bindReady, false);
        } else if (document.attachEvent) {
            document.detachEvent("onreadystatechange", bindReady);
            if (window === window.top) {
                clearInterval(timer);
                timer = null;
            }
        }
    };

    // 現代瀏覽器
    if (document.addEventListener) {
        document.addEventListener("DOMContentLoaded", bindReady, false);
    }
    // IE
    else if (document.attachEvent) {
        document.attachEvent("onreadystatechange", function() {
            if (/loaded|complete/.test(document.readyState)) {
                bindReady();
            }
        });

        // 非 iframe 頂層窗口:輪詢 doScroll
        if (window === window.top) {
            timer = setInterval(function() {
                try {
                    isReady || document.documentElement.doScroll('left');
                } catch (e) {
                    return;
                }
                bindReady();
            }, 5);
        }
    }
})();

使用示例

// 方式一:傳入已定義函數
ready(doSomething);

// 方式二:閉包匿名函數
ready(function() {
    // 業務邏輯
    console.log("DOM Ready!");
});

原理解析重點

  1. 事件兼容:優先使用標準 DOMContentLoaded,回退到 IE 專有事件
  2. IE doScroll 技巧:DOM 未就緒時調用 doScroll 會拋異常,利用此特性輪詢檢測
  3. iframe 判斷:window === window.top 區分頂層窗口,避免框架頁誤判
  4. 一次性執行:isReady 旗標確保回調隊列只執行一次
  5. 內存釋放:執行後置空 readyList、清除定時器、解綁事件

適用場景與局限

  • ✅ 輕量級項目、Widget、廣告 SDK、第三方嵌入腳本
  • ✅ 不需 jQuery 其他功能(選擇器、動畫、AJAX)的場景
  • ❌ 複雜應用建議直接用 jQuery 或現代 document.addEventListener('DOMContentLoaded', ...)
  • ❌ 不處理腳本異步加載順序問題(需配合模塊加載器)

現代替代方案

現代瀏覽器(IE9+)均支持標準事件,簡單項目可直接使用:

document.addEventListener('DOMContentLoaded', function() {
    // 初始化代碼
});

若需支持 IE8,可引入 domready 等成熟微型庫(約 1KB)。

copyright © 萬盛學電腦網 all rights reserved