很多剛開始學 jQuery 的人不知道,原生 JS 抓到的元素要怎麼用 jQuery 的方法操作。答案是一個函式呼叫:$(element)。
$(document.getElementsByTagName("a")).each(function () {
if ($(this).text() == "jquerys") {
$(this).addClass("navTitle");
}
});
document.getElementsByTagName("a") 回傳的是原生 NodeList,把它整包丟進 $(),就得到一個 jQuery 物件,此後就能使用 each、text、addClass 等方法。
// 1. 單一元素
var el = document.getElementById("msg");
$(el).hide();
// 2. 元素集合(NodeList / HTMLCollection)
$(document.getElementsByTagName("a")).css("color", "red");
// 3. 已經是 jQuery 物件 → 不需要再包
var $msg = $("#msg");
$msg.hide(); // 直接可用
$($msg).hide(); // 多包一層,能跑但沒意義
var $items = $(".item");
var first = $items[0]; // 用索引取出 → 原生元素
var first2 = $items.get(0); // 用 get() 取出 → 同上
$items[0].focus(); // 只能用原生方法
$items.eq(0).focus(); // 用 eq() 則仍是 jQuery 物件
這個區別很重要:[0] 與 get(0) 拿到的是原生元素,eq(0) 拿到的是只含一個元素的 jQuery 物件。混用時常見的錯誤是對原生元素呼叫 jQuery 方法,例如 $items[0].hide() 會直接丟出「hide is not a function」。
在 each(function(){}) 中,this 是原生 DOM 元素,不是 jQuery 物件。所以 this.addClass() 會失敗,必須寫成 $(this).addClass()。若想反過來在原生迴圈中使用 jQuery 方法,就必須手動包裝:
var links = document.getElementsByTagName("a");
for (var i = 0; i < links.length; i++) {
$(links[i]).addClass("navTitle"); // 每次迭代都要包一次
}
$() 包裝會建立一個新物件,因此盡量不要在同一段程式裡反覆包裝同一個元素。在迴圈中把 $(this) 存進變數再用,是常見的微優化:
$(".item").each(function () {
var $this = $(this); // 只包一次
$this.addClass("a");
$this.attr("title", $this.text());
});
實務建議:能用 jQuery 選擇器($("#id")、$(".cls"))時就直接用,它回傳的本來就是 jQuery 物件;只有在你手上已經握有原生元素(例如從第三方回呼、原生事件處理函式的 event.target 拿到)時,才需要 $() 包裝一次。