# TapGesture ## APIs TapGesture\(options?: \{ count?: number, fingers?: number \}\) - Parameters

Name

Type

Mandatory

Default Value

Description

count

number

No

1

Number of consecutive taps. If this parameter is set to a value less than 1, the default value will be used.

NOTE:

If multi-tap is configured, the timeout interval between a lift and the next tap is 300 ms.

fingers

number

No

1

Minimum number of fingers to trigger a tap. The value ranges from 1 to 10.

NOTE:

1. When multi-finger is configured, if the number of fingers used for tap does not reach the specified number within 300 ms after the first finger is tapped, the gesture fails to be recognized.

2. Gesture recognition fails if the number of fingers used for tap exceeds the configured number.
## Events

Name

Description

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

Callback invoked when a tap gesture is recognized.
## Example ``` @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' }) ) } } ``` ![](figures/tapgesture.gif)