ArkUI状态管理有两个版本:状态管理(V1)和状态管理(V2)。
对于如何实现各种场景下组件数据的双向绑定与同步,总结如下:
场景 | 状态管理V1 | 状态管理V2 | 对比 |
|---|---|---|---|
场景一:系统组件的内部状态和状态变量的双向同步。 | $$语法 | !!语法 | $$语法仅用于系统组件的双向同步,而!!语法除了实现系统组件的双向同步,还可以实现自定义组件之间的双向绑定,适用范围较大,并且!!语法属于状态管理V2,会在将来得到更多的支持与优化。 |
场景二:父子组件建立双向数据同步。 | @Link | @Param和@Event | @Link实现父子组件双向数据绑定简单直接,子组件可直接修改父组件状态,但状态变量不能独立于UI存在。而@Param和@Event关联的状态变量独立于UI,更改数据会触发相应视图的更新。 |
场景三:跨多层级组件时数据的双向同步。 | @Provide和@Consume | @Provider和@Consumer | |
场景四:多层嵌套场景下的数据双向同步。 | @Observed和@ObjectLink | @ObservedV2和@Trace | 相比于@Observed和@ObjectLink,装饰器@ObservedV2装饰器和@Trace装饰器在嵌套层级较深的对象属性类嵌套场景下,易用性更高,观测能力更加强大。 |
场景五:页面间组件数据的双向同步。 | LocalStorage和AppStorage | AppStorageV2 | LocalStorage需要配合@LocalStorageProp和@LocalStorageLink装饰器使用,AppStorage需要配合@StorageProp和@StorageLink装饰器使用,易用性差。AppStorageV2直接配合状态管理V2装饰器使用即可,易用性强,对嵌套类中属性变化的观测能力也更加强大。 |
具体每种场景的使用详情如下:
可以使用$$语法实现双向绑定变量,使用方法是在变量名前添加$$符号,例如$$this.text,绑定的变量变化时,会触发UI的同步刷新。
@Entry
@Component
struct TestPage {
// 定义响应式状态变量flagA,默认值为false,并监听变化调用radioChangeA方法。
@State @Watch('radioChangeA') flagA: boolean = false;
// 定义响应式状态变量flagB,默认值为false,并监听变化调用radioChangeB方法。
@State @Watch('radioChangeB') flagB: boolean = false;
currentIndex: number = 1;
// flagA状态变化时触发的回调函数。
radioChangeA() {
console.info('触发修改A');
}
// flagB状态变化时触发的回调函数。
radioChangeB() {
console.info('触发修改B');
if (this.currentIndex === 1) {
this.flagB = true;
} else {
this.flagB = false;
}
}
build() {
Row() {
Column() {
Text('Radio1');
Radio({ value: 'Radio1', group: 'radioGroup' }).checked($$this.flagA);
Radio({ value: 'Radio2', group: 'radioGroup' }).checked($$this.flagB);
}
.width('100%');
}
.height('100%');
}
} 效果图如下:

