為什麼需要自製 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'); });
關鍵技術細節
- 事件佇列:多個
domReady(fn) 推入陣列,execQueue 依序執行並清空。
- doScroll 技巧:IE 在 DOM 未就緒時呼叫
doScroll 會拋錯,利用 try-catch 輪詢直到不報錯,代表 DOM 就緒。
- 防重複綁定:
isBound 旗標確保只綁一次。
- 異步載入保護:若腳本在
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(() => { /* ... */ });