DIV CSS 佈局教程網

jQuery 物件與 DOM 物件相互轉換:一次搞懂 this 為什麼報錯
編輯:JQuery特效代碼     

寫 jQuery 時最常見的一類錯誤訊息是「xxx.attr is not a function」。原因幾乎都是同一個:手上有的是 DOM 物件,卻呼叫了 jQuery 的方法。理解兩者的界線,這類錯誤就能根除。

兩者是什麼

jQuery 物件是把 DOM 物件包裝後產生的結果。它本質上是一個「像陣列的集合」,永遠帶有長度,可使用 .attr()、.css()、.each() 等 jQuery 方法,但不能用原生 DOM 的屬性與方法。

$("#img").attr("src", "test.jpg");     // $("#img") 是 jQuery 物件

DOM 物件是瀏覽器原生的元素節點,能用 element.src、appendChild()、getElementsByTagName() 等原生 API,但不能用 jQuery 方法。

document.getElementById("img").src = "test.jpg";   // 這是 DOM 物件

哪些組合是錯的

$("#img").attr("src", "test.jpg");                       // ✓
document.getElementById("img").src = "test.jpg";         // ✓

$("#img").src = "test.jpg";                              // ✗ jQuery 物件沒有 src 屬性
document.getElementById("img").attr("src", "test.jpg");  // ✗ DOM 物件沒有 attr 方法

this 的陷阱

在 jQuery 的事件回呼與 .each() 中,this 指向的是當前元素的 DOM 物件,不是 jQuery 物件。所以這樣寫必然出錯:

$("img").each(function () {
    this.attr("src", "test.jpg");      // ✗ this 是 DOM 物件
    $(this).attr("src", "test.jpg");   // ✓ 用 $() 包裝一次即可
});

這也是為什麼 jQuery 提供了 .each(function (index, element) {}) 的第二個參數——若你偏好全程用 jQuery 物件,可以直接用它。

轉換法一:DOM → jQuery

用 $() 把 DOM 物件包起來就完成了:

var v = document.getElementById("v");    // DOM 物件
var $v = $(v);                           // jQuery 物件

之後就能自由使用 jQuery 方法。命名慣例上,前加 $ 有助於一眼辨識型別,這是 jQuery 社群廣泛採用的寫法。

轉換法二:jQuery → DOM

有兩種方式,本質相同:

// (1) 索引取值
var $v = $("#v");            // jQuery 物件
var v  = $v[0];              // DOM 物件
alert(v.checked);            // 檢測這個 checkbox 是否被選中

// (2) get() 方法
var $v = $("#v");
var v  = $v.get(0);          // DOM 物件($v.get()[0] 亦可)
alert(v.checked);

若只想丟掉包裝、取得唯一元素,.get() 不帶參數會回傳包含所有元素的陣列。

一句話總結

DOM 物件才能用 DOM 的方法,jQuery 物件才能用 jQuery 的方法,兩者之間需要明確轉換。實務上的建議是:在一個函式裡盡量只用一種型別。若進入 jQuery 的世界,就把 this 統一寫成 const $el = $(this) 並全程使用;反之若在效能路徑上處理大量節點,直接操作 DOM 會明顯更快,也不必來回轉換。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved