鸿蒙NEXT开发:ArkTS组件-通用属性(动态手势设置)

 往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


动态手势设置

动态设置组件绑定的手势,支持开发者在属性设置时使用if/else语法。

说明

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

gestureModifier

gestureModifier(modifier: GestureModifier)

动态设置组件绑定的手势。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
modifierGestureModifier

在当前组件上,动态设置组件绑定的手势,支持使用if/else语法。

modifier: 手势修改器,开发者需要自定义class实现GestureModifier接口。

GestureModifier

开发者需要自定义class实现GestureModifier接口。

applyGesture

applyGesture(event: UIGestureEvent): void

组件需要绑定的手势。

开发者可根据需要自定义实现这个方法,对组件设置需要绑定的手势,支持使用if/else语法进行动态设置。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

参数

参数名类型说明
eventUIGestureEventUIGestureEvent对象,用于设置组件需要绑定的手势。

示例

该示例通过gestureModifier动态设置组件绑定的手势。

// xxx.ets
class MyButtonModifier implements GestureModifier {
  supportDoubleTap: boolean = true

  applyGesture(event: UIGestureEvent): void {
    if (this.supportDoubleTap) {
      event.addGesture(
        new TapGestureHandler({ count: 2, fingers: 1 })
          .tag("aaa")
          .onAction((event: GestureEvent) => {
            console.log("button tap ")
          })
      )
    } else {
      event.addGesture(
        new PanGestureHandler()
          .onActionStart(()=>{
            console.log("Pan start");
          })
      )
    }
  }
}

@Entry
@Component
struct Index {
  @State modifier: MyButtonModifier = new MyButtonModifier()

  build() {
    Row() {
      Column() {
        Column()
          .gestureModifier(this.modifier)
          .width(500)
          .height(500)
          .backgroundColor(Color.Blue)
      }
      .width('100%')
    }
    .height('100%')
  }
}

### 鸿蒙原生应用开发 ArkTS 快速入门教程 #### 了解 ArkTS 编程语言 ArkTS 是一种专门为鸿蒙操作系统设计的编程语言,旨在简化应用程序开发过程并提高效率。该语言融合了许多现代编程特性,使得开发者能够更轻松地构建高性能的应用程序[^2]。 #### 设置开发环境 为了开始使用 ArkTS 进行开发,首先需要安装合适的 IDE 和工具链。推荐使用的集成开发环境是 DevEco Studio,它提供了完整的项目创建向导和支持 ArkTS 的插件。通过访问官方网站下载最新版本,并按照说明完成设置。 #### 创建第一个 ArkTS 应用程序 一旦开发环境准备好之后就可以着手建立首个基于 ArkTS 构建的小型 demo app 来熟悉其语法结构: 1. 打开 DevEco Studio 并新建一个 HarmonyOS 工程; 2. 在工程配置阶段选择支持 TypeScript 或 JavaScript 类型的语言选项; 3. 添加必要的依赖库来增强功能实现; 下面是一个简单的 "Hello World!" 实现例子: ```typescript // HelloWorld.ts 文件内容如下所示 import { Text, Column } from '@ohos/arkui'; export default function App() { return ( <Column> <Text>Hello World!</Text> </Column> ); } ``` 这段代码定义了一个名为 `App` 的组件,在其中包含了用于显示文本消息 `<Text>` 组件以及布局容器 `<Column>` 。当运行此应用程序时将会看到屏幕上呈现 “Hello World!” 字样[^5]。 #### 学习更多高级特性和最佳实践 随着对基础概念掌握程度加深后还可以进一步探索诸如状态管理、路由导航等方面的知识点。此外,《鸿蒙之光HarmonyOS NEXT原生应用开发入门》这本书籍和技术文档也是很好的参考资料之一,书中不仅介绍了理论知识还涵盖了大量实际案例分析帮助读者更好地理解如何运用这些技巧到具体场景当中去[^4]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值