jQuery 物件是類陣列容器,包裝了一或多個原生 DOM 元素。
| 轉換方向 | 語法 | 說明 |
|---|---|---|
| jQuery → DOM (單一) | $el[0] 或 $el.get(0) | 取得第一個匹配的原生元素 |
| jQuery → DOM (全部) | $el.get() | 回傳原生元素陣列 HTMLElement[] |
| DOM → jQuery | $(domEl) 或 jQuery(domEl) | 包裝成 jQuery 物件,可使用 jQuery 方法 |
| 檢查是否為 jQuery 物件 | obj instanceof jQuery | 或 obj.jquery (版本字串) |
<button id="btn">按鈕</button>
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script>
// 1. 選取器產生 jQuery 物件
const $btn = $("#btn"); // jQuery 物件
console.log($btn.jquery); // "3.7.1"
// 2. jQuery → DOM
const btnDom = $btn[0]; // HTMLButtonElement
const btnDom2 = $btn.get(0); // 同樣
console.log(btnDom.tagName); // "BUTTON"
// 3. DOM → jQuery
const $btnAgain = $(btnDom); // 重新包裝
console.log($btnAgain === $btn); // false (不同實例,但包裝同元素)
// 4. 為什麼要轉換?
// - 原生 API: btnDom.addEventListener(...), btnDom.scrollIntoView()
// - jQuery API: $btn.on(...), $btn.fadeOut()
// 兩者互補,必要時轉換即可。
</script>
| 寫法 | 語法 | 特點 |
|---|---|---|
| 完整寫法 | $(document).ready(fn) | 語意明確,jQuery 1.0+ 支援 |
| 簡寫 (推薦) | $(fn) | 最簡潔,官方文檔推薦 |
| 函式傳遞 | $(function() { ... }) | 等同簡寫,常見於舊教學 |
DOMContentLoaded) 即觸發,**不等待圖片/樣式表載入**。<body> 末尾,通常 DOM 已就緒,可直接執行無需包裹。$(fn) 會依註冊順序依序執行。// 1. DOMContentLoaded - 標準
document.addEventListener("DOMContentLoaded", () => {
console.log("DOM 就緒");
});
// 2. 延遲腳本 - 更簡單
// 在 HTML 中: <script defer src="app.js"></script>
// 腳本會在 DOMContentLoaded 前自動執行,無需包裹。
// 3. 模組腳本 - 自動延遲
// <script type="module" src="app.js"></script>
// 模組預設 defer,且有獨立作用域。
ready 內再包 ready// ❌ 多餘嵌套
$(function() {
$(function() { ... });
});
// ✅ 扁平化
$(function() {
// 所有初始化邏輯
});
ready 與 load$(window).on("load", () => {
// 所有資源 (圖片、CSS、iframe) 完全載入後
// 適合:圖片尺寸計算、完整頁面截圖、預載器隱藏
});
$btn.each((i, el) => { /* el 是 DOM */ });
for (const el of $btn) { /* el 是 DOM */ } // ES2015+ 可迭代
document.getElementById 與 $("#id") 造成認知負擔團隊統一風格:全專案統一用 jQuery 選取器 或 全專案統一用原生 querySelector,減少轉換成本。
$el[0] / $el.get(0) 取 DOM;$(dom) 回 jQuery。$(fn) 簡寫,現代專案改用 defer / type=module。