昨天在寫一個網頁特效時,總是提示錯誤。一直到今天透過一個範例才知道原因。
我一直以為用 JavaScript 的 document.onLoad 指定一個函式,跟在 body 標籤中加入 onload 是一樣的。但今天這個範例告訴我:document.onLoad 並不是在頁面載入完成時才引發。
測試環境:Win2003 + IE7。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>無標題文件</title>
<script language="JavaScript">
function mytest(){
alert(document.getElementById("my2"));
}
document.onLoad = mytest();
</script>
</head>
<body>
<p id="my2">測試內容</p>
</body>
</html>
打開這個 htm 檔時,頁面還沒完全顯示(也就是白屏狀態)就跳出提示對話框了,說明 mytest 在頁面顯示完成之前就被呼叫。
把 document.onLoad 這行註解掉,然後把 body 標籤改成 <body onload="mytest()"> 再開一次,這次才是頁面載入完成後才呼叫 mytest。
這裡其實錯了兩件事,而且都是經典錯誤。
第一,函式被「呼叫」而不是被「指定」。document.onLoad = mytest() 後面那對括號,代表立刻執行 mytest,然後把它的回傳值(這裡是 undefined)指定給 onLoad。正確寫法是 document.onload = mytest——不帶括號,指定的是函式本身。
這也解釋了為什麼對話框在腳本執行到那一行時就跳出來了:因為那根本不是事件處理常式,而是一次普通的函式呼叫,執行位置就在 <head> 裡,此時 <p id="my2"> 甚至還沒被解析到。
第二,事件名稱的大小寫。標準的寫法是 onload(全小寫)。HTML 屬性對大小寫不敏感,但 JavaScript 的屬性名稱是敏感的,onLoad 只是被當成一個無名的自訂屬性掛上去,瀏覽器根本不會理它。
所以正確的寫法是:
window.onload = mytest; // 不帶括號,全小寫
window.onload 有個實務上的缺點:它會等到所有資源(包含圖片)都下載完才觸發。若某張圖片很慢或已失效,你的程式就得等。因此請改用 DOMContentLoaded,它在 HTML 解析完成、DOM 可用時就觸發:
document.addEventListener("DOMContentLoaded", function () {
// DOM 已就緒,這裡可以安全地 querySelector
});
另一個更常見的選項是把 <script> 放在 </body> 之前,或加上 defer 屬性,這樣程式碼執行時 DOM 自然已經就緒,連監聽都不用。
順帶一提,document.onreadystatechange 也能用來判斷,但 DOMContentLoaded 語意最清楚,是目前的正確選擇。