鸿蒙HarmonyOS应用开发-装饰器总结

一、概述

状态管理机制：声明式UI编程框架中，UI是程序状态的运行结果，用户构建了一个UI模型，其中应用的运行时的状态是参数。当参数改变时，UI作为返回结果，也将进行对应的改变。这些运行时的状态变化所带来的UI的重新渲染

常用的装饰器有@Prop、@Link、@Provide、@Observed 和 @ObjectLink 装饰器

二、各个状态变量的作用

1. @Prop 装饰器

@Prop 装饰器用于定义组件的属性，并确保组件属性的类型与数据源类型相匹配。通过 @Prop 装饰的变量会进行深拷贝，这意味着即使装饰的数据发生改变，也不会影响到父组件的数据。常见问题包括装饰状态变量未初始化错误。

2. @Link 装饰器

@Link 装饰器用于实现父子组件之间的双向数据同步。被 @Link 装饰的变量与父组件对应数据建立双向绑定，确保数据的同步更新。然而，@Link 装饰器不能在 @Entry 装饰的自定义组件中使用，并且禁止本地初始化。

3. @Provide 和 @Consume 装饰器

@Provide 和 @Consume 装饰器用于实现与后代组件之间的双向数据同步。它们可以跨组件传输数据，并确保数据的双向同步。必须注意的是，@Provide 和 @Consume 装饰的变量的类型必须相同。

4. @Observed 和 @ObjectLink 装饰器

@Observed 装饰器用于观察深层次变量的变化，而 @ObjectLink 装饰器用于嵌套类对象属性的变化。@Observed 装饰的类实例会被代理对象包装，从而实现属性的更新通知。然而，需要注意的是，使用 @Observed 装饰类会改变其原始的原型链，可能会带来一些问题。

三、状态变量引起父子组件刷新问题的总结

 

装饰器	使用场景	子组件数据	父组件的数据修改	子组件UI	父组件UI
@State	组件内部的状态				1. 简单类型数据-会 2. 复杂数据类型-第一层会
@Prop	父组件传递给子组件 子组件不需要修改数据	改变	不会	子组件修改-简单数据类型	不会
@Observed 和 @ObjectLink	子组件同步修改父组件的数据-改变	改变	会	会	父组件不会
@Link	子组件同步修改父组件的数据-简单	改变	改变	会	会
@Provide @Consume	祖宗后代组件之间数据同步 - 简单	改变	改变	会	会

每个装饰器的特点、限制条件、框架行为以及常见问题

 

装饰器	特点	限制条件	框架行为	常见问题
@Prop	必须指定类型- 进行深拷贝- 不影响父组件数据	初始化时类型需与数据源相同- 装饰的数据发生改变不影响父组件数据	初始化时进行深拷贝- 数据发生改变时不影响父组件数据	装饰状态变量未初始化错误
@Link	父子双向同步- 数据与父组件建立双向数据绑定	不能在@Entry装饰的自定义组件中使用- 禁止本地初始化	装饰的变量与父组件共享生命周期 父组件build()函数执行后创建子组件的新实例- 父组件中状态变量更新引起相关子组件的更新 子组件中@Link更新后同步回父组件@State，触发UI更新	装饰状态变量类型错误
@Provide	与后代组件双向同步- 跨组件传输	必须指定类型- @Provide变量与@Consume变量的类型必须相同	双向数据同步- 可以通过相同变量名或别名绑定	@BuilderParam尾随闭包情况下@Provide未定义错误
@Observed	观察深层次变量的变化	使用@Observed装饰class会改变class原始的原型链@Observed和其他类装饰器装饰同一个class可能会带来问题- 不能在@Entry装饰的自定义组件中使用	初始渲染时会被代理对象包装，代理了class上的属性的setter和getter方法 子组件中@ObjectLink装饰的从父组件初始化，接收被@Observed装饰的class的实例- 属性更新时，通知依赖它的@ObjectLink包装类数据更新	在子组件中给@ObjectLink装饰的变量赋值 基础嵌套对象属性更改失效 在@Observed装饰类的构造函数中延时更改成员变量