鴻蒙ArkTS聲明式開發：跨平臺支持列表【TapGesture】基礎手勢

TapGesture

支持單擊、雙擊和多次點擊事件的識別。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

接口

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

參數：

參數名稱	參數類型	必填	參數描述
count	number	否	識別的連續點擊次數。當設置的值小于1或不設置時，會被轉化為默認值。默認值：1說明：如配置多擊，上一次抬起和下一次按下的超時時間為300毫秒。
fingers	number	否	觸發點擊的手指數，最小為1指，最大為10指。當設置小于1的值或不設置時，會被轉化為默認值。默認值：1說明：1. 當配置多指時，第一根手指按下后300毫秒內未有足夠的手指數按下，手勢識別失敗。 2. 實際點擊手指數超過配置值，手勢識別成功。

事件

名稱	功能描述`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
onAction(event: (event?: [GestureEvent]) => void)	Tap手勢識別成功回調。

搜狗高速瀏覽器截圖20240326151450.png

示例

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

  build() {
    Column() {
      // 單指雙擊文本觸發手勢事件
      Text('Click twice').fontSize(28)
        .gesture(
        TapGesture({ count: 2 })
          .onAction((event?: GestureEvent) = > {
            if (event) {
              this.value = JSON.stringify(event.fingerList[0])
            }
          })
        )
      Text(this.value)
    }
    .height(200)
    .width(300)
    .padding(20)
    .border({ width: 3 })
    .margin(30)
  }
}