文档开发者中心
我的
|

3D Engine

全面屏操作手势

软件开发中有没有对应的手势接口实现复杂的自定义手势。
点赞
收藏
回复
5
分享
举报
浏览115 发布于2026-08-21 02:11河南
全部评论
最多点赞
最新发布
最早发布
一、组合手势 GestureGroup(实现复杂手势的核心)

通过 GestureGroup(mode: GestureMode, gesture: GestureType[]) 将多种单一手势组合,支持三种识别模式:

- 顺序识别(GestureMode.Sequence):按注册顺序依次识别,直至所有手势识别成功,适合"长按后拖拽"等复合操作

- 并行识别(GestureMode.Parallel):组内手势同时识别、互不影响

- 互斥识别(GestureMode.Exclusive):一旦一个手势识别成功,其他手势识别失败,适合"单击与双击并存"场景

二、手势优先级与冲突处理

复杂场景(如列表项既要点击进详情、又要滑动删除、还要长按弹菜单)可用以下机制:

- parallelGesture() / priorityGesture() 修饰符:分别声明并行绑定与优先级绑定,控制组件内多手势的竞争关系

- GestureMask 手势屏蔽、GesturePriority 手势优先级、手势组合模式

- 触摸热区设置、hitTestBehavior 触摸测试控制:精细控制父子组件间的事件分发

三、深度自定义能力(进阶)

1. onGestureJudgeBegin 手势拦截 + 动态手势设置(API 12+):可在运行时动态修改 GestureGroup 内的手势

2. onTouch 底层触摸事件:所有手势均由 Down/Move/Up/Cancel 触摸事件组成,可直接在触摸事件层实现完全自定义的识别判决逻辑

3. 自定义识别器思路:基于手势识别状态机 + 自定义判决策略 + 触控点数据处理,配合手势事件流驱动 Animator 实现跟手动画

四、注意事项

系统级全面屏导航手势(如边缘上滑返回、底部上滑回桌面)为系统行为,由系统占用,应用无法拦截或替换;应用内的复杂手势交互(包括边缘滑出面板、跟手拖拽等效果)可通过上述基础手势 + GestureGroup 组合 + 优先级控制体系实现。若应用手势与系统导航手势在手势热区上冲突,可通过触摸热区设置规避。

五、参考文档

- 组合手势(GestureGroup):https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-gesture-events-combined-gestures

- 手势事件冲突最佳实践:https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-gestures-practice

- ArkUI 手势事件介绍(博客):https://developer.huawei.com/consumer/cn/blog/topic/03221311730782011

- onGestureJudgeBegin 动态手势设置(论坛):https://developer.huawei.com/consumer/cn/forum/topic/0204218802612522314?fid=0109140870620153026

总结:ArkUI 的手势体系是"基础手势 → 组合手势(Sequence/Parallel/Exclusive)→ 优先级/屏蔽控制 → onTouch 底层事件"的分层设计,绝大多数复杂自定义手势用 GestureGroup 组合即可实现。

展开全部
5楼回复于2026-08-21 06:15 来自广东

有,复杂手势不要自己用触点坐标硬拼,先用 GestureGroup 组合系统手势:长按后再拖动这类场景用并行组合;单击和双击二选一则用互斥组合。下面是“长按解锁拖动”的最小写法:

收起
自动换行
深色代码主题
复制
Image($r('app.media.icon'))
  .gesture(
    GestureGroup(GestureMode.Parallel,
      LongPressGesture().onAction(() => { this.dragEnabled = true }),
      PanGesture().onActionUpdate((event) => {
        if (this.dragEnabled) this.offsetX += event.offsetX
      })
    )
  )

父子组件抢手势时,再按需求改成 priorityGesture 或 parallelGesture;先确定是同时触发、按顺序触发还是互斥,别在多个 onTouch 里重复改同一份状态。

 

4楼回复于2026-08-21 02:59 来自四川
支持一下
3楼回复于2026-08-21 02:56 来自山东
可以吧
2楼回复于2026-08-21 02:42 来自河北
1楼回复于2026-08-21 02:24 来自湖北
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。