!!语法能够实现双向绑定,添加方式是在变量名后添加,例如isShow!!,具体实现可参考官网系统组件参数双向绑定使用示例。
方法 | 不同点 | 适用场景 |
|---|---|---|
$$语法 | 支持的系统组件范围:参考官网$$使用规则。 | 适用于对系统组件的参数或属性进行双向同步的场景。 |
!!语法 | 支持的系统组件范围:参考官网系统组件参数双向绑定中的“使用规则”。 | 不仅适用于对系统组件的参数进行双向绑定的场景,还可以配合@Param和@Event装饰器实现自定义组件之间的双向绑定。 |
对比:
方法 | 不同点 |
|---|---|
@Link | 与数据源之间建立双向同步,当其中一方改变时,另一方也会同步更新。 |
@Param和@Event | 父组件同步数据给子组件的过程是异步的。使用@Event修改父组件的值是立刻生效的,但从父组件将变化同步回子组件的过程是异步的,即在调用完@Event的方法后,子组件内的值不会立刻变化。 |
两种方式的对比可以参考官网@Provider和@Consumer vs @Provide和@Consume能力对比。
提供了@Observed装饰器和@ObjectLink装饰器,实现嵌套层级下的父子类双向同步,能够解决复杂对象内部属性的响应式更新的问题。适用于嵌套对象属性修改、数组元素更新、修改大型对象的局部属性等场景。
// 定义列表项数据模型接口。
interface IndexItemViewModelType {
name: string;
selected: boolean;
selectItem(): void;
}
// 可观察的列表项数据模型实现类。
@Observed
class IndexItemViewModel implements IndexItemViewModelType {
name: string;
selected: boolean;
constructor(name: string) {
this.name = name;
this.selected = false;
}
selectItem(): void {
this.selected = !this.selected;
}
}
interface IndexViewModelType {
items: IndexItemViewModelType[];
}
@Component
struct CustomRow {
@ObjectLink viewModel: IndexItemViewModel;
build() {
Column() {
Text(this.viewModel.name);
// 修改名称。
Button('name change').fontSize(20).onClick(() => {
this.viewModel.name = this.viewModel.name + 'c1';
});
};
}
}
@Observed
class IndexViewModel implements IndexViewModelType {
items: IndexItemViewModelType[];
constructor() {
// 初始化7个测试数据项。
this.items = [
new IndexItemViewModel('测试数据1'),
new IndexItemViewModel('测试数据2'),
new IndexItemViewModel('测试数据3'),
new IndexItemViewModel('测试数据4'),
new IndexItemViewModel('测试数据5'),
new IndexItemViewModel('测试数据6'),
new IndexItemViewModel('测试数据7'),
];
}
}
@Entry
@Component
struct IndexViewTest {
@State viewModel: IndexViewModelType = new IndexViewModel();
build() {
Column() {
List({ space: 10 }) {
ForEach(this.viewModel.items, (item: IndexItemViewModelType) => {
ListItem() {
CustomRow({ viewModel: item }); // 使用自定义行组件。
}
.width('50%')
.onClick(() => {
item.selectItem();
})
.margin({ right: 105, left: 95 });
});
}
.backgroundColor('#F1F3F5')
.margin({bottom:12})
.width('100%')
.height('50%');
// 显示前两个列表项。
CustomRow({ viewModel: this.viewModel.items[0] }).margin({bottom:12});
CustomRow({ viewModel: this.viewModel.items[1] });
};
}
} 效果图如下:

可以通过@ObservedV2装饰器和@Trace装饰器装饰类以及类中的属性,使得被装饰的类和属性具有深度观测的能力,具体示例可参考@ObservedV2装饰器和@Trace装饰器使用场景。
方法 | 不同点 |
|---|---|
@Observed和@ObjectLink | @Observed装饰器和@ObjectLink装饰器在对嵌套类中属性的变化进行观测的过程中,当嵌套层级较深时,代码将会变得十分复杂,易用性差。 |
@ObservedV2和@Trace | 装饰器@ObservedV2装饰器和@Trace装饰器提供了对嵌套类对象属性变化直接观测的能力,易用性强,对嵌套类中属性变化的观测能力更加强大。 |
可以通过LocalStorage和AppStorage实现,使用方法可分别参考兄弟组件之间同步状态变量和AppStorage在多页面中共享使用。
可以通过AppStorageV2实现,具体使用方法可参考在两个页面之间存储数据。
方法 | 不同点 |
|---|---|
LocalStorage和AppStorage | LocalStorage需要配合@LocalStorageProp和@LocalStorageLink装饰器使用,AppStorage需要配合@StorageProp和@StorageLink装饰器使用,易用性差。 |
AppStorageV2 | 直接配合状态管理V2装饰器使用即可,易用性强,对嵌套类中属性变化的观测能力也更加强大。 |
Q:@Link是否需要和@State类型保持完全一致?是否可以本地初始化?
A:@Link需要和@State类型保持完全一致,且必须从父组件初始化。如果没有父组件的初始化,会产生报错。@Link装饰的变量禁止本地初始化,否则编译期会报错。官网中有明确说明,详见限制条件。