本質是「進入區域啟動定時器,離開區域取消定時器,超時執行回調」。適用於:延遲展開下拉菜單、懸停預加載、防誤觸發確認、自動播放視頻等場景。
<div class="trigger-zone">將鼠標停留在此 3 秒</div>
<script>
$(function () {
var $zone = $('.trigger-zone');
var timer = null;
var DELAY = 3000; // 3 秒
$zone.on('mouseenter', function () {
var $this = $(this);
timer = setTimeout(function () {
// 執行動作
alert('停留 3 秒,觸發動作!');
// 實際業務:$this.addClass('active'); loadData(); showTooltip(); 等
timer = null;
}, DELAY);
}).on('mouseleave', function () {
if (timer) {
clearTimeout(timer);
timer = null;
}
});
});
</script>
;(function ($) {
$.fn.hoverDelay = function (options) {
var opts = $.extend({
delay: 3000, // 延遲毫秒
enter: null, // 進入即時回調
leave: null, // 離開即時回調
timeout: null, // 超時執行回調
once: false // 是否只觸發一次
}, options);
return this.each(function () {
var $el = $(this);
var timer = null;
var triggered = false;
function clear() {
if (timer) {
clearTimeout(timer);
timer = null;
}
}
$el.on('mouseenter.hoverDelay', function () {
if (opts.once && triggered) return;
if ($.isFunction(opts.enter)) opts.enter.call(this);
clear();
timer = setTimeout(function () {
if ($.isFunction(opts.timeout)) {
opts.timeout.call(this);
triggered = true;
}
timer = null;
}.bind(this), opts.delay);
}).on('mouseleave.hoverDelay', function () {
clear();
if ($.isFunction(opts.leave)) opts.leave.call(this);
});
// 支持銷毀
$el.data('hoverDelay', {
destroy: function () {
clear();
$el.off('.hoverDelay').removeData('hoverDelay');
}
});
});
};
})(jQuery);
// 1. 基礎:3 秒後顯示提示
$('.trigger-zone').hoverDelay({
timeout: function () {
$(this).append('已停留 3 秒');
}
});
// 2. 完整生命周期:進入/離開/超時
$('.menu-item').hoverDelay({
delay: 500,
enter: function () { $(this).addClass('hover'); },
leave: function () { $(this).removeClass('hover'); },
timeout: function () {
$(this).find('.sub-menu').slideDown(200);
}
});
// 3. 單次觸發:引導提示只出現一次
$('.guide-step').hoverDelay({
delay: 2000,
once: true,
timeout: function () {
$(this).addClass('guide-show');
trackEvent('guide_shown', {step: $(this).data('step')});
}
});
// 4. 動態銷毀
var $zone = $('.dynamic-zone').hoverDelay({...});
// 稍後移除
$zone.data('hoverDelay').destroy();
.trigger-zone {
position: relative;
border: 2px dashed #ccc;
transition: border-color 0.3s;
}
.trigger-zone.hover { border-color: #0088bb; }
.trigger-zone::after {
content: '';
position: absolute;
bottom: 0; left: 0;
width: 0%; height: 3px;
background: #0088bb;
transition: width 0s linear; /* 由 JS 控制 */
}
.trigger-zone.loading::after {
transition-duration: 3s; /* 對應 delay */
width: 100%;
}
// JS 中添加/移除 loading 類
enter: function () { $(this).addClass('hover loading'); },
leave: function () { $(this).removeClass('hover loading'); },
timeout: function () { $(this).removeClass('loading'); /* 執行動作 */ }
// React useHoverDelay Hook
import { useState, useRef, useCallback, useEffect } from 'react';
function useHoverDelay(delay = 3000, onTimeout) {
const [isHovering, setHovering] = useState(false);
const [progress, setProgress] = useState(0);
const timerRef = useRef(null);
const startRef = useRef(0);
const frameRef = useRef(null);
const clear = useCallback(() => {
if (timerRef.current) clearTimeout(timerRef.current);
if (frameRef.current) cancelAnimationFrame(frameRef.current);
timerRef.current = null;
frameRef.current = null;
setProgress(0);
}, []);
const onEnter = useCallback(() => {
setHovering(true);
startRef.current = Date.now();
clear();
timerRef.current = setTimeout(() => {
onTimeout?.();
clear();
}, delay);
// 進度條動畫
const tick = () => {
const elapsed = Date.now() - startRef.current;
setProgress(Math.min(elapsed / delay, 1));
if (elapsed < delay) frameRef.current = requestAnimationFrame(tick);
};
frameRef.current = requestAnimationFrame(tick);
}, [delay, onTimeout, clear]);
const onLeave = useCallback(() => {
setHovering(false);
clear();
}, [clear]);
useEffect(() => clear, []); // 卸載清理
return { onMouseEnter: onEnter, onMouseLeave: onLeave, isHovering, progress };
}
// 使用
function TriggerZone() {
const { onMouseEnter, onMouseLeave, progress } = useHoverDelay(3000, () => {
alert('觸發!');
});
return (
停留 3 秒觸發
);
}
| 問題 | 原因 | 解決 |
|---|---|---|
| 快速進出多次導致多次觸發 | 未清除舊定時器 | 每次 enter 先 clearTimeout,用閉包/實例變量保存 timer |
| 動態添加的元素不生效 | 直接綁定而非委託 | 用 $(document).on('mouseenter', '.selector', ...) 或插件化綁定 |
| 頁面卸載/組件銷毀時定時器殘留 | 未清理 | 提供 destroy 方法,在 beforeunload/組件 unmount 調用 |
| 移動端無 hover 事件 | 觸屏設備無持續 hover 狀態 | 改用 touchstart/touchend 或長按手勢庫 |
「停留 N 秒觸發」是典型的「狀態機」模式:IDLE --enter--> WAITING --timeout--> TRIGGERED,WAITING --leave--> IDLE。掌握 setTimeout/clearTimeout 配合事件對的精確控制,並封裝為可復用插件或 Hook,是前端工程化的基本功。實際業務中務必考慮「一次性觸發」「視覺反饋」「資源清理」「移動端降級」等完整體驗閉環。