文档开发者中心
我的

ArkUI 自定义手势判定:用 GestureRecognizer 拆分识别时序,解决多手势抢焦点据

浏览1发布于31 分钟前广东

开发画板、图片标注这类交互时,经常遇到长按、拖拽、双指缩放互相冲突。直接用内置 Gesture 组合,识别优先级是固定的,有时候明明想拖拽,组件先触发长按弹窗,或者缩放和拖拽同时生效,手势识别乱掉。 内置手势的识别等待时长、失败判定是封装好的,很难精细控制。GestureRecognizer 可以自己接管触摸事件的时序,自己写判定逻辑,什么时候判定成功、什么时候失败、什么时候让位给别的手势,全部自己掌控。

收起
自动换行
深色代码主题
复制
import { GestureRecognizer, GestureInfo, GestureResult } from '@kit.ArkUI'

class CustomDragRecognizer extends GestureRecognizer {
  private startX: number = 0
  private startY: number = 0
  private readonly threshold = 12

  onRecognizeStart(info: GestureInfo): GestureResult {
    this.startX = info.localX
    this.startY = info.localY
    return GestureResult.RUNNING
  }

  onRecognizeUpdate(info: GestureInfo): GestureResult {
    const dx = Math.abs(info.localX - this.startX)
    const dy = Math.abs(info.localY - this.startY)
    // 移动超过阈值,判定拖拽成功,抢占手势
    if (dx > this.threshold || dy > this.threshold) {
      return GestureResult.SUCCESS
    }
    return GestureResult.RUNNING
  }

  onRecognizeEnd(): GestureResult {
    return GestureResult.FAIL
  }

  onRecognizeCancel(): void {
    console.info('拖拽识别被取消')
  }
}

@Entry
@Component
struct DrawBoardPage {
  private dragRecognizer: CustomDragRecognizer = new CustomDragRecognizer()

  build() {
    Column()
      .width('100%')
      .height('100%')
      .gesture(this.dragRecognizer)
  }
}

这里的核心区别,和 TapGesture、LongPressGesture 不一样:你可以在识别中途主动返回 FAIL,主动让位给上层或者同层别的识别器。比如画板场景,手指先按住不动,等待一段时间,才判定长按;一旦手指先滑动,直接判定拖拽成功,长按识别直接取消。

有一个坑:GestureRecognizer 运行在 UI 主线程,识别回调里面不要放耗时计算;如果需要同时监听多个识别器,要理解手势竞争规则,同一个触摸流,先返回 SUCCESS 的识别器拿到控制权,其余全部走 cancel。适合标注、白板、自定义播放器进度条这类对时序要求精细的交互。

收藏
0
回复
0
分享
全部评论
暂无评论
暂无评论
写评论
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。
发表
我要写文章
了解社区公约,与您携手共创和谐专业的开发者社区。