萬盛學電腦網

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

JavaScript 滑鼠移動方向偵測完整指南

前言

在網頁互動開發中,精確偵測滑鼠移動方向是實現許多進階效果的基礎,例如:自訂游標、拖曳排序視覺回饋、遊戲角色控制、以及基於手勢的導航選單。本文將深入解析如何使用原生 JavaScript 實現高效能、跨瀏覽器相容的滑鼠方向偵測。

核心邏輯:座標比對法

偵測方向的基本原理極為直觀:記錄上一幀與當前幀的滑鼠座標,透過差值運算判斷水平與垂直方向。

關鍵變數定義

let prevX = 0, prevY = 0; // 上一幀座標
let currX = 0, currY = 0; // 當前幀座標

方向判斷函式

function getMouseDirection(e) {
    // 更新座標:先保存舊值,再讀取新值
    prevX = currX;
    prevY = currY;
    currX = e.clientX;
    currY = e.clientY;

    // 計算位移量
    const deltaX = currX - prevX;
    const deltaY = currY - prevY;

    // 判斷水平方向
    let horizontal = 'none';
    if (deltaX > 0) horizontal = 'right';
    else if (deltaX < 0) horizontal = 'left';

    // 判斷垂直方向
    let vertical = 'none';
    if (deltaY > 0) vertical = 'down';
    else if (deltaY < 0) vertical = 'up';

    return { horizontal, vertical, deltaX, deltaY };
}

完整實作範例

以下程式碼展示如何整合到實際專案中,包含效能優化與邊界處理:

// 狀態管理物件
const mouseTracker = {
    prev: { x: 0, y: 0 },
    curr: { x: 0, y: 0 },
    direction: { h: 'none', v: 'none' },
    threshold: 1 // 忽略微小抖動(像素)
};

// 初始化
function initMouseTracking() {
    document.addEventListener('mousemove', handleMouseMove, { passive: true });
}

// 事件處理器
function handleMouseMove(e) {
    // 更新座標
    mouseTracker.prev.x = mouseTracker.curr.x;
    mouseTracker.prev.y = mouseTracker.curr.y;
    mouseTracker.curr.x = e.clientX;
    mouseTracker.curr.y = e.clientY;

    // 計算方向
    const dx = mouseTracker.curr.x - mouseTracker.prev.x;
    const dy = mouseTracker.curr.y - mouseTracker.prev.y;

    // 應用閾值過濾噪訊
    mouseTracker.direction.h = Math.abs(dx) > mouseTracker.threshold 
        ? (dx > 0 ? 'right' : 'left') : 'none';
    mouseTracker.direction.v = Math.abs(dy) > mouseTracker.threshold 
        ? (dy > 0 ? 'down' : 'up') : 'none';

    // 觸發自訂事件供其他模組訂閱
    document.dispatchEvent(new CustomEvent('mousedirection', {
        detail: { ...mouseTracker.direction, dx, dy }
    }));
}

// 使用範例:訂閱方向變化
document.addEventListener('mousedirection', (e) => {
    console.log(`水平: ${e.detail.h}, 垂直: ${e.detail.v}`);
    // 這裡可接入:游標樣式切換、拖曳預覽、遊戲輸入等
});

進階應用場景

1. 八方向精確判斷

結合水平與垂直方向,可得到 8 種主要方向:

function get8Direction(dx, dy) {
    if (dx === 0 && dy === 0) return 'center';
    
    const angle = Math.atan2(dy, dx) * 180 / Math.PI;
    const directions = ['right', 'down-right', 'down', 'down-left', 
                       'left', 'up-left', 'up', 'up-right'];
    const index = Math.round(((angle + 180) % 360) / 45) % 8;
    return directions[index];
}

2. 速度與加速度計算

搭配 performance.now() 可進一步獲得移動速度:

let lastTime = performance.now();

function handleMouseMove(e) {
    const now = performance.now();
    const dt = now - lastTime; // 毫秒
    lastTime = now;
    
    const speedX = dx / dt * 1000; // 像素/秒
    const speedY = dy / dt * 1000;
    // 可用於慣性動畫、拋擲效果等
}

效能優化建議

  • 使用 passive: true:告訴瀏覽器事件處理器不會呼叫 preventDefault(),允許瀏覽器優化滾動效能。
  • 節流處理:高頻 mousemove 事件可搭配 requestAnimationFrame 或 setTimeout 節流。
  • 避免佈局抖動:在事件處理器中避免讀寫互相交替導致強制同步佈局。

瀏覽器相容性

本方案使用標準 MouseEvent 介面 (clientX/clientY),支援所有現代瀏覽器 (Chrome 1+, Firefox 1+, Safari 1+, Edge 12+, IE 9+)。IE 8 及以下需使用 attachEvent 並透過 event.clientX 取得座標。

總結

滑鼠方向偵測雖然概念簡單,但善用閾值過濾、自訂事件解耦、以及結合時間資訊計算速度,能構建出流暢、專業的互動體驗。建議將核心邏輯封裝為可複用的模組 (如上方 mouseTracker 物件),方便在專案中多處調用與維護。

copyright © 萬盛學電腦網 all rights reserved