萬盛學電腦網

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

jQuery 物件與 DOM 元素互相轉換完整指南

jQuery 物件是包裝 DOM 元素的類陣列物件,兩者 API 不互通。掌握雙向轉換技巧,能在需要原生 DOM 方法時靈活切換。

命名慣例

  • jQuery 物件變數前綴 `$`:`var $el = $('#id');`
  • DOM 元素變數不加 `$`:`var el = document.getElementById('id');`

jQuery → DOM

方式 1:索引存取 `[index]`

var $div = $('#myDiv');
var div = $div[0]; // 第一個 DOM 元素
console.log(div.id); // "myDiv"

方式 2:`.get(index)`

var div = $div.get(0); // 同 [0]
var allDivs = $div.get(); // 取得純 DOM 陣列

DOM → jQuery

var div = document.getElementById('myDiv');
var $div = $(div); // 包裝成 jQuery 物件
$div.addClass('active'); // 可使用 jQuery 方法

常見應用場景

場景轉換方向理由
需呼叫原生 API(如 `canvas.getContext()`、`video.play()`、`input.select()`)jQuery → DOMjQuery 未封裝或封裝不完整
第三方庫要求 DOM 元素(如 Chart.js、SortableJS)jQuery → DOM庫不相容 jQuery 物件
原生事件處理器內 `this` 為 DOM,需用 jQuery 方法DOM → jQuery`$(this).fadeOut()`
表單驗證取得 `validity` 狀態jQuery → DOM`$input[0].validity.valid`

注意事項

  • jQuery 物件可能包含多個 DOM 元素,`[0]`/`.get(0)` 只取第一個
  • 轉換後請勿混淆變數命名,避免誤用 API
  • 現代專案建議**直接使用原生 DOM API**(`querySelector`、`classList`、`addEventListener`、`dataset` 等),減少 jQuery 依賴

原生替代範例

// 代替 $('#id')
const el = document.getElementById('id');
// 或
const el = document.querySelector('#id');

// 代替 $el.addClass('active')
el.classList.add('active');

// 代替 $el.on('click', fn)
el.addEventListener('click', fn);

// 代替 $el.data('key', val)
el.dataset.key = val; // 只支援字串,物件需 JSON.stringify
copyright © 萬盛學電腦網 all rights reserved