当前位置：首页 > article >正文

harmonyOS组件拥有的状态汇总

article 2024/12/22 15:59:47

当状态变量被改变时，查询依赖该状态变量的组件；
执行依赖该状态变量的组件的更新方法，组件更新渲染；
和该状态变量不相关的组件或者UI描述不会发生重新渲染，从而实现页面渲染的按需更新。

说明

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

网址：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-state-V5

@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);

网址：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-prop-V5

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

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

说明

网址：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-link-V5

@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 代理实现。

网址：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-provide-and-consume-V5