DIV CSS 佈局教程網

JavaScript 如何確認 DOM 已就緒:從 window.onload 到自製 domReady 的完整實作
編輯:關於JavaScript     

寫前端最經典的翻车現場莫過於:腳本放在 head 裡、執行得比 HTML 還快,然後 document.getElementById('foo') 回傳 null,整段初始化靜靜地死掉。這個問題看似簡單,但要做好、做快,其實頗有學問。

瀏覽器到底在做什麼

把載入順序攤開來看就很清楚:

  1. HTML 解析完畢
  2. 外部腳本與樣式表載入完畢
  3. 腳本在文件內被解析並執行
  4. HTML DOM 完全建構完成
  5. 圖片與其他外部內容載入
  6. 網頁載入完成

放在 head 且以外部檔案載入的腳本,是在第 3 步執行的——那時 DOM 還在第 4 步等待建構,當然什麼都抓不到。

方案一:等 window 的 load 事件

最直白的做法:

addEvent(window, "load", function () {
  // do something
});

實作最簡單,但也是最慢的。回看上面的順序:load 排在最後一步,也就是說頁面裡只要有幾張大圖或一段影片,使用者就得等它們全部下載完,你的 JavaScript 才會開始跑。以「使用者體驗」的角度來看,這是最糟的選擇。

方案二:輪詢檢測 DOM 是否可用

另一條路是主動去問:DOM 現在能不能用?檢查點有三個:

  • document 是否存在——夠早的時候你會拿到 undefined。
  • document.getElementsByTagName / getElementById 是否為函式——這兩個方法出現,通常代表 DOM 已經建好。
  • document.body 是否存在——作為額外保險。理論上前一項已經足夠,但實測某些情境下還是不夠。

把這三者組合起來判斷,就得到一個實用且幾乎無瑕的 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;
  }
}

這裡有幾個值得學的細節

  • 用函式物件當命名空間。把 done、timer、ready 都掛在 domReady 上,既不打三色全域變數,也不必包一層物件字面值。
  • 兩條路並行。同時綁 load 事件與 setInterval 輪詢,誰先到就用誰。這是為了應對 Firefox 的緩存改進——在某些情況下 load 會比輪詢更早觸發,兩者互為保險。
  • 13 毫秒的間隔。不是隨便挑的,它對應舊瀏覽器約 76Hz 的定時器解析度,比 10ms 更不容易被系統四捨五入成更長的等待。
  • done 旗標的位置。注意 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 背後,正是本文這套思路的成熟版本。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved