寫 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 方法
在 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 物件包起來就完成了:
var v = document.getElementById("v"); // DOM 物件
var $v = $(v); // jQuery 物件
之後就能自由使用 jQuery 方法。命名慣例上,前加 $ 有助於一眼辨識型別,這是 jQuery 社群廣泛採用的寫法。
有兩種方式,本質相同:
// (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 會明顯更快,也不必來回轉換。