萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 實現鼠標停留指定區域 N 秒後自動觸發動作

核心模式:setTimeout + clearTimeout 狀態機

本質是「進入區域啟動定時器,離開區域取消定時器,超時執行回調」。適用於:延遲展開下拉菜單、懸停預加載、防誤觸發確認、自動播放視頻等場景。

基礎版(單區域、單動作)

<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();

CSS 配合:視覺反饋進度條

.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/Vue 中的 Hooks 實現

// 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,是前端工程化的基本功。實際業務中務必考慮「一次性觸發」「視覺反饋」「資源清理」「移動端降級」等完整體驗閉環。

copyright © 萬盛學電腦網 all rights reserved