1# TapGesture 2 3支持单击、双击和多次点击事件的识别。 4 5> **说明：** 6> 7> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8 9 10## 接口 11 12TapGesture(value?: { count?: number, fingers?: number }) 13 14**参数：** 15 16| 参数名称 | 参数类型 | 必填 | 参数描述 | 17| -------- | -------- | -------- | -------- | 18| count | number | 否 | 识别的连续点击次数。当设置的值小于1或不设置时，会被转化为默认值。<br/>默认值：1<br/>**说明：**<br/>如配置多击，上一次抬起和下一次按下的超时时间为300毫秒。 | 19| fingers | number | 否 | 触发点击的手指数，最小为1指， 最大为10指。当设置小于1的值或不设置时，会被转化为默认值。<br/>默认值：1<br/>**说明：**<br/>1. 当配置多指时，第一根手指按下后300毫秒内未有足够的手指数按下，手势识别失败。<br/>2. 实际点击手指数超过配置值，手势识别失败。 | 20 21 22## 事件 23 24| 名称 | 功能描述 | 25| -------- | -------- | 26| onAction(event: (event?: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | Tap手势识别成功回调。 | 27 28 29## 示例 30 31```ts 32// xxx.ets 33@Entry 34@Component 35struct TapGestureExample { 36 @State value: string = '' 37 38 build() { 39 Column() { 40 // 单指双击文本触发手势事件 41 Text('Click twice').fontSize(28) 42 .gesture( 43 TapGesture({ count: 2 }) 44 .onAction((event: GestureEvent) => { 45 this.value = JSON.stringify(event.fingerList[0]) 46 }) 47 ) 48 Text(this.value) 49 } 50 .height(200) 51 .width(300) 52 .padding(20) 53 .border({ width: 3 }) 54 .margin(30) 55 } 56} 57``` 58 59 60
