寫前端最經典的翻车現場莫過於:腳本放在 head 裡、執行得比 HTML 還快,然後 document.getElementById('foo') 回傳 null,整段初始化靜靜地死掉。這個問題看似簡單,但要做好、做快,其實頗有學問。
把載入順序攤開來看就很清楚:
放在 head 且以外部檔案載入的腳本,是在第 3 步執行的——那時 DOM 還在第 4 步等待建構,當然什麼都抓不到。
最直白的做法:
addEvent(window, "load", function () {
// do something
});
實作最簡單,但也是最慢的。回看上面的順序:load 排在最後一步,也就是說頁面裡只要有幾張大圖或一段影片,使用者就得等它們全部下載完,你的 JavaScript 才會開始跑。以「使用者體驗」的角度來看,這是最糟的選擇。
另一條路是主動去問:DOM 現在能不能用?檢查點有三個:
把這三者組合起來判斷,就得到一個實用且幾乎無瑕的 domReady。做法如下:
// 監聽 DOM 是否可用的函式
function domReady(f) {
// 假如 DOM 已經載入,馬上執行
if (domReady.done) return f();
// 假如我們已經增加過一個函式
if (domReady.timer) {
// 把它加入待執行函式清單中
domReady.ready.push(f);
} else {
// 為頁面載入完畢綁定一個事件,以防它最先完成
addEvent(window, "load", isDOMReady);
// 初始化執行函式的陣列
domReady.ready = [f];
// 盡可能快地檢查 DOM 是否已可用
domReady.timer = setInterval(isDOMReady, 13);
}
}
// 檢查 DOM 是否已可操作
function isDOMReady() {
if (domReady.done) return false;
// 檢查若干函式與元素是否存在
if (document && document.getElementsByTagName &&
document.getElementById && document.body) {
// 如果可用,我們停止檢查
clearInterval(domReady.timer);
domReady.timer = null;
// 執行所有正在等待的函式
for (var i = 0; i < domReady.ready.length; i++) {
domReady.ready[i]();
}
domReady.ready = null;
domReady.done = true;
}
}
domReady.done = true 是放在迴圈內側(原始寫法如此),實作時建議移到迴圈之後更合理;否則一旦 ready 有多個函式,第二輪就會因為 done 已為 true 而出現判斷歧異。這算是這段經典程式碼可以改良的小地方。假設把它存成 domready.js:
<html>
<head>
<title>Testing DOM Loading</title>
<script src="domready.js"></script>
<script>
domReady(function () {
alert("The DOM is loaded!");
// do something
});
</script>
</head>
<body>
<h1>Testing DOM Loading</h1>
<!-- 這裡是大量的 HTML -->
</body>
</html>
即使這段 inline script 在 body 之前執行,domReady 也會等到 DOM 真正可用才把回呼踢出去。
理解這套原理很有價值,但自己攢輪子的時代已經過去了。新專案請直接用原生 DOMContentLoaded:
document.addEventListener('DOMContentLoaded', function () {
// DOM 已就緒
});
它在 DOM 建構完成、但圖片與子框架尚未載入完畢時觸發,正好就是我們想要的那個時機,而且不必輪詢。若要支援 IE8 以下的舊環境,才需要退回 onreadystatechange 加 doScroll 那套 hack,或直接引入 jQuery 的 $(document).ready()——而 jQuery 的 ready 背後,正是本文這套思路的成熟版本。