做前台頁面時遇到一個惱人的問題:在 mouseover 上掛了動畫,使用者滑鼠快速掃過時,動畫會一個接一個堆疊執行,等停下來時畫面已經亂成一團——面板一開一合、位置錯亂、閃個不停。
if (!$(".content").is(":animated")) {
// 元素不在動畫中,才執行
}
:animated 是 jQuery 的擴充選擇器,會回傳目前有動畫正在執行的元素。把它包在條件裡,就能確保同一時間只有一個動畫在跑。
只判斷 :animated 有個缺點:使用者在動畫進行中做的操作會被直接丟棄,可能覺得「怎麼沒反應」。更常見的做法是 stop()——中止目前的動畫,立刻接著跑新的:
$(".panel").on("mouseenter", function(){
$(".content").stop(true, false).slideDown(300);
});
$(".panel").on("mouseleave", function(){
$(".content").stop(true, false).slideUp(300);
});
stop(clearQueue, jumpToEnd) 的兩個參數:
clearQueue:是否清空尚未執行的動畫佇列。true 表示清掉,避免舊動作稍後又冒出來。jumpToEnd:是否讓目前的動畫直接跳到終點。false 表示就地停住(從目前位置反向),true 表示先完成再做新的。滑入滑出的情境通常用 stop(true, false) 最自然:面板會從「目前的高度」平滑地往新方向走,不會跳動。
如果需求只是「反覆切換」,直接用 slideToggle() 搭配 stop() 即可,不必自己判斷狀態:
$(".btn").on("click", function(){
$(".content").stop(true, false).slideToggle(300);
});
純粹的開合、淡入淡出,用 CSS transition 反而更順——因為瀏覽器會自動從「目前的插值狀態」反向補間,天生不會有堆疊問題:
.content{
max-height: 0;
overflow: hidden;
transition: max-height .3s ease;
}
.content.open{ max-height: 500px; }
切換時只要 $(".content").toggleClass('open'),一行 JavaScript 就夠了。
做懸停效果時,mouseenter/mouseleave 比 mouseover/mouseout 更合適。原因是後者會冒泡:滑鼠從父元素移到子元素時也會觸發,於是在一個內部結構複雜的元件上來回移動,就會引出大量事件——這正是「動畫重複執行」的另一個常見來源。若元件內還有子元素要一起維持效果,改用 mouseenter 搭配 mouseleave 就乾淨了。
最後記得,若使用者的系統開啟了「減少動態效果」,應把動畫時長降為 0,直接顯示最終狀態。