描述:支持单次点击、多次点击识别。
Api:从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手势识别成功回调。 |
示例代码:
@Entry
@Component
struct Index {
@State value: string = '';
build() {
Column() {
// 单指双击文本触发手势事件
Text('Click twice').fontSize(28).margin({ top: 40 })
.gesture(
TapGesture({ count: 2 })
.onAction((event: GestureEvent) => {
this.value = JSON.stringify(event.fingerList[0]);
})
)
Column(){
Text(this.value).fontSize(20)
}
.height(300)
.width(300)
.padding(20)
.border({ width: 3 })
.margin(30)
}
}
}复制
示例效果:
代码地址:
https://gitee.com/jltfcloudcn/jump_to/tree/master/TapGesture