寫 jQuery 時最常見的錯誤訊息,往往來自「把兩種物件搞混」。搞清楚 DOM 物件與 jQuery 物件的界線,能省下大量無解的除錯時間。
DOM 物件是 JavaScript 原生的操作方式,只能使用原生方法,不能用 jQuery 的方法。例如:
document.getElementById("img").src = "test.jpg";
這裡的 document.getElementById("img") 就是 DOM 物件。
而下面兩種寫法是等價的,都正確:
$("#img").attr("src", "test.jpg");
document.getElementById("img").src = "test.jpg";
相對地,以下兩種寫法都是錯的,因為把兩邊的方法混用了:
$("#img").src = "test.jpg"; // jQuery 物件用 DOM 屬性
document.getElementById("img").attr("src", "test.jpg"); // DOM 物件用 jQuery 方法
我在寫 jQuery 時很習慣這樣寫:
this.attr("src", "test.jpg"); // 出錯!
原因很單純:this 在 jQuery 的 each() 或事件回呼中指的是 DOM 物件,而 attr() 是 jQuery 方法,兩者對不上。解法就是把 DOM 物件包裝成 jQuery 物件:
$(this).attr("src", "test.jpg"); // 正確
只要用 $() 把 DOM 物件包起來,就得到 jQuery 物件:
var v = document.getElementById("v"); // DOM 物件
var $v = $(v); // jQuery 物件
轉換之後就能自由使用所有 jQuery 方法。實務上約定俗成會用 $ 前綴標示變數是 jQuery 物件,可讀性會好很多。
jQuery 物件本質上是一個「含有集合元素、並帶有 jQuery 方法的陣列樣物件」,所以有兩種取法:
var $v = $("#v"); // jQuery 物件
var v = $v[0]; // DOM 物件
alert(v.checked); // 檢測這個 checkbox 是否被選中
var $v = $("#v"); // jQuery 物件
var v = $v.get(0); // DOM 物件
alert(v.checked); // 檢測這個 checkbox 是否被選中
兩者結果完全相同,.get() 語意上更清楚一些。若不帶參數呼叫 .get(),則會回傳所有元素組成的原生陣列。
需要 jQuery 提供的便利方法(選擇器、鏈式呼叫、動畫、ajax)時,就轉成 jQuery 物件;需要存取原生屬性、或要把元素交給第三方非 jQuery 函式庫時,就轉回 DOM 物件。同一行程式裡兩者來回轉換,其實是完全正常的。