想做一個「滾一下鼠標就在整屏之間切換」的效果,看似簡單,實際踩了不少坑。最惱人的是 Chrome 下事件總是觸發好幾次,導致動畫錯亂。這裡記錄完整的排查過程與最終方案。
頁面結構是幾個 1000px 高的色塊:
<style>
div { width: 700px; height: 1000px; }
.red { background-color: red; }
.yellow { background-color: yellow; }
</style>
<body>
<div class="red"></div>
<div class="yellow"></div>
<div class="red"></div>
</body>
腳本部分:
$(document).ready(function(){
var height = $(window).height(); // 視窗可見區域高度
var scrollFunc = function(e){
var scrollTop = document.body.scrollTop
|| document.documentElement.scrollTop;
e = e || window.event;
// 向下滾:滾到下一屏
if((e.wheelDelta < 0 || e.detail > 0)
&& scrollTop >= 0 && scrollTop < height){
$(document.body).animate({scrollTop: height}, "fast");
$(document.documentElement).animate({scrollTop: height}, "fast");
}
// 向上滾:回到頂部
else if((e.wheelDelta > 0 || e.detail < 0)
&& scrollTop >= height && scrollTop <= height + 20){
$(document.body).animate({scrollTop: 0}, "fast");
$(document.documentElement).animate({scrollTop: 0}, "fast");
}
};
// 兼容不同瀏覽器的滾輪事件綁定
if(document.addEventListener){
document.addEventListener('DOMMouseScroll', scrollFunc, false);
}
window.onmousewheel = document.onmousewheel = scrollFunc;
});
這裡同時綁定了三套事件:DOMMouseScroll 給 Firefox、onmousewheel 給 IE 和 Chrome/Safari,並用 e.wheelDelta 與 e.detail 分別判斷滾動方向。
這段代碼在 IE 和 Firefox 下測試正常,但 Chrome 裡 onmousewheel 總是觸發多次。原因其實不難理解:
用戶滾動鼠標時往往一口氣滾動很大幅度,而不是一格一格慢慢滾。物理滾輪的一次「格動」會產生多個 wheel 事件,這些事件密集到達時,animate 動畫還沒執行完就被再次調用。動畫隊列堆積,最終表現為「滾一下卻翻了好幾屏」或者「滾不動」。
var scrollFunc = function(e){
document.onmousewheel = undefined; // 先摘掉監聽
// ... 判斷與動畫邏輯不變,但加上完成回調
$(document.body).animate({scrollTop: height}, "fast", "linear", function(){
document.onmousewheel = scrollFunc; // 動畫結束再掛回去
});
};
核心思路是「加鎖」:動畫開始時解除綁定,動畫結束的回调裡恢復綁定。這樣在過渡期間的所有滾輪事件都被無視,自然不會重複觸發。
這個方案有效,但代碼變得冗餘——每個 animate 都要寫一遍回調,而且同時操作 document.body 和 document.documentElement 兩個元素,回調要寫兩次。
$(document).ready(function(){
var height = $(window).height();
var width = $(window).width();
// 不同瀏覽器的滾動主體不同,先判斷好
var body;
if(navigator.userAgent.indexOf("Firefox") > 0
|| navigator.userAgent.indexOf("MSIE") > 0){
body = document.documentElement;
}else{
body = document.body;
}
var isFinish = true; // 動畫是否已完成
var scrollFunc = function(e){
if(isFinish){
var scrollTop = body.scrollTop;
e = e || window.event;
if((e.wheelDelta < 0 || e.detail > 0)
&& scrollTop >= 0 && scrollTop < height - 20){
scroll(height);
}else if((e.wheelDelta > 0 || e.detail < 0)
&& scrollTop >= height && scrollTop <= height + 20){
scroll(0);
}
}
};
// 把動畫邏輯抽成獨立函數
var scroll = function(height){
isFinish = false;
$(body).animate({scrollTop: height}, "fast", "linear", function(){
isFinish = true;
});
};
// 按瀏覽器分別綁定
if(navigator.userAgent.indexOf("Firefox") > 0){
if(document.addEventListener){
document.addEventListener('DOMMouseScroll', scrollFunc, false);
}
}else{
document.onmousewheel = scrollFunc;
}
});
相比上一版,這裡有三處實質改進:
用 isFinish 布爾標誌代替反覆解綁綁定。狀態判斷比 DOM 操作更輕量,也不需要在每個分支重複寫回調。
把動畫邏輯抽成 scroll() 函數。消除重複代碼,兩個方向的分支只是傳不同的目標值。
提前算好滾動主體。不再每次判斷瀏覽器,也不再同時操作兩個元素。
這個問題的解法思路是對的,但代碼還有幾處可以更嚴謹:
用 wheel 事件統一替代。DOMMouseScroll 和 mousewheel 都已被標準的 wheel 事件取代,用 event.deltaY 判斷方向即可,不必再做 userAgent 嗅探:
window.addEventListener('wheel', (e) => {
if (locked) return;
if (e.deltaY > 0) goTo(nextScreen);
else if (e.deltaY < 0) goTo(prevScreen);
}, { passive: false });
用 CSS scroll-snap 讓瀏覽器原生實現整屏吸附。這是最省事的做法,幾乎不需要 JS:
html {
scroll-snap-type: y mandatory;
scroll-behavior: smooth;
}
section {
height: 100vh;
scroll-snap-align: start;
}
記得處理鍵盤與觸屏。只監聽滾輪會讓鍵盤方向鍵、PageDown、觸屏滑動全部失效,這是無障礙上的明顯缺陷。完整方案需要同時考慮這些輸入方式。
通過解決這個問題確實學到不少。核心收穫是:處理高頻觸發的事件時,必須有明確的「執行中」狀態隔離機制——無論用解綁事件、布爾標誌還是節流函數,本質都是同一件事。少寫代碼、多辦事,這個目標值得一直努力。