瀏覽器原生並沒有統一的「滑鼠滾輪」事件名稱:IE/Webkit 用 mousewheel,Gecko(Firefox)用 DOMMouseScroll,而且手寫 addEventListener 還得自己處理相容分支。把這些差異包成一個 jQuery 事件,之後就能像 click 一樣用 .mousewheel(fn),是相當典型的插件寫法練習。
(function ($) {
var types = ['DOMMouseScroll', 'mousewheel'];
$.event.special.mousewheel = {
setup: function () {
if (this.addEventListener) {
for (var i = types.length; i;) {
this.addEventListener(types[--i], handler, false);
}
} else {
this.onmousewheel = handler; // 舊 IE
}
},
teardown: function () {
if (this.removeEventListener) {
for (var i = types.length; i;) {
this.removeEventListener(types[--i], handler, false);
}
} else {
this.onmousewheel = null;
}
}
};
$.event.special 是 jQuery 提供的事件掛勾點:setup 在第一個 handler 綁上時執行、teardown 在最後一個 handler 移除時執行。把原生綁定寫在這裡,好處是「綁一次就夠」與「全部解開才真正移除」都由 jQuery 代為管理,不會重複註冊。
$.fn.extend({
mousewheel: function (fn) {
return fn ? this.bind("mousewheel", fn) : this.trigger("mousewheel");
},
unmousewheel: function (fn) {
return this.unbind("mousewheel", fn);
}
});
傳入函式就綁定,不傳就觸發,這個「雙用途」設計在 jQuery 插件裡很常見,讓 API 更貼近直覺。
function handler(event) {
var orgEvent = event || window.event,
args = [].slice.call(arguments, 1),
delta = 0, returnValue = true, deltaX = 0, deltaY = 0;
event = $.event.fix(orgEvent);
event.type = "mousewheel";
// 舊式滾輪 delta
if (event.originalEvent.wheelDelta) { delta = event.originalEvent.wheelDelta / 120; }
if (event.originalEvent.detail) { delta = -event.originalEvent.detail / 3; }
deltaY = delta;
// Gecko:判斷是否為水平滾動
if (orgEvent.axis !== undefined && orgEvent.axis === orgEvent.HORIZONTAL_AXIS) {
deltaY = 0;
deltaX = -1 * delta;
}
// Webkit:多維度滾動(觸控板)
if (orgEvent.wheelDeltaY !== undefined) { deltaY = orgEvent.wheelDeltaY / 120; }
if (orgEvent.wheelDeltaX !== undefined) { deltaX = -1 * orgEvent.wheelDeltaX / 120; }
args.unshift(event, delta, deltaX, deltaY);
return $.event.handle.apply(this, args);
}
})(jQuery);
這段是整個插件的精華:除以 120 是為了把各家不一的刻度單位歸一成「一格 = 1」,取負號是為了統一「往上滾為正」的方向慣例,最後再拆出 deltaX/deltaY 以支援觸控板的斜向滾動。
$(document).mousewheel(function (e, delta, deltaX, deltaY) {
// 依 delta 正負決定要放大還是縮小
});
有了它,做「滾輪縮放圖片」、「滾輪切換焦點圖」這類互動就只是判斷正負而已。要提醒的是,搶走滾輪預設行為會嚴重影響可用性,記得只在明確的互動區域內使用,並提供替代操作方式。