DOMContentLoaded 是 Firefox、Opera 9 等瀏覽器特有的原生事件,當所有 DOM 解析完成後便會觸發。本文記錄了封裝這個事件的原理與相容性處理,很適合想深入理解 document.ready 運作機制的開發者參考。
我們通常會掛上 window.onload,以便在 DOM 載入後用 getElementById 等方法操作元素。問題是 window.load 會等到 DOM、腳本、CSS,甚至圖片與 iframe 中的所有資源都載入完才觸發。當頁面圖片又大又多時,等到最後才執行 JS 明顯太慢,直接影響使用者體驗。
因此不少框架提供了 document.ready 之類的功能,例如 jQuery 的 $(document).ready(),讓 DOM 一載入完就能立刻執行腳本,圖片則在背後慢慢載。
document.ready 的核心正是 DOMContentLoaded。Firefox、Chrome、Opera、Safari、IE9+ 都能用 addEventListener('DOMContentLoaded', fn, false) 綁定,但 IE6~8 並不支援,需要另外處理。
資料上說 IE6~8 可以用 document.onreadystatechange 監聽 readyState 是否等於 complete 來判斷,但實測發現,即使頁面沒有 iframe,readyState 等於 complete 時觸發的其實是 onload 而非 DOMContentLoaded。
幸好 IE 有個特有的 doScroll 方法:DOM 未載入完成時呼叫它會報錯,反之只要持續間隔呼叫直到不再報錯,就代表 DOM 已載入完畢,而且不受圖片與 iframe 影響。
此外,若有多個 JS 檔都綁定了 document.ready,為避免重複綁定並確保依序執行,可以引入「事件隊列」機制來解決。
以下以函數封裝的方式呈現,執行流程都寫在註解裡:
// 保存 domReady 的事件隊列
eventQueue = [];
// 判斷 DOM 是否載入完畢
isReady = false;
// 判斷 DOMReady 是否已綁定
isBind = false;
// 執行 domReady()
function domReady(fn) {
if (isReady) {
fn.call(window);
} else {
eventQueue.push(fn);
}
bindReady();
}
// domReady 事件綁定
function bindReady() {
if (isReady) return;
if (isBind) return;
isBind = true;
if (window.addEventListener) {
document.addEventListener('DOMContentLoaded', execFn, false);
} else if (window.attachEvent) {
doScroll();
}
}
// doScroll 判斷 IE6-8 的 DOM 是否載入完成
function doScroll() {
try {
document.documentElement.doScroll('left');
} catch (error) {
return setTimeout(doScroll, 20);
}
execFn();
}
// 執行事件隊列
function execFn() {
if (!isReady) {
isReady = true;
for (var i = 0; i < eventQueue.length; i++) {
eventQueue[i].call(window);
}
eventQueue = [];
}
}
// js 檔 1
domReady(function(){ ... });
// js 檔 2
domReady(function(){ ... });
特別提醒:若是「非同步載入」的 JS,就不要綁定 domReady,因為非同步 JS 下載完成前,DOMContentLoaded 早已觸發,addEventListener 執行時已監聽不到,函數便不會執行。測試時可以放進兩張大圖,觀察 onload 需等圖片載完、而 DOMContentLoaded 只需 DOM 載完即可觸發的差異(記得先清掉瀏覽器快取)。