组合手势

介绍

本示例为组合手势的配套示例工程。

本示例展示了适配组合手势的组件及触发方式。

效果预览

首页	顺序识别
并行识别	互斥识别

使用说明

1. 模式选择按场景匹配:
   需同时触发（如缩放 + 旋转）→ 用 Parallel；
   需先后触发（如长按后拖动）→ 用 Serial；
   二选一触发（如点击 / 长按）→ 用 Exclusive，避免模式错用导致手势失效。
2. 优先级配置规则：
   priority数值无上限，建议按业务设 1-3 级（避免过度叠加）；
   同一 GestureGroup 内，优先级高的手势先被判断，优先触发。
3. 使用约束：
   禁止在 Serial 模式下包裹无依赖的手势（如点击 + 滑动），会导致后一个手势无法触发；
   组件需设enabled:true（禁用状态下手势不响应）。

工程目录

entry/src/main/ets/
└── pages
    └── Index.ets (获取文本界面)
    └── Exclusive.ets          //  互斥识别页面
    └── Parallel.ets           //  并行识别页面
    └── SceneExample.ets       //  场景示例页面
    └── Sequence.ets           //  顺序识别页面

具体实现

1. GestureGroup 基础搭建：通过GestureGroup(模式)创建容器，包裹多个手势实例，再用组件.gesture()绑定，实现多手势统一管理。
2. 三种组合模式实现：
   并行（Parallel）：包裹无冲突手势（如捏合 + 旋转），可同时触发，各自回调独立执行（如捏合改缩放比例、旋转改角度）。
   顺序（Serial）：包裹有依赖的手势（如长按 + 滑动），需先触发前一个（长按满足 duration），再触发后一个（滑动），前一个未触发则后一个无效。
   互斥（Exclusive）：包裹互斥手势（如点击 + 长按），系统优先识别高优先级手势，未识别则尝试下一个（如长按优先级高，先判断长按，不满足再判断点击）。
3. 优先级与冲突控制：
   手势优先级：给手势设priority（默认 0，值越大优先级越高），如LongPressGesture({priority:1})比TapGesture({priority:0})优先被识别。
   父子组件冲突：父组件用gestureMask控制透传（如GestureMask.IgnoreInternal，父手势不响应子组件区域操作）。

相关权限

不涉及

依赖

不涉及

约束与限制

1. 本示例仅支持标准系统上运行, 支持设备：华为手机。

2. HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。

3. DevEco Studio版本：6.0.0 Release及以上。

4. HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo ArkUISample/GestureGroup > .git/info/sparse-checkout
git remote add origin https://gitcode.com/harmonyos_samples/guide-snippets.git
git pull origin master