鴻蒙ArkTS聲明式開(kāi)發(fā)：跨平臺(tái)支持列表【TapGesture】基礎(chǔ)手勢(shì)

TapGesture

支持單擊、雙擊和多次點(diǎn)擊事件的識(shí)別。

說(shuō)明：
開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 7開(kāi)始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

接口

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

參數(shù)：

參數(shù)名稱	參數(shù)類型	必填	參數(shù)描述
count	number	否	識(shí)別的連續(xù)點(diǎn)擊次數(shù)。當(dāng)設(shè)置的值小于1或不設(shè)置時(shí)，會(huì)被轉(zhuǎn)化為默認(rèn)值。默認(rèn)值：1說(shuō)明：如配置多擊，上一次抬起和下一次按下的超時(shí)時(shí)間為300毫秒。
fingers	number	否	觸發(fā)點(diǎn)擊的手指數(shù)，最小為1指，最大為10指。當(dāng)設(shè)置小于1的值或不設(shè)置時(shí)，會(huì)被轉(zhuǎn)化為默認(rèn)值。默認(rèn)值：1說(shuō)明：1. 當(dāng)配置多指時(shí)，第一根手指按下后300毫秒內(nèi)未有足夠的手指數(shù)按下，手勢(shì)識(shí)別失敗。 2. 實(shí)際點(diǎn)擊手指數(shù)超過(guò)配置值，手勢(shì)識(shí)別成功。

事件

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

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

示例

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

  build() {
    Column() {
      // 單指雙擊文本觸發(fā)手勢(shì)事件
      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)
  }
}

zh-cn_image_0000001174422900

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫(xiě)或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