上一節講了兩個擴充方法,這一節把焦點放在 jQuery.fn 上,並釐清一個很多人寫外掛時沒想清楚的問題:選擇器選到多個元素時,this 到底指誰?
只要為 jQuery.fn 加上屬性,就等於為所有 jQuery 物件加上方法。因為 jQuery.fn 就是 jQuery.prototype 的別名,用別名只是為了少打字。
jQuery.fn.test = function(){
alert('這是 jQuery 物件方法');
}
之後任何 jQuery 物件都能呼叫它:
$(function(){
$('h1').click(function(){
$(this).test();
});
});
在物件方法裡,this 永遠指向當前那個 jQuery 物件。由於 jQuery 選擇器回傳的是一個「類陣列」的元素集合,this 指向的就是整個集合,而不是集合裡的某個元素。所以要取目前節點的名稱,得指明索引:
jQuery.fn.test = function(){
alert(this[0].nodeName); // 只會告訴你第一個元素的節點名
}
如果頁面裡有多個 h1,這個寫法只會回報第一個,其餘全部被忽略——這顯然不是外掛該有的行為。
解法是在方法內部呼叫 each(),讓 this 指標逐一指向每一個匹配到的 DOM 元素:
jQuery.fn.test = function(){
this.each(function(){ // 遍歷集合,此處的 this 是單一 DOM 元素
alert(this.nodeName); // 注意:索引不見了
});
}
請留意這裡的變化:外層的 this 是 jQuery 物件(集合),而 each 回呼裡的 this 已經是原始的 DOM 元素了。兩者混用是外掛開發最常見的錯誤來源,看到 this 時永遠先問一句「我現在在哪一層?」。
改寫之後,呼叫端就不必再操心選擇器匹配到幾個元素:
$(function(){
$('body *').click(function(){
$(this).test();
});
});
<h1>ceshi</h1> <a>dddddddddd</a> <input type="button" value="test"/> <div>div元素</div>
無論點到哪一個元素,都會正確彈出該元素自己的節點名稱。
兩個重點帶走:第一,jQuery.fn 就是 jQuery.prototype;第二,物件方法裡一定要用 each 遍歷,才不會漏掉集合中除了第一個以外的元素。下一節會在這個基礎上加上「回傳 this」,讓外掛能參與鏈式呼叫。