匿名用户3D Engine
全面屏操作手势
奶油小蛋高通过 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 组合即可实现。
橙动创意有,复杂手势不要自己用触点坐标硬拼,先用 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 里重复改同一份状态。
执长剑兮
红薯味儿的栗子
匿名用户- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS 手势响应过程中弹出图层,如何继续在新的图层上进行响应 (API12+)
HarmonyOS 手势响应过程中弹出图层,如何继续在新的图层上进行响应(API12+)
HarmonyOS 应用需要支持手势操作,如捏合缩放、旋转等,在ArkUI中如何实现?(API12+)
HarmonyOS CAPI实现嵌套滚动组件,滑动存在手势问题,如何用CAPI实现(API12+)
HarmonyOS 手绘电子签名怎么实现?(API12+)
HarmonyOS 如何实现手写签名(API12+)
HarmonyOS 如何实现全局自定义弹窗(API12+)
HarmonyOS 如何实现控制APP应用全屏/横屏/竖屏 (API12+)




































苏公安网备 32011402010933号