需要「滾動才能看完」的內容時,滑鼠滾輪往往比拖曳捲軸更直覺。原生 JavaScript 對滾輪的支援一直很分歧,而 jQuery Mouse Wheel Plugin 把這些差異收拾乾淨,讓你可以用同一個 mousewheel 事件,綁定到任何元素上——不只是一個層,也可以是列表、圖表或自訂的互動區。
事件效果可在此體驗:Mouse Wheel 示範。
這個插件(範例版本 3.1.3,作者 Brandon Aaron)主要處理三件事:
wheel,舊 WebKit 用 mousewheel,Firefox 則是 DOMMouseScroll 與 MozMousePixelScroll。插件依環境自動挑選可用的事件綁定。wheelDelta、detail、deltaY、deltaX 數值尺度不一,插件找出最小的 delta 作為基準再換算,讓回呼函式拿到的值有一致的意義。插件為 jQuery 加了 mousewheel() 與 unmousewheel() 兩個輔助方法,因此你可以任選一種寫法:
// 方式一:使用插件提供的方法
$('div.mousewheel_example').mousewheel(fn);
// 方式二:使用 jQuery 原生的 bind
$('div.mousewheel_example').bind('mousewheel', fn);
實際使用時看起來像这样:
// 用 bind
$('#my_elem').bind('mousewheel', function(event, delta) {
console.log(delta);
});
// 用事件輔助方法
$('#my_elem').mousewheel(function(event, delta) {
console.log(delta);
});
回呼函式的第二個參數 delta 代表滾輪方向:負值表示向下滾,正值表示向上滾。掌握這個約定,就能把它換算成任何你需要的行為——切換幻燈片、縮放圖表、推進時間軸等等。
這個插件問世的年代,瀏覽器還允許在滾輪事件中自由呼叫 preventDefault()。但現代瀏覽器為了讓捲動保持順暢,會把 wheel 事件預設設為 passive,此時直接呼叫 preventDefault() 會失效並在 console 中出現警告。若你確實需要攔下原生捲動,請改用:
element.addEventListener('wheel', handler, { passive: false });
另外,在 jQuery 1.7 之後,事件綁定建議改用 on() 與 off() 取代 bind() 與 unbind(),兩者功能等價,但 on() 支援事件委派,對動態加入的元素更友善:
$('#my_elem').on('mousewheel', function(event, delta) {
console.log(delta);
});
攔截滾輪是「搶走」使用者原本的操作方式,因此務必確認真的有必要,並且保留退路——例如只在游標位於特定區域時才接管,或只在按住修飾鍵時才 intercepts,其餘情況讓頁面正常捲動。同時記得為觸控板與觸控螢幕準備等效的互動方式,避免功能只在滑鼠上成立。