萬盛學電腦網

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

原生 JavaScript 封裝 DOMContentLoaded 事件(相容 IE6+)

為什麼需要自製 domReady?

  • window.onload 等待圖片/iframe 完成,太慢。
  • DOMContentLoaded 現代瀏覽器支援,IE6-8 不支援。
  • 需要統一 API、事件佇列、防止重複綁定。

核心實作

;(function(global) {
    var eventQueue = [], isReady = false, isBound = false;

    // 公開 API
    global.domReady = function(fn) {
        if (isReady) { fn.call(global); return; }
        eventQueue.push(fn);
        bindReady();
    };

    // 綁定一次即可
    function bindReady() {
        if (isBound) return;
        isBound = true;

        // 現代瀏覽器 + IE9+
        if (document.addEventListener) {
            document.addEventListener('DOMContentLoaded', execQueue, false);
            // 保險:若已錯過事件(異步載入腳本),window.onload 兜底
            window.addEventListener('load', execQueue, false);
        }
        // IE6-8
        else if (document.attachEvent) {
            document.attachEvent('onreadystatechange', function() {
                if (document.readyState === 'complete') execQueue();
            });
            // doScroll 檢測(更早觸發)
            (function doScrollCheck() {
                try { document.documentElement.doScroll('left'); }
                catch(e) { return setTimeout(doScrollCheck, 20); }
                execQueue();
            })();
        }
    }

    // 執行佇列
    function execQueue() {
        if (isReady) return;
        isReady = true;
        eventQueue.forEach(function(fn) { fn.call(global); });
        eventQueue = [];
    }
})(window);

使用方式

// 腳本 A
domReady(function() { console.log('A ready'); });

// 腳本 B(異步載入也能運作)
domReady(function() { console.log('B ready'); });

關鍵技術細節

  1. 事件佇列:多個 domReady(fn) 推入陣列,execQueue 依序執行並清空。
  2. doScroll 技巧:IE 在 DOM 未就緒時呼叫 doScroll 會拋錯,利用 try-catch 輪詢直到不報錯,代表 DOM 就緒。
  3. 防重複綁定:isBound 旗標確保只綁一次。
  4. 異步載入保護:若腳本在 DOMContentLoaded 後載入,addEventListener 不會觸發,但 isReady 已為 true,直接執行 fn。

現代替代方案

// 原生 Promise 版(需 IE 不支援)
function domReady() {
    return new Promise(resolve => {
        if (document.readyState !== 'loading') resolve();
        else document.addEventListener('DOMContentLoaded', resolve);
    });
}
// 使用
domReady().then(() => { /* ... */ });
copyright © 萬盛學電腦網 all rights reserved