JavaScript 引擎單線程、自上而下解析執行。若腳本在 DOM 元素之前執行訪問該元素,會報 null 錯誤。本文系統講解腳本加載阻塞機制、defer/async、DOMContentLoaded vs load、jQuery $(document).ready() 原理與最佳實踐。
<!-- 錯誤示例:腳本在 DOM 之前 -->
<script> document.getElementById('ele').innerHTML = '...'; </script>
<div id="ele">...</div> // 報錯:ele is null
<div id="ele">...</div>
<script> document.getElementById('ele').innerHTML = '...'; </script>
document.addEventListener('DOMContentLoaded', function () {
document.getElementById('ele').innerHTML = '...';
});
// 完整寫法
$(document).ready(function () {
$('#ele').html('welcome to my blog');
});
// 簡寫(推薦)
$(function () {
$('#ele').html('welcome to my blog');
});
原理:jQuery 內部監聽 DOMContentLoaded(現代瀏覽器)或 document.readyState 輪詢(舊 IE),確保在 DOM 解析完成、外部資源(圖片、樣式)未必載入完成時回調。
| 屬性 | 阻塞解析 | 執行時機 | 順序保證 | 適用場景 |
|---|---|---|---|---|
| 無屬性 | 是 | 立即,解析到即執行 | 按書寫順序 | 內聯腳本、需同步執行 |
| defer | 否(異步下載) | DOMContentLoaded 前,按順序 | 是 | 外部腳本、相互依賴 |
| async | 否(異步下載) | 下載完成立即執行 | 否(乱序) | 獨立第三方腳本(統計、廣告) |
| module | 否(異步) | defer 行為 | 按依賴圖 | ES Module |
| 事件 | 觸發時機 | 典型用途 |
|---|---|---|
| DOMContentLoaded | HTML 解析完成,DOM 樹構建完畢(不等待 CSS/圖片) | 初始化 UI、綁定事件、啟動應用 |
| window.onload / $(window).on('load') | 所有外部資源(CSS、圖片、iframe、字體)加載完成 | 需獲取圖片尺寸、計算佈局、預載資源完成 |
$(document).ready() 觸發遠早於 window.onload,體驗更快。
$(function () { console.log(1); });
$(function () { console.log(2); });
// 輸出:1 2(按註冊順序)
defer。script.onload 回調中操作該腳本提供的 API。<head>,JS 放 </body> 前。<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>頁面標題</title>
<link rel="stylesheet" href="app.css">
<script src="vendor.js" defer></script> <!-- 第三方庫 -->
<script src="app.js" defer></script> <!-- 業務代碼,依賴 vendor -->
</head>
<body>
<div id="app"></div>
</body>
</html>
// app.js
document.addEventListener('DOMContentLoaded', () => {
// 初始化邏輯
});
遵循「CSS 上、JS 下、defer 異步、DOMContentLoaded 初始化」原則,構建高性能、無錯誤的頁面加載流程。