@State 组件内状态
当状态变量发生改变时,会引起对应UI组件刷新
支持修饰 string、number、boolean、enum基础类型
支持修饰class、object类型,对象属性发生变化时,也会引发UI刷新,多层属性发生变化时,不会引发刷新
支持数组上述类型的数组,数组发生变化时,引发刷新、数组内对象的属性发生变化时,不会刷新
框架处理方式:
- 状态变量改变时,查询依赖该变量的组件
- 执行该组件的更新方法,组件更新渲染
- 无关组件不会发生渲染,实现按需更新
@Prop 父子单向同步
装饰的变量会进行深拷贝、除基础类型外,会导致类型丢失
不可以在@Entry装饰的组件中使用
本地修改不会同步到父组件
父组件的初始化入参会覆盖子组件初始化的值
支持基础数据类型及数组
支持联合类型 string|number、ClassA|null
@Link 双向同步
支持Object、class、number、string、boolean、enum及对应数组
框架处理方式:
- 初始渲染:父组件build()初始化子组件,创建实例
a. 指定父组件@State变量,初始化子组件@Link变量,保持父子组件同步
b. 父组件@State变量包装类通过构造函数传给子组件,子组件@Link包装类拿到@State变量后,将@Link包装类this指针注册给父组件的@State变量 - @Link数据源更新,父组件@State变量更新后,出发子组件@Link变量更新步骤
a. 父组件@State变量更新后,会遍历所有依赖他的系统组件和状态变量
b. 通知子组件@Link包装类更新,子组件依赖@Link变量的系统组件收到通知更新,实现父子组件状态同步 - @Link更新:子组件@Link更新后,通知父组件的步骤
a. @Link更新后,调用父组件@State包装类的set方法,更新后的值同步给父组件
b. 子组件@Link状态变量和父组件@State变量分别便利依赖的系统组件,更新对应UI。
@Provide、@Consume 后代组件双向同步
用于跟后代组件进行双向同步,实现跨层级传递
@Provide修饰祖先组件
@Consume修饰后代组件
特性:
- 被@Provide修饰的状态变量,自动对所有后代组件可用
- 后代通过@Consume获取@Provide提供的变量,建立双向同步
- 可以通过相同的变量名或者相同的变量别名绑定,类型保持一致,不一致引发类型转换导致异常
//相同变量名
@Provide a:number = 0
@Consume a:number
//相同变量别名a
@Provide('a')b: number = 0
@Consume('a')c: number
-
@Provide与@Consume是一对多关系,不允许组件内出现多个同名@Provide
框架处理步骤:
总结:
- 子组件持有父组件@Provide的map,用于校验@Consume所对应的@Provide变量
- 父组件持有所有@Consume及对应的子组件,发生更新时,通过遍历通知素所有@Consume的组件
- 子组件持有@Provide的实例(父组件),发生更新时,直接通过实例调用更新父组件的@Provide
@Observed、@ObjectLink 嵌套类对象属性观察
支持在嵌套对象/数组中双向同步
限制:
- 被@ObjectLink修饰的变量只读,不可以实例化/重新赋值,可以对class内部的属性进行赋值
- @ObjectLink修饰的类型必须和@Observed修饰的类型相同
框架处理步骤:
- 初始:
- @Observerd修饰的class的实例会被代理对象包装,代理setter和getter
- 子组件@ObjectLink修饰的对象从父组件初始化,接受被代理对象包装后的实例,同时将自己注册给父组件
- 属性更新:
- class属性发生改变时,通过对应的setter和getter,遍历依赖的@ObjectLink包装类,通知更新