鸿蒙5.0开发进阶：UI框架-ArkTS组件（TapGesture）

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

• 鸿蒙开发焦点知识点，看这篇文章就够了
  
• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线
  
• 鸿蒙HarmonyOS NEXT开发技能最全学习路线指南
  
• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）
  

---

TapGesture

支持单击、双击和多次点击变乱的识别。
   分析
  从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
  接口

TapGesture(value?: TapGestureParameters)
元服务API： 从API version 12开始，该接口支持在元服务中使用。
体系能力： SystemCapability.ArkUI.ArkUI.Full
参数：
参数名称参数范例必填参数描述valueTapGestureParameters否点击手势的相干参数。 TapGestureParameters12+对象分析

元服务API： 从API version 12开始，该接口支持在元服务中使用。
体系能力： SystemCapability.ArkUI.ArkUI.Full
名称范例必填描述countnumber否 识别的一连点击次数。当设置的值小于1或不设置时，会被转化为默认值。
默认值：1
分析：
1. 当配置多击时，上一次的最后一根手指抬起和下一次的第一根手指按下的超时时间为300毫秒。
2. 当前次点击的位置与当前点击的位置距离凌驾60vp时，手势识别失败。在多指情况下，点击的位置为所有参与手势响应手指的平均位置。
fingersnumber否 触发点击的手指数，最小为1指， 最大为10指。当设置小于1的值或不设置时，会被转化为默认值。
默认值：1
分析：
1. 当配置多指时，第一根手指按下后300毫秒内未有足够的手指数按下，手势识别失败；手指抬起时，抬起后剩余的手指数小于阈值时开始计时，如300ms内未全部抬起则手势识别失败。
2. 现实点击手指数凌驾配置值，手势识别成功。
distanceThresholdnumber否 点击手势移动阈值。当设置的值小于便是0或不设置时，会被转化为默认值。
默认值：2^31-1
分析：
当手指的移动距离超出开发者预设的移动阈值时，点击识别失败。假如初始化为默认阈值时，手指移动凌驾组件热区范围，点击识别失败。
  变乱

名称功能描述onAction(event: (event: GestureEvent) => void) Tap手势识别成功回调。
元服务API： 从API version 11开始，该接口支持在元服务中使用。
  属性

元服务API： 从API version 11开始，该接口支持在元服务中使用。
名称范例描述tag11+string设置Tap手势标记，用于自定义手势判定时区分绑定的手势。 示例

该示例通过TapGesture实现了双击手势的识别。

1. // xxx.ets
2. @Entry
3. @Component
4. struct TapGestureExample {
5.   @State value: string = ''
7.   build() {
8.     Column() {
9.       // 单指双击文本触发手势事件
10.       Text('Click twice').fontSize(28)
11.         .gesture(
12.         TapGesture({ count: 2 })
13.           .onAction((event: GestureEvent) => {
14.             if (event) {
15.               this.value = JSON.stringify(event.fingerList[0])
16.             }
17.           })
18.         )
19.       Text(this.value)
20.     }
21.     .height(200)
22.     .width(300)
23.     .padding(20)
24.     .border({ width: 3 })
25.     .margin(30)
26.   }
27. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。