目录

如何实现组件数据双向同步

问题现象

开发者经常遇到需要实现各种场景下组件数据的双向绑定与同步的功能,如系统组件内部状态和状态变量之间、父子组件之间、兄弟组件之间、多层嵌套组件之间等,如何选择合适的方案?

背景知识

ArkUI状态管理有两个版本:状态管理(V1)和状态管理(V2)。

解决方案

对于如何实现各种场景下组件数据的双向绑定与同步,总结如下:

场景

状态管理V1

状态管理V2

对比

场景一:系统组件的内部状态和状态变量的双向同步。

$$语法

!!语法

$$语法仅用于系统组件的双向同步,而!!语法除了实现系统组件的双向同步,还可以实现自定义组件之间的双向绑定,适用范围较大,并且!!语法属于状态管理V2,会在将来得到更多的支持与优化。

场景二:父子组件建立双向数据同步。

@Link

@Param和@Event

@Link实现父子组件双向数据绑定简单直接,子组件可直接修改父组件状态,但状态变量不能独立于UI存在。而@Param和@Event关联的状态变量独立于UI,更改数据会触发相应视图的更新。

场景三:跨多层级组件时数据的双向同步。

@Provide和@Consume

@Provider和@Consumer

参考官网@Provider和@Consumer vs @Provide和@Consume能力对比。

场景四:多层嵌套场景下的数据双向同步。

@Observed和@ObjectLink

@ObservedV2和@Trace

相比于@Observed和@ObjectLink,装饰器@ObservedV2装饰器和@Trace装饰器在嵌套层级较深的对象属性类嵌套场景下,易用性更高,观测能力更加强大。

场景五:页面间组件数据的双向同步。

LocalStorage和AppStorage

AppStorageV2

LocalStorage需要配合@LocalStorageProp和@LocalStorageLink装饰器使用,AppStorage需要配合@StorageProp和@StorageLink装饰器使用,易用性差。AppStorageV2直接配合状态管理V2装饰器使用即可,易用性强,对嵌套类中属性变化的观测能力也更加强大。

具体每种场景的使用详情如下:

[h2]场景一:系统组件的内部状态和状态变量的双向同

对比:

方法

不同点

适用场景

$$语法

支持的系统组件范围:参考官网$$使用规则。

适用于对系统组件的参数或属性进行双向同步的场景。

!!语法

支持的系统组件范围:参考官网系统组件参数双向绑定中的“使用规则”。

不仅适用于对系统组件的参数进行双向绑定的场景,还可以配合@Param和@Event装饰器实现自定义组件之间的双向绑定。

[h2]场景二:父子组件建立双向数据同步

对比:

方法

不同点

@Link

与数据源之间建立双向同步,当其中一方改变时,另一方也会同步更新。

@Param和@Event

父组件同步数据给子组件的过程是异步的。使用@Event修改父组件的值是立刻生效的,但从父组件将变化同步回子组件的过程是异步的,即在调用完@Event的方法后,子组件内的值不会立刻变化。

[h2]场景三:跨多层级组件时数据的双向同步

两种方式的对比可以参考官网@Provider和@Consumer vs @Provide和@Consume能力对比。

[h2]场景四:多层嵌套场景下的数据双向同步

方法

不同点

@Observed和@ObjectLink

@Observed装饰器和@ObjectLink装饰器在对嵌套类中属性的变化进行观测的过程中,当嵌套层级较深时,代码将会变得十分复杂,易用性差。

@ObservedV2和@Trace

装饰器@ObservedV2装饰器和@Trace装饰器提供了对嵌套类对象属性变化直接观测的能力,易用性强,对嵌套类中属性变化的观测能力更加强大。

[h2]场景五:页面间组件数据的双向同步

方法

不同点

LocalStorage和AppStorage

LocalStorage需要配合@LocalStorageProp和@LocalStorageLink装饰器使用,AppStorage需要配合@StorageProp和@StorageLink装饰器使用,易用性差。

AppStorageV2

直接配合状态管理V2装饰器使用即可,易用性强,对嵌套类中属性变化的观测能力也更加强大。

常见FAQ

Q:@Link是否需要和@State类型保持完全一致?是否可以本地初始化?

A:@Link需要和@State类型保持完全一致,且必须从父组件初始化。如果没有父组件的初始化,会产生报错。@Link装饰的变量禁止本地初始化,否则编译期会报错。官网中有明确说明,详见限制条件。