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