1.概述
- @State装饰的变量,与声明式范式中的其他被装饰变量一样,是私有的,只能从组件内部访问,在声明时必须指定其类型和本地初始化。初始化也可选择使用命名参数机制从父组件完成初始化。
2.特点
@State装饰的变量与子组件中的@Prop装饰变量之间建立单向数据同步,与@Link、@ObjectLink装饰变量之间建立双向数据同步。
@State装饰的变量生命周期与其所属自定义组件的生命周期
3.观察变化
3.1.以下情况可以观察到=>
- 当装饰的数据类型为boolean、string、number类型时,可以观察到数值的变化。
- 当装饰的数据类型为class或者Object时,可以观察到自身的赋值的变化,和其属性赋值的变化,即Object.keys(observedObject)返回的所有属性
- 当装饰的对象是array时,可以观察到数组本身的赋值和添加、删除、更新数组的变化
- 当装饰的对象是Date时,可以观察到Date整体的赋值,同时可通过调用Date的接口setFullYear, setMonth, setDate, setHours, setMinutes, setSeconds, setMilliseconds, setTime, setUTCFullYear, setUTCMonth, setUTCDate, setUTCHours, setUTCMinutes, setUTCSeconds, setUTCMilliseconds 更新Date的属性。
- 当装饰的变量是Map时,可以观察到Map整体的赋值,同时可通过调用Map的接口set, clear, delete 更新Map的值
- 当装饰的变量是Set时,可以观察到Set整体的赋值,同时可通过调用Set的接口add, clear, delete 更新Set的值
3.2.但是也有特殊情况观察不到,例如如下
- 数组项中属性的赋值观察不到。
- // 嵌套的属性赋值观察不到
- this.title.name.value = 'ArkUI';
- 嵌套属性的赋值观察不到。
- // 嵌套的属性赋值观察不到
- this.title[0].value = 6;
4.框架行为
当状态变量被改变时,查询依赖该状态变量的组件;
执行依赖该状态变量的组件的更新方法,组件更新渲染;
和该状态变量不相关的组件或者UI描述不会发生重新渲染,从而实现页面渲染的按需更新。
5.简单示例,方便理解
@Entry
@Component
struct MyComponent {
@State count: number = 0;build() {
Button(`click times: ${this.count}`)
.onClick(() => {
this.count += 1;
})
}
}