当前位置：首页 > 文章列表 > 文章 > 前端 > 移动端手势识别系统详解

移动端手势识别系统详解

2026-03-16 20:37:51 0浏览收藏

核心手势类型与识别逻辑

一个基础的手势识别系统通常需要监听 touchstart、touchmove 和 touchend 事件，并根据触摸点的变化判断用户意图。

主要识别以下几种手势：

tap（单击）：触摸时间短，位移小
double tap（双击）：两次 tap 间隔小于 300ms
swipe（滑动）：快速移动，有明确方向
long press（长按）：触摸持续超过 500ms
pinch（缩放）：双指距离变化，需多点触控支持

实现基本事件监听与状态管理

使用一个对象来保存触摸过程中的状态信息，例如起始位置、时间戳、是否已触发长按等。

示例代码结构：

let startXY = { x: 0, y: 0 };
let startTime = 0;
let isLongPressTriggered = false;
let lastTapTime = 0;
element.addEventListener('touchstart', (e) => {
if (e.touches.length === 1) {
startXY.x = e.touches[0].clientX;
startXY.y = e.touches[0].clientY;
startTime = Date.now();
// 启动长按检测
setTimeout(() => {
  if (!isMoving && !isTapConfirmed) {
    isLongPressTriggered = true;
    element.dispatchEvent(new CustomEvent('longpress'));
  }
}, 500);
}
});

区分手势并派发自定义事件

在 touchend 中判断最终手势类型，并触发对应的自定义事件，便于业务层监听。

例如：

element.addEventListener('touchend', (e) => {
  const deltaTime = Date.now() - startTime;
  const deltaX = e.changedTouches[0].clientX - startXY.x;
  const deltaY = e.changedTouches[0].clientY - startXY.y;
  const distance = Math.sqrt(deltaX ** 2 + deltaY ** 2);
// 判断是否为 tap
if (deltaTime < 300 && distance < 10) {
const now = Date.now();
if (now - lastTapTime < 300) {
element.dispatchEvent(new CustomEvent('doubletap'));
} else {
setTimeout(() => {
if (!isDoubleTapDetected) {
element.dispatchEvent(new CustomEvent('tap'));
}
}, 300);
}
lastTapTime = now;
}
// 判断 swipe
if (deltaTime < 1000 && distance > 50) {
const direction = Math.abs(deltaX) > Math.abs(deltaY) ?
(deltaX > 0 ? 'right' : 'left') :
(deltaY > 0 ? 'down' : 'up');
element.dispatchEvent(new CustomEvent('swipe', { detail: { direction } }));
}
// 重置状态
isLongPressTriggered = false;
});