其他状态管理概述
除了前面章节提到的组件状态管理和应用状态管理,ArkTS还提供了@Watch、$$运算符和@Track来为开发者提供更多功能:
@Watch:用于监听状态变量的变化。$$运算符:给内置组件提供TS变量的引用,使得TS变量和内置组件的内部状态保持同步。@Track:应用于class对象的属性级更新。@Track装饰的属性变化时,只会触发该属性关联的UI刷新。
@Watch装饰器:状态变量更改通知
@Watch应用于对状态变量的监听。如果开发者需要关注某个状态变量的值是否改变,可以使用@Watch为状态变量设置回调函数。
概述
@Watch用于监听状态变量的变化。当状态变量变化时,@Watch的回调方法将被调用。@Watch在ArkUI框架内部判断数值有无更新使用的是严格相等(===),遵循严格相等规范。在严格相等为false的情况下,就会触发@Watch的回调。
装饰器说明
| @Watch补充变量装饰器 | 说明 |
|---|---|
| 装饰器参数 | 必填。常量字符串,字符串需要有引号。是(string)=> void自定义成员函数的方法的引用。 |
| 可装饰的自定义组件变量 | 可监听所有装饰器装饰的状态变量。不允许监听常规变量。 |
| 装饰器的顺序 | 建议@State、@Prop、@Link等装饰器在@Watch装饰器之前 |
语法说明
| 类型 | 说明 |
|---|---|
| (changePropertyName?:string) =>void | 该函数是自定义组件的成员函数,changePropertyName是被watch的 属性名。在多个状态变量绑定同一个@Watch的回调方法的时候,尅通过changePropertyName进行不同的逻辑处理,将属性名作为字符串输入参数,不返回容忍和内容。 |
观察变化和行为表现
- 当观察到状态变量的变化(包括双向绑定的AppStorage和LocalStorage中对应的key发生变化)的时候,对应的@Watch的回调方法将被触发;
- @Watch方法在自定义组件的属性变更之后同步执行;
- 如果在@Watch的方法里改变了其他的状态变量,也会引起状态变更和@Watch的执行;
- 在第一次初始化的时候,@Watch装饰的方法不会被调用,即认为初始化不是状态变量的改变。只有在后续状态改变时,才会调用@Watch回调方法。
限制条件
- 建议开发者避免无限循环。循环可能是因为在@Watch的回调方法里直接或者间接的改了同一个状态变量引起的。为了避免循环的产生,建议不要在@Watch的回调方法里修改当前装饰的状态变量。
- 开发者应关注性能,属性值更新函数会延迟组件的重新渲染,因此,回调函数应仅执行快速运算。
- 不建议在@Watch函数中调用async await,因为@Watch设计的用途是为了快速的计算,异步行为可能会导致重新渲染速度的性能问题。
$$语法:内置组件双向同步
$$运算符为系统内置组件提供TS变量的引用,使得TS变量和系统内置组件的内部状态保持同步。
内部状态具体指什么取决于组件。例如,TextInput组建的text参数。
使用规则
- 当前
$$支持基础类型变量,以及@State、@Link和@Prop装饰的变量。 - 当前
$$支持的组件:
| 组件 | 支持的参数/属性 | 起始API版本 |
|---|---|---|
| Checkbox | select | 10 |
| CheckboxGroup | sleectAll | 10 |
| DatePicker | selected | 10 |
| TimePicker | selected | 10 |
| MenuItem | seleced | 10 |
| Panel | mode | 10 |
| Radio | checked | 10 |
| Rating | rating | 10 |
| Search | value | 10 |
| SideBarContainer | showSideBar | 10 |
| Slider | value | 10 |
| Stepper | index | 10 |
| Swiper | index | 10 |
| Tabs | index | 10 |
| TextArea | text | 10 |
| TextInput | text | 10 |
| TextPicker | selected、value | 10 |
| Toggle | isOn | 10 |
| Alphabetindexer | selected | 10 |
| Select | selected、value | 10 |
| BindSheet | isShow | 10 |
| BindContentCover | isShow | 10 |
| Refresh | refreshing | 10 |
| GridItem | selected | 10 |
| ListItem | selected | 10 |
$$绑定的变量变化时,会触发UI的同步刷新。
@Track装饰器:class对象属性级更新
@Track应用与class对象的属性级更新。@Track装饰的属性变化时,只会触发该属性关联的UI更新。
概述
@Track是class对象的属性装饰器。当一个class对象是状态变量时,@Track装饰的属性发生变化,只会触发该属性关联的UI更新;而未被标记的属性不能在UI中使用
装饰器说明
| @Track变量装饰器 | 说明 |
|---|---|
| 装饰器参数 | 无 |
| 可装饰的变量 | class对象的非静态成员属性 |
观察变化和行为表现
当一个class对象是状态变量时,@Track装饰的属性发生变化,该属性关联的UI触发更新。
使用@Track装饰器可以避免冗余舒心。
限制条件
- 不能在UI中使用非@Track装饰的属性,包括不能绑定在组件上,不能用于初始化子组件,错误的使用将导致JSCrash;可以在非UI中只用非@Track装饰的属性,如事件回调函数中、生命周期函数中等。
- 建议开发者不要混用包含@Track的class对象和不包含@Track的class对象,如联合类型中、类继承中等。