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() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.SpaceBetween }) {
      Text('Click twice')
      Text(this.value)
    }
    .height(200).width(300).padding(60).border({ width: 1 }).margin(30)
    .gesture(
      TapGesture({ count: 2 })
        .onAction(() => {
          this.value = 'TapGesture onAction'
        })
    )
  }
}

zh-cn_image_0000001174422900