這一節做兩件事:先寫一個自訂的 jQuery 選擇器,再用它來實作一個會跟著滑鼠跑的 tooltip。自訂選擇器是很多人忽略的功能,學會之後能讓程式碼可讀性大幅提升。
(function ($) {
$.expr[':'].customselector = function (object, index, properties, list) {
// code
};
})(jQuery);
呼叫時寫成 $('a:customselector')。四個參數的意義如下:
object:當前 DOM 元素的引用(不是 jQuery 物件)。這點要特別強調:a 是 DOM 元素,$('a') 才是 jQuery 物件,兩者完全不是一回事。index:目前元素在結果集合中的索引(從 0 開始)。properties:選擇器的中介資料。list:整批待過濾的 DOM 元素集合。其中只有第一個參數是必需的,其餘可省略。函式回傳布林值:true 表示保留該元素,false 表示排除。
(function ($) {
$.expr[':'].external = function (object) {
if ($(object).is('a')) {
return object.hostname != location.hostname;
}
};
})(jQuery);
之後就能寫 $('a:external') 一次抓到全頁所有指向外部站點的連結——這比用長串 attribute 選擇器清楚太多,也更難寫錯。
(function ($) {
// 更新提示框座標
$.fn.updatePosition = function (event) {
return this.each(function () {
$(this).css({
left: event.pageX + 20,
top: event.pageY + 5
});
});
};
// 提示框:把 a 標籤的 title 內容做出美化提示
$.fn.tooltip = function () {
return this.each(function () {
var self = $(this);
var title = self.attr('title');
if (self.is('a') && title != '') {
self.removeAttr('title') // 移除原生 title,避免瀏覽器再跳一次預設提示
.hover(function (event) {
// 滑鼠移入:建立提示框並淡入
$('<div id="tooltip"></div>')
.appendTo('body')
.text(title)
.hide()
.updatePosition(event)
.fadeIn(400);
}, function () {
// 滑鼠移出:移除
$('#tooltip').remove();
})
.mousemove(function (event) {
// 滑鼠移動:跟著跑
$('#tooltip').updatePosition(event);
});
}
});
};
})(jQuery);
為什麼要 removeAttr('title'):出廠的 title 屬性會讓瀏覽器在滑鼠停留後另外跳出一個原生提示框,和自製的提示框重疊,視覺上很糟。把 title 存進變數後移除,內容改由自己的元件呈現,行為就單純了。
座標用 pageX/pageY:這兩個值包含文件的捲動量,搭配 absolute 定位才能對得上滑鼠。若改用 clientX/clientY,就必須把定位改成 fixed。偏移量 +20/+5 則是為了讓提示框不會壓在游標底下。
id 只用一個:這個版本全頁共用一個 #tooltip,因此同一時間只會顯示一個提示框。優點是簡單,缺點是無法同時存在多個;若要改進,可改成 class 並以「相對哪個連結」為索引來管理。
想看實際效果可下載 jQuery.plugin.tooltip 的 demo。這個例子把「自訂選擇器」與「外掛」兩件事串在一起,也示範了如何用最小的程式碼換掉瀏覽器的預設外觀。