萬盛學電腦網

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

jQuery 滑鼠停止移動事件偵測:防抖動實作與應用場景

應用場景

  • 編輯器自動儲存:使用者停止輸入 N 秒後自動存檔
  • 搜尋建議:停止輸入後發送 AJAX 查詢
  • 懸停工具列:滑鼠停留在區域顯示工具列,移開隱藏
  • 遊戲/繪圖:滑鼠靜止觸發狙擊鏡、筆刷預覽

核心實作原理

監聽 mousemove 記錄最新座標,啟動定時器定期比較「上次座標」與「當前座標」,若相同則判定為「停止移動」。

jQuery 插件封裝版

(function($) {
    $.fn.moveStopEvent = function(callback, options) {
        var opts = $.extend({
            interval: 100,      // 檢查間隔 (ms)
            sensitivity: 0      // 像素容差 (0=完全靜止)
        }, options);
        
        return this.each(function() {
            var $el = $(this);
            var lastX = 0, lastY = 0;
            var currentX = 0, currentY = 0;
            var timer = null;
            var isTracking = false;
            
            function checkStop() {
                var dx = Math.abs(currentX - lastX);
                var dy = Math.abs(currentY - lastY);
                
                if (dx <= opts.sensitivity && dy <= opts.sensitivity) {
                    // 停止移動
                    clearInterval(timer);
                    timer = null;
                    isTracking = false;
                    callback.call(this, { x: currentX, y: currentY });
                } else {
                    // 仍在移動,更新基準座標
                    lastX = currentX;
                    lastY = currentY;
                }
            }
            
            $el.on('mousemove', function(e) {
                currentX = e.pageX;
                currentY = e.pageY;
                
                if (!isTracking) {
                    isTracking = true;
                    lastX = currentX;
                    lastY = currentY;
                    timer = setInterval(checkStop.bind(this), opts.interval);
                }
            }).on('mouseleave', function() {
                // 滑鼠離開元素區域也視為停止
                if (isTracking) {
                    clearInterval(timer);
                    timer = null;
                    isTracking = false;
                    callback.call(this, { x: currentX, y: currentY, left: true });
                }
            });
        });
    };
})(jQuery);

使用範例

<div id="canvas" style="width:400px;height:300px;background:#f0f0f0;border:1px solid #ccc">
    在此區域移動滑鼠,停止 1 秒後會彈出座標
</div>

<script>
$('#canvas').moveStopEvent(function(info) {
    if (info.left) {
        console.log('滑鼠離開區域', info);
    } else {
        console.log('滑鼠停止於', info.x, info.y);
        // 這裡可觸發自動儲存、顯示工具提示等
    }
}, { interval: 200, sensitivity: 2 }); // 200ms 檢查一次,允許 2px 抖動
</script>

原生 JS 實現(無依賴、效能更好)


function onMouseStop(element, callback, options) {
    var opts = Object.assign({ interval: 100, sensitivity: 0 }, options);
    var lastX = 0, lastY = 0, curX = 0, curY = 0;
    var timer = null, tracking = false;
    
    function check() {
        if (Math.abs(curX - lastX) <= opts.sensitivity && 
            Math.abs(curY - lastY) <= opts.sensitivity) {
            clearInterval(timer);
            timer = null;
            tracking = false;
            callback({ x: curX, y: curY });
        } else {
            lastX = curX;
            lastY = curY;
        }
    }
    
    element.addEventListener('mousemove', function(e) {
        curX = e.clientX;
        curY = e.clientY;
        if (!tracking) {
            tracking = true;
            lastX = curX;
            lastY = curY;
            timer = setInterval(check, opts.interval);
        }
    });
    
    element.addEventListener('mouseleave', function() {
        if (tracking) {
            clearInterval(timer);
            timer = null;
            tracking = false;
            callback({ x: curX, y: curY, left: true });
        }
    });
    
    // 返回清理函式
    return function destroy() {
        clearInterval(timer);
        element.removeEventListener('mousemove', arguments.callee);
        element.removeEventListener('mouseleave', arguments.callee);
    };
}

// 使用
var destroy = onMouseStop(document.getElementById('canvas'), function(info) {
    console.log('停止:', info);
});

// 銷毀時調用 destroy()

進階:requestAnimationFrame 版本(高頻檢測、低功耗)


function onMouseStopRAF(element, callback, timeout = 1000) {
    var lastX = 0, lastY = 0;
    var stopTimer = null;
    var rafId = null;
    
    function loop() {
        // 這裡可以做更精細的速度/加速度計算
        rafId = requestAnimationFrame(loop);
    }
    
    element.addEventListener('mousemove', function(e) {
        lastX = e.clientX;
        lastY = e.clientY;
        
        clearTimeout(stopTimer);
        stopTimer = setTimeout(function() {
            cancelAnimationFrame(rafId);
            callback({ x: lastX, y: lastY });
        }, timeout);
    });
    
    element.addEventListener('mouseleave', function() {
        clearTimeout(stopTimer);
        cancelAnimationFrame(rafId);
        callback({ x: lastX, y: lastY, left: true });
    });
}

效能比較與選擇建議

方案CPU 佔用精確度適用場景
setInterval (100-500ms)低~間隔誤差一般 UI 互動、自動儲存
requestAnimationFrame中 (僅移動時)幀級 (16ms)遊戲、繪圖、精密追蹤
Pointer Events + IdleCallback極低系統級現代瀏覽器、低功耗需求
copyright © 萬盛學電腦網 all rights reserved