ArkTS状态管理装饰器V1版本（@State、@Prop、@Link、@ObjectLink、@Provide、@Consume、@StorageProp、@StorageLink等）

YF-SOD

已于 2025-04-09 11:03:10 修改

阅读量988

点赞数 14

分类专栏：鸿蒙ArkUI学习文章标签： arktsV1版本装饰器 arkts装饰器学习 arkts组件状态管理鸿蒙自定义组件状态传递 arkts状态管理装饰器V1

于 2025-03-27 21:56:08 首次发布

本文链接：https://blog.youkuaiyun.com/AIWWY/article/details/146571620

版权

ArkTS状态管理装饰器V1

组件定义

@Component

freezeWhenInactive11+

a.b(this.object)形式调用，不会触发UI刷新

@Observed、@ObjectLink

Observed、ObjectLink示例

ArkTS状态管理装饰器V1

arkts早期提供给开发者使用的状态管理装饰器，对于嵌套类的观测存在诸多限制。在API12中为开发者提供了一套全新的状态管理V2（简称V2）。官方是希望后续用V2版本的装饰器取代V1的装饰器。实际上目前大部分的开发代码仍使用的是V1版本的装饰器。

装饰器类别	装饰器
组件内装饰器	@State、@Prop、@Link、@ObjectLink、@Provide、@Consume、@StorageProp、@StorageLink、@LocalStorageProp、@LocalStorageLink、@Watch
类相关装饰器	@Observed、@Track

组件定义

@Component

@Component装饰器仅能装饰struct关键字声明的数据结构。struct被@Component装饰后具备组件化的能力，需要实现build方法描述UI，一个struct只能被一个@Component装饰。@Component可以接受一个可选的bool类型参数，用来冻结自定义组件（冻结的组件不会随@state变量更新变化UI）。

freezeWhenInactive11+

组件冻结选项。

名称	类型	必填	说明
freezeWhenInactive	bool	否	是否开启组件冻结。

@Component({ freezeWhenInactive: true })
struct MyComponent {
}

@Entry（通用）

修饰@Component定义的自定义组件，将其作为入口组件。

入口组件：可以作为页面路由单独显示的，可以理解为一个完整的页面，无@Entry修饰的自定义组件只是部分页面，应用只能显示完整的页面，可以通过windowStage.loadContent方法决定挂载哪一个完整页面。

@Entry可以接受一个可选的LocalStorage的参数或者一个可选的EntryOptions参数。入参见

EntryOptions10+

命名路由跳转选项。

名称	类型	必填	说明
routeName	string	否	表示作为命名路由页面的名字。
storage	LocalStorage	否	页面级的UI状态存储。
useSharedStorage12+	boolean	否	是否使用LocalStorage.getShared()接口返回的LocalStorage实例对象，默认值false。

说明

当useSharedStorage设置为true，并且storage也被赋值时，useSharedStorage的值优先级更高。

@Entry({ routeName : 'myPage' })
@Component
struct MyComponent {
}

Component、Entry示例

@Entry
@Component
struct Index {
  @State message: string = 'Hello World';
  build() {
    RelativeContainer() {
      Text(this.message)
        .id('HelloWorld')
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
    }
    .height('100%')
    .width('100%')
  }
}