確保 DOM 就緒後再執行 JavaScript 是前端開發的基礎。jQuery 提供了簡潔的就緒事件 API,但原生 DOMContentLoaded、window.onload 以及現代模組系統的載入時機各有差異。本文梳理三種常見方式的執行時機、優缺點與現代最佳實踐。
方式一:jQuery 簡潔就緒語法 (推薦)
$(function() {
// DOM 就緒,可安全操作元素
initPublish();
});
// 等價於
$(document).ready(function() {
initPublish();
});
- ✅ 簡潔、語意明確
- ✅ 多次呼叫會依序執行
- ✅ 若 DOM 已就緒,回調立即同步執行
- ⚠️ 需載入 jQuery
方式二:$(document).ready() 完整寫法
$(document).ready(function() {
initPublish();
// 可在內部綁定事件
$('.btn').click(function() {
// ...
});
});
與方式一功能相同,只是語法較冗長。早期版本文檔常用此寫法。
方式三:原生 window.onload
window.onload = function() {
// 所有資源 (圖片、樣式表、iframe) 完全載入後執行
initPublish();
};
關鍵差異:DOMContentLoaded vs load
| 事件 | 觸發時機 | 典型延遲 | 適用場景 |
DOMContentLoaded (jQuery ready) | HTML 解析完成、DOM 樹建構完成 | 快 (不等資源) | 絕大多數 UI 初始化、事件綁定 |
window.onload | 所有外部資源載入完成 | 慢 (等圖片、CSS、字體) | 需獲取圖片尺寸、iframe 內容、完整頁面截圖 |
現代最佳實踐:原生 + 模組系統
原生 DOMContentLoaded (無 jQuery 依賴)
document.addEventListener('DOMContentLoaded', function() {
initPublish();
});
ES Module 自動延遲執行
<script type="module">
// 模組腳本預設 defer,會在 DOMContentLoaded 前執行
// 但保證 DOM 解析完成 (因為 defer)
import { initPublish } from './app.js';
initPublish();
</script>
defer` / `async 腳本屬性
| 屬性 | 下載 | 執行時機 | 順序保證 |
| 無 | 阻塞解析 | 立即 | 按順序 |
defer | 並行 | DOMContentLoaded 前 | 按順序 |
async | 並行 | 下載完成立即 | 無保證 |
type="module" | 並行 | DOMContentLoaded 前 | 按順序 |
常見錯誤與避坑
- 在 `` 直接操作 DOM:元素尚不存在 → 用 ready/onload
- 多個 `window.onload` 覆蓋:後者蓋掉前者 → 用
addEventListener
- jQuery ready 中操作未載入的圖片尺寸:需在
load 或圖片 onload 中處理
- 非同步腳本依賴 jQuery:確保 jQuery 先載入,或用模組導入
框架環境下的對應
| 框架 | 掛載/就緒鉤子 | 備註 |
| React | useEffect(() => {}, []) | 客戶端 hydration 後 |
| Vue 3 | onMounted(() => {}) | DOM 掛載完成 |
| Angular | ngAfterViewInit() | 視圖初始化完成 |
| Svelte | onMount(() => {}) | 組件掛載 |
總結建議
- 現代專案 (ES Module):直接在 `