| 瀏覽器 | 事件名 | 屬性 | 方向值 |
|---|---|---|---|
| IE/Edge/Chrome/Safari/Opera | mousewheel / wheel | wheelDelta (+120 向上, -120 向下) | 正=上,負=下 |
| Firefox (舊) | DOMMouseScroll | detail (-3 向上, +3 向下) | 負=上,正=下 |
| 現代標準 (所有) | wheel | deltaY (正=下,負=上) | 負=上,正=下 |
class WheelHandler {
/**
* @param {HTMLElement} target - 監聽目標,默認 window
* @param {Function} onWheel - 回調 (delta, event) delta>0 向下, <0 向上
* @param {Object} options
*/
constructor(target = window, onWheel, options = {}) {
this.target = target;
this.onWheel = onWheel;
this.options = Object.assign({
passive: false, // 是否 passive 模式(不阻止默認)
normalize: true, // 歸一化 delta 為 ±1
preventDefault: true // 阻止頁面滾動
}, options);
this._bind();
}
_bind() {
// 現代統一事件
this.target.addEventListener('wheel', this._handleWheel.bind(this), {
passive: this.options.passive
});
// Firefox 兼容(舊版)
if ('onwheel' in document === false) {
this.target.addEventListener('DOMMouseScroll', this._handleWheel.bind(this), {
passive: this.options.passive
});
}
}
_handleWheel(e) {
let delta = 0;
if (e.deltaY !== undefined) { // WheelEvent (現代標準)
delta = e.deltaY;
// deltaMode: 0=像素, 1=行, 2=頁
if (e.deltaMode === 1) delta *= 40; // 行高近似
else if (e.deltaMode === 2) delta *= 400; // 頁高近似
} else if (e.wheelDelta !== undefined) { // MouseWheelEvent (舊 WebKit/IE)
delta = -e.wheelDelta; // 統一為:正=下,負=上
} else if (e.detail !== undefined) { // DOMMouseScroll (Firefox 舊)
delta = e.detail * 40; // 近似像素
}
// 歸一化為 ±1
if (this.options.normalize) {
delta = delta > 0 ? 1 : -1;
}
// 阻止默認滾動
if (this.options.preventDefault) {
e.preventDefault();
}
// 觸發回調
if (this.onWheel) this.onWheel(delta, e);
}
destroy() {
this.target.removeEventListener('wheel', this._handleWheel.bind(this));
this.target.removeEventListener('DOMMouseScroll', this._handleWheel.bind(this));
}
}
const carousel = document.querySelector('.carousel');
let currentIndex = 0;
const items = carousel.querySelectorAll('.item');
new WheelHandler(carousel, (delta) => {
if (delta > 0) { // 向下滾動 -> 下一張
currentIndex = (currentIndex + 1) % items.length;
} else { // 向上滾動 -> 上一張
currentIndex = (currentIndex - 1 + items.length) % items.length;
}
updateCarousel();
}, { preventDefault: true }); // 阻止頁面滾動
const canvas = document.getElementById('canvas');
let scale = 1;
new WheelHandler(canvas, (delta, e) => {
if (e.ctrlKey || e.metaKey) { // 按住 Ctrl/Command 縮放
e.preventDefault();
const factor = delta > 0 ? 0.9 : 1.1; // 向下縮小,向上放大
scale = Math.max(0.1, Math.min(5, scale * factor));
canvas.style.transform = `scale(${scale})`;
}
}, { preventDefault: false, normalize: false }); // 需要精確 delta 值
const hScroll = document.querySelector('.h-scroll');
new WheelHandler(hScroll, (delta, e) => {
// 垂直滾輪轉為橫向滾動
hScroll.scrollLeft += delta * 40; // delta 已歸一化 ±1
}, { preventDefault: true });
function throttle(fn, delay = 16) {
let last = 0;
return (...args) => {
const now = Date.now();
if (now - last >= delay) {
last = now;
fn(...args);
}
};
}
new WheelHandler(window, throttle((delta) => {
// 處理滾動邏輯
console.log('滾動方向:', delta > 0 ? '下' : '上');
}, 50), { passive: true }); // passive: true 允許瀏覽器優化滾動
現代瀏覽器默認將 wheel/touchstart 視為 passive: true,即不能調用 preventDefault()。若需阻止默認滾動,必須顯式聲明 { passive: false }。
// 檢測支持
let supportsPassive = false;
try {
const opts = Object.defineProperty({}, 'passive', { get() { supportsPassive = true; } });
window.addEventListener('test', null, opts);
} catch (e) {}
const handler = (e) => { /* ... */ };
window.addEventListener('wheel', handler, supportsPassive ? { passive: false } : false);
document.addEventListener('keydown', (e) => {
const scrollAmount = 100;
switch (e.key) {
case 'ArrowDown': case 'PageDown':
window.scrollBy(0, scrollAmount); break;
case 'ArrowUp': case 'PageUp':
window.scrollBy(0, -scrollAmount); break;
case 'Home': window.scrollTo(0, 0); break;
case 'End': window.scrollTo(0, document.body.scrollHeight); break;
}
});
e.target.closest('.scroll-container') 判斷e.ctrlKey (Win/Linux) / e.metaKey (Mac) 區分縮放與滾動