openharmony 鸿蒙 arkts-decorator-overview

2026-08-25 浏览 (1)

UI装饰器总览

在声明式UI开发范式中,UI是程序状态的运行结果,状态的变化会驱动UI的刷新。ArkUI提供了一套装饰器机制,使开发者能够便捷地定义和管理状态变量,实现数据与UI的联动。

ArkUI包含的V2状态管理装饰器列表如下:

V2状态管理装饰器装饰器说明
@ComponentV2创建自定义组件。
@Local组件内部状态。
@Param组件外部输入。
@Once初始化同步一次。
@Event规范组件输出。
@Provider与后代状态双向同步。
@Consumer与祖先状态双向同步。
@Monitor状态变量修改异步监听。
@SyncMonitor状态变量修改同步监听。
@Computed计算属性。
@ObservedV2标记类可观察。
@Trace标记类属性可观察。
@Type标记类属性的类型。
@ReusableV2标记组件可复用。

ArkUI包含的V1状态管理装饰器列表如下:

V1状态管理装饰器装饰器说明
@Component创建自定义组件。
@State基础状态变量。
@Prop建立父子状态单向同步。
@Link建立父子状态双向同步。
@ObjectLink嵌套类对象属性变化观察。
@Provide与后代状态双向同步。
@Consume与祖先状态双向同步。
@Watch状态变量变化监听。
@StorageLink与AppStorage中对应的属性建立双向数据同步。
@StorageProp与AppStorage中对应的属性建立单向数据同步。
@LocalStorageLink与LocalStorage中对应的属性建立双向数据同步。
@LocalStorageProp与LocalStorage中对应的属性建立单向数据同步。
@Observed标记类可观察。
@Track类对象属性级更新。
@Reusable标记组件可复用。

ArkUI包含的通用UI装饰器列表如下:

通用装饰器装饰器说明
@Builder自定义构建函数。
@LocalBuilder维持组件关系。
@BuilderParam引用@Builder函数。
@Styles定义组件重用样式。
@Extend定义扩展组件样式。
@AnimatableExtend定义可动画属性。
@Require校验构造传参。
@Env环境变量。

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 arkts-new-makeObserved

openharmony 鸿蒙 arkts-new-param

openharmony 鸿蒙 arkts-state-management-introduce

openharmony 鸿蒙 arkts-new-persistencev2

openharmony 鸿蒙 arkts-v1-v2-migration-application

openharmony 鸿蒙 arkts-v1-v2-migration-reusable

openharmony 鸿蒙 arkts-page-custom-components-lifecycle

openharmony 鸿蒙 arkts-basic-syntax-overview

openharmony 鸿蒙 arkts-track

openharmony 鸿蒙 arkts-new-reusableV2

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/kTowu3rB