在網頁互動開發中,精確偵測滑鼠移動方向是實現許多進階效果的基礎,例如:自訂游標、拖曳排序視覺回饋、遊戲角色控制、以及基於手勢的導航選單。本文將深入解析如何使用原生 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}`);
// 這裡可接入:游標樣式切換、拖曳預覽、遊戲輸入等
});
結合水平與垂直方向,可得到 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];
}
搭配 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 物件),方便在專案中多處調用與維護。