DIV CSS 佈局教程網

jQuery Mouse Wheel 插件:為任何元素加上滾輪事件
編輯:JQuery常見問題     

需要「滾動才能看完」的內容時,滑鼠滾輪往往比拖曳捲軸更直覺。原生 JavaScript 對滾輪的支援一直很分歧,而 jQuery Mouse Wheel Plugin 把這些差異收拾乾淨,讓你可以用同一個 mousewheel 事件,綁定到任何元素上——不只是一個層,也可以是列表、圖表或自訂的互動區。

事件效果可在此體驗:Mouse Wheel 示範。

插件在做什麼

這個插件(範例版本 3.1.3,作者 Brandon Aaron)主要處理三件事:

  • 統一事件名稱:標準寫法是 wheel,舊 WebKit 用 mousewheel,Firefox 則是 DOMMouseScroll 與 MozMousePixelScroll。插件依環境自動挑選可用的事件綁定。
  • 把滾動量正規化:不同瀏覽器提供的 wheelDelta、detail、deltaY、deltaX 數值尺度不一,插件找出最小的 delta 作為基準再換算,讓回呼函式拿到的值有一致的意義。
  • 補上 fixHooks:讓滾輪事件能像其他 jQuery 事件一樣被正常修正與派發。

兩種綁定方式

插件為 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,其餘情況讓頁面正常捲動。同時記得為觸控板與觸控螢幕準備等效的互動方式,避免功能只在滑鼠上成立。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved