开发画板、图片标注这类交互时,经常遇到长按、拖拽、双指缩放互相冲突。直接用内置 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。适合标注、白板、自定义播放器进度条这类对时序要求精细的交互。








































苏公安网备 32011402010933号