TapGesture

说明： 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

接口

TapGesture(value?: { count?: number, fingers?: number })

参数：

参数名称	参数类型	必填	参数描述
count	number	否	识别的连续点击次数。如果设置小于1，会被转化为默认值。 默认值：1 >  说明： > 如配置多击，上一次抬起和下一次按下的超时时间为300毫秒（ms）。
fingers	number	否	触发点击的最少手指数，最小为1指， 最大为10指。 默认值：1 >  说明： > 1. 当配置多指时，第一根手指按下后300毫秒（ms）内未有足够的手指数按下，手势识别失败。 > 2. 实际点击手指数超过配置值，手势识别失败。

事件

名称	功能描述
onAction(event: (event?: GestureEvent) => void)	Tap手势识别成功回调。

示例

// xxx.ets
@Entry
@Component
struct TapGestureExample {
  @State value: string = '';

  build() {
    Column() {
      // 单指双击文本触发手势事件
      Text('Click twice').fontSize(28)
        .gesture(
        TapGesture({ count: 2 })
          .onAction((event: GestureEvent) => {
            this.value = JSON.stringify(event.fingerList[0]);
          })
        )
      Text(this.value)
    }
    .height(200)
    .width(300)
    .padding(20)
    .border({ width: 3 })
    .margin(30)
  }
}