TapGesture

About 2 min

TapGesture

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

权限列表

接口

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

  • 参数

    参数名称

    参数类型

    必填

    默认值

    参数描述

    count

    number

    1

    识别的连续点击次数。如果设置小于1,会被转化为默认值。

    说明:

    如配置多击,上一次抬起和下一次按下的超时时间为300毫秒(ms)。

    fingers

    number

    1

    触发点击的最少手指数,最小为1指, 最大为10指。

    说明:

    1. 当配置多指时,第一根手指按下后300毫秒(ms)内未有足够的手指数按下,手势识别失败。

    2. 实际点击手指数超过配置值,手势识别失败。

事件

名称

功能描述

onAction((event?: TapGestureEvent) => void)

Tap手势识别成功回调。

  • TapGestureEvent类型说明8+

    继承自GestureEvent类型。

示例

@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'
        })
    )
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19