滾輪交互是縮放畫布、橫向輪播、無限滾動的核心。本文詳細講解標準 wheel 事件對象、deltaMode 單位歸一化、跨瀏覽器方向判斷、passive: true 效能優化、防抖/節流控制頻率、橫向滾動實現。
| 屬性 | 含義 | 單位 |
|---|---|---|
deltaX | 水平滾動量 | 像素/行/頁(視 deltaMode) |
deltaY | 垂直滾動量 | 像素/行/頁 |
deltaZ | Z 軸滾動(罕用) | 同上 |
deltaMode | 單位模式:0=像素、1=行、2=頁 | 枚舉 |
function normalizeWheel(e) {
const LINE_HEIGHT = 16; // 近似行高
const PAGE_HEIGHT = 400; // 近似頁高
let { deltaX, deltaY, deltaMode } = e;
if (deltaMode === 1) { deltaX *= LINE_HEIGHT; deltaY *= LINE_HEIGHT; }
else if (deltaMode === 2) { deltaX *= PAGE_HEIGHT; deltaY *= PAGE_HEIGHT; }
return { deltaX, deltaY };
}
// 使用
element.addEventListener('wheel', e => {
const { deltaY } = normalizeWheel(e);
if (deltaY > 0) console.log('向下滾動');
else console.log('向上滾動');
}, { passive: true });
canvas.addEventListener('wheel', e => {
e.preventDefault(); // 防止頁面滾動
const { deltaY } = normalizeWheel(e);
if (e.ctrlKey || e.metaKey) {
// 縮放
scale *= deltaY > 0 ? 0.9 : 1.1;
render();
} else if (e.shiftKey) {
// 橫向滾動
scrollX += deltaY;
} else {
// 縱向滾動
scrollY += deltaY;
}
}, { passive: false }); // 需要 preventDefault,不可 passive
// 預設 passive: true,瀏覽器可異步滾動,不阻塞主執行緒
el.addEventListener('wheel', handler, { passive: true });
// 需要 preventDefault(如畫布縮放、橫向滾動攔截)時
el.addEventListener('wheel', handler, { passive: false });
// 節流:固定間隔執行
const throttled = throttle(handleWheel, 16); // ~60fps
el.addEventListener('wheel', throttled, { passive: true });
// 防抖:停止滾動後執行(如滾動加載完成回調)
const debounced = debounce(onScrollEnd, 150);
el.addEventListener('wheel', debounced, { passive: true });
mousewheel、DOMMouseScroll 已棄用,僅做極舊瀏覽器兼容。deltaY > 0 通常表示**向下/遠離用戶**,但 Mac 觸控板自然滾動方向可在系統設置反轉,邏輯勿硬編碼「正=下」。