ready() 是 jQuery 提供的保證:當 DOM 樹完全載入完成後才執行其中的程式碼。因為回呼函式在頁面所有 DOM 都可存取時才被呼叫,所以裡面可以安全地操作元素。
$(document).ready(function () {
// 在 ready 觸發時執行
});
在 3.0 之前,以下三種寫法是等價的:
$(document).ready(handler); // 掛在 document 上 $().ready(handler); // 掛在空集合上 $(handler); // 直接傳入
傳入的 handler 都會在 DOM 完全載入後執行,與它被哪個元素呼叫無關。也就是說,$("img").ready(handler) 並不代表會等圖片載入完成才執行。
在 jQuery 3.0 中,除了 $(handler) 之外的寫法都被標記為不建議使用,官方理由是:那種寫法與 ready() 的行為無關,效率不佳,而且容易讓使用者誤判這個方法的實際作用。
・ready:DOM 完全載入後觸發,此時元素已可正確存取。
・load:DOM 以及所有資源(圖片、影片等)都載入完成後才觸發。
$(window).on("load", function () {
// 頁面所有資源都載入完成後才執行
});
一般的 DOM 操作幾乎不需要 load,它會等到圖片下載完畢,取決於圖片大小可能需要等一段時間。只有在製作全頁載入動畫,或需要依圖片實際尺寸計算版面時,load 才是合適的選擇。
ready 的作用是確保回呼函式內的程式碼能正確操作 DOM。把 JavaScript 寫進 HTML 時,它保證程式碼會在瀏覽器載入完所有元素之後執行:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>.ready() 教程</title>
<script src="https://cdn.jsdelivr.net/jquery/latest/jquery.min.js"></script>
<script>
$(function () {
// ready 的回呼,在 DOM 完全載入後執行
var length = $("p").length; // 會輸出 1,證明段落已存在
console.log(length);
});
</script>
</head>
<body>
<p>I'm the content of this website</p>
</body>
</html>
但如果把 script 放在 body 的最後面,就不需要 ready 了——程式碼執行時,前面所有元素都已經解析完成:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>.ready() 教程</title>
</head>
<body>
<p>I'm the content of this website</p>
<script src="https://cdn.jsdelivr.net/jquery/latest/jquery.min.js"></script>
<script>
var length = $("p").length; // 1
console.log(length);
</script>
</body>
</html>
對現代瀏覽器以及 IE9 以上版本,直接監聽 DOMContentLoaded 事件即可:
document.addEventListener("DOMContentLoaded", function () {
// DOM 完全載入後執行
});
這裡有個細節要記住:如果事件已經觸發過了才掛上監聽器,回呼函式永遠不會執行。jQuery 的處理方式是先檢查 document.readyState,若已是 complete 就立即執行:
var callback = function () {
// DOM 完全載入後執行
};
if (document.readyState === "complete" ||
(document.readyState !== "loading" && !document.documentElement.doScroll)) {
callback();
} else {
document.addEventListener("DOMContentLoaded", callback);
}
如果不想到處複製這段判斷,可以引入 domReady 這類小型函式庫,它已經把這個邏輯封裝好了。
IE8 及以下版本沒有 DOMContentLoaded,可以改用 onreadystatechange 搭配 readyState 判斷:
document.attachEvent("onreadystatechange", function () {
if (document.readyState === "complete") {
// 確保後續不再觸發,移除監聽
document.detachEvent("onreadystatechange", arguments.callee);
// 實際處理邏輯
}
});
另一個作法是直接用 load 事件,像 jQuery 那樣就能在所有瀏覽器中運作,代價是會等到所有資源都載入完成才執行,因而產生延遲。同時仍要記得檢查 readyState,以確保事件已觸發時回呼還能執行。
若只是想在 DOM 就緒時執行程式碼,用 DOMContentLoaded 就够了;若專案還需要支援老舊 IE,則務必加上 readyState 的檢查。當然,最省事的作法是直接把 script 標籤放在 body 尾端,多數情況下連事件監聽都不必寫。