萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 基礎:物件轉換 (jQuery ⇄ DOM) 與文檔載入就緒事件詳解

jQuery 物件與原生 DOM 元素互轉

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() { ... })等同簡寫,常見於舊教學

執行時機

  • DOM 解析完成、樹構建完畢 (DOMContentLoaded) 即觸發,**不等待圖片/樣式表載入**。
  • 若腳本放在 <body> 末尾,通常 DOM 已就緒,可直接執行無需包裹。
  • 多個 $(fn) 會依註冊順序依序執行。

原生 JS 等價寫法 (現代專案常見)

// 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,且有獨立作用域。

常見坑點與最佳實踐

1. 不要在 ready 內再包 ready

// ❌ 多餘嵌套
$(function() {
    $(function() { ... });
});

// ✅ 扁平化
$(function() {
    // 所有初始化邏輯
});

2. 區分 ready 與 load

$(window).on("load", () => {
    // 所有資源 (圖片、CSS、iframe) 完全載入後
    // 適合:圖片尺寸計算、完整頁面截圖、預載器隱藏
});

3. jQuery 物件非陣列,但可迭代

$btn.each((i, el) => { /* el 是 DOM */ });
for (const el of $btn) { /* el 是 DOM */ } // ES2015+ 可迭代

4. 避免混用 document.getElementById 與 $("#id") 造成認知負擔

團隊統一風格:全專案統一用 jQuery 選取器 或 全專案統一用原生 querySelector,減少轉換成本。

總結

  • $el[0] / $el.get(0) 取 DOM;$(dom) 回 jQuery。
  • 文檔就緒用 $(fn) 簡寫,現代專案改用 defer / type=module。
  • 理解兩種物件體系差異,需要原生 API 時大方轉換,不要強求純 jQuery。
copyright © 萬盛學電腦網 all rights reserved