harmonyOS组件拥有的状态汇总

当状态变量被改变时，查询依赖该状态变量的组件；

执行依赖该状态变量的组件的更新方法，组件更新渲染；

和该状态变量不相关的组件或者UI描述不会发生重新渲染，从而实现页面渲染的按需更新。

说明

@State装饰的变量必须初始化，否则编译期会报错。
@State不支持装饰Function类型的变量，框架会抛出运行时错误。
使用a.b(this.object)形式调用，不会触发UI刷新，通过'let balloon1 = this.balloon;'传入Balloon.increaseVolume(balloon1);

@Prop装饰的变量可以和父组件建立单向的同步关系。@Prop装饰的变量是可变的，但是变化不会同步回其父组件。

@Prop变量允许在本地修改，但修改后的变化不会同步回父组件。

说明

@Prop装饰变量时会进行深拷贝，在拷贝的过程中除了基本类型、Map、Set、Date、Array外，都会丢失类型。例如PixelMap等通过NAPI提供的复杂类型，由于有部分实现在Native侧，因此无法在ArkTS侧通过深拷贝获得完整的数据。
@Prop装饰器不能在@Entry装饰的自定义组件中使用。
@Prop本地初始化不和父组件同步
@Prop嵌套场景：在嵌套场景下，每一层都要用@Observed装饰，且每一层都要被@Prop接收，这样才能观察到嵌套场景。
Prop支持联合类型实例
使用a.b(this.object)形式调用，不会触发UI刷新，通过'let score1 = this.score;'传入参数score1，Score.changeScore1(score1);

子组件中被@Link装饰的变量与其父组件中对应的数据源建立双向数据绑定。

@Link装饰的变量与其父组件中的数据源共享相同的值。

说明

@Provide装饰的状态变量自动对其所有后代组件可用，即该变量被"provide"给他的后代组件。由此可见，@Provide的方便之处在于，开发者不需要多次在组件之间传递变量。

后代通过使用@Consume去获取@Provide提供的变量，建立在@Provide和@Consume之间的双向数据同步，与@State/@Link不同的是，前者可以在多层级的父子组件之间传递。

@Provide和@Consume可以通过相同的变量名或者相同的变量别名绑定，建议类型相同，否则会发生类型隐式转换，从而导致应用行为异常。

说明

@Provider/@Consumer的参数key必须为string类型，否则编译期会报错。
在初始化@Consume变量时，如果开发者没有定义对应key的@Provide变量，框架会抛出运行时错误，提示开发者初始化@Consume变量失败，原因是无法找到其对应key的@Provide变量。
@Provide与@Consume不支持装饰Function类型的变量，框架会抛出运行时错误。
@Provide支持allowOverride参数
使用a.b(this.object)形式调用，不会触发UI刷新，需要通过赋值添加 Proxy 代理实现。

@ObjectLink和@Observed类装饰器用于在涉及嵌套对象或数组的场景中进行双向数据同步：

使用new创建被@Observed装饰的类，可以被观察到属性的变化；

子组件中@ObjectLink装饰器装饰的状态变量用于接收@Observed装饰的类的实例，和父组件中对应的状态变量建立双向数据绑定。这个实例可以是数组中的被@Observed装饰的项，或者是class object中的属性，这个属性同样也需要被@Observed装饰。

说明