寫 jQuery 一段時間後,幾乎每個人都會遇到這個困惑:明明抓到了元素,為什麼 innerHTML 不能用?或者反过来,別人給我一個原生 DOM 物件,為什麼 jQuery 的方法全都失效?答案在於這兩種物件是不同的東西,需要明確轉換。
為了讓程式碼可讀,本文採用一個常見慣例:jQuery 物件的變數名稱前面加 $。
var $varible = jQuery 物件; var varible = DOM 物件;
這個約定不是語法要求,但對於維護多人專案幫助很大——一眼就知道該用哪一套 API。
jQuery 物件本質上是一個「類陣列」,裡面包著零到多個 DOM 元素。因此有兩種方式取出原始的 DOM 元素:
// 方式一:用中括號加索引 var cr = $cr[1]; // 方式二:用 get() var ct = $cr.get(0);
完整示範:
<body>
<p>my</p>
<p>my</p>
<script src="jquery-2.1.4.min.js"></script>
<script>
var $cr = $("p"); // jQuery 物件
var cr = $cr[1]; // 轉成 DOM 物件
var ct = $cr.get(0); // 另一種轉法
cr.innerHTML = "you"; // 用 DOM 方法,結果:第二個 my 變成 you
ct.innerHTML = 'changed';// 用 DOM 方法,結果:第一個 my 變成 changed
</script>
</body>
什麼時候需要這樣做?當 jQuery 沒有提供你需要的操作,或者效能計算是你自己比較熟悉的時候。例如直接操作 style 屬性、存取 value、checked 這類原生屬性,有時用 DOM 寫法反而更直觀。
反過來更簡單——用 $() 把它包起來就結束了:
<body>
<p>my</p>
<p>my</p>
<script src="jquery-2.1.4.min.js"></script>
<script>
var cr = document.getElementsByTagName("p"); // DOM 物件(其實是 HTMLCollection)
var $cr = $(cr); // 包成 jQuery 物件
$cr.eq(0).text("changed"); // 現在可以用所有 jQuery 方法
$cr.eq(1).html("you");
</script>
</body>
這個操作在整合第三方函式庫時特別常見:對方回傳原生元素,你要用 jQuery 繼續處理,包一下就好。
eq() 回傳的是 jQuery 物件,不是 DOM 物件。很多人以為 $("p").eq(0) 拿到了原生元素,其實它仍然包在 jQuery 裡,只是只含一個元素。要拿真正的 DOM 元素,得再 [0] 或 .get(0)。
each() 的回呼參數是 DOM 物件。這是另一個高頻陷阱:
$("p").each(function (i, el) {
// el 是原生 DOM 物件,el.innerHTML 可以,el.html() 不行
// this 也是原生 DOM 物件
$(el).text("用 jQuery 改寫"); // 需要 jQuery 就現場包一下
});
轉換的成本很低。$(domElement) 只是包一層包裝物件,不需要複製節點,在迴圈裡反覆包也不會有明顯效能問題。所以遇到不確定時,直接包起來用最省事。
記住兩條規則就不會亂:
innerHTML、style、value、appendChild)只能用在 DOM 物件上。html()、css()、val()、append())只能用在 jQuery 物件上。轉換方式各一句話講完:DOM 轉 jQuery 用 $() 包;jQuery 轉 DOM 用 [index] 或 .get(index)。剩下的,就看你當下用哪一套寫起來更順手。