装饰器是现代js
一个很重要(尚未成熟)的特性,TS4.9
开始对装饰器的Stage 3
支持,并在TS5.0
中发布了装饰器
规范的完整版本。ArkTS在TS生态
基础上做了进一步扩展,保持了TS
的基本风格,同时封装了大量的装饰器
来简化功能。
以下内容基于HarmonyOS Next 5.0.0
(API12
)。
UI组件装饰器
详细文档参考
HarmonyOS Developer文档 - 创建自定义组件
@Component装饰器
@Component
装饰器仅能装饰struct
关键字声明的数据结构。struct
被@Component
装饰后具备组件化的能力。
@Entry装饰器
@Entry
装饰的自定义组件将作为UI页面入口
。在单个UI页面中,最多可以使用@Entry
装饰一个自定义组件。
@Reusable装饰器
@Reusable
装饰的自定义组件具备可复用能力。官方文档未详细说明,事实上这个装饰器
在解决帧率瓶颈时非常重要且有效。
使用场景
- 滑动场景下对同一类自定义组件的实例进行频繁的创建与销毁。
- 反复切换条件渲染的控制分支,且控制分支中的组件子树结构比较复杂。
可复用自定义组件的缓存和复用只能发生在同一父组件下,无法在不同的父组件下复用同一自定义组件的实例。
组件状态管理装饰器
@State装饰器
@State
装饰的变量,与声明式范式
中的其他被装饰变量一样,是私有
的,只能从组件内部访问
,在声明时必须指定其类型和本地初始化。
初始化也可选择使用命名参数机制
从父组件完成初始化。这一点受到争议,大部分人认为私有的变量不应该从父组件进行初始化,所以在@ComponentV2
中,新增@Local
进行平替。
详细文档参考
HarmonyOS Developer文档 - @State装饰器:组件内状态
@Prop装饰器
@Prop
装饰的变量和父组件建立单向
的同步关系。当父组件的变量发生变化时会同步到子组件,所以@Prop装饰器
自然不能使用在被@Entry
装饰的UI页面
上;另外@Prop
装饰的变量允许组件内部进行修改,个人认为这个特性是松散且不严谨的。
详细文档参考
HarmonyOS Developer文档 - @State装饰器:组件内状态
@Link装饰器
被@Link
装饰的变量与其父组件中对应的数据源建立双向数据绑定
。同@Prop装饰器
一样也只能作用在子组件上。
详细文档参考
HarmonyOS Developer文档 - @Link装饰器:父子双向同步
@Provide装饰器和@Consume装饰器
@Provide
和@Consume
,应用于与后代组件的双向数据同步
,应用于状态数据在多个层级之间传递的场景。不同于上文提到的@Link装饰器
,@Provide
和@Consume
摆脱参数传递机制的束缚,实现跨层级传递。
详细文档参考
HarmonyOS Developer文档 - @Provide装饰器和@Consume装饰器:与后代组件双向同步
@Observed装饰器和@ObjectLink装饰器
@ObjectLink
和@Observed
类装饰器用于在涉及嵌套对象
或数组
的场景中进行双向数据同步
,被@ObjectLink
修饰的状态变量用于接收被@Observed
装饰的类的实例,和父组件中对应的状态变量
建立双向数据绑定
。
详细文档参考
HarmonyOS Developer文档 - @Observed装饰器和@ObjectLink装饰器:嵌套类对象属性变化
应用状态管理装饰器
@LocalStorageProp装饰器
@LocalStorageProp
装饰的变量与LocalStorage
中给定属性建立单向同步
关系。
LocalStorage
是页面级
的UI状态存储
,通过@Entry
装饰器接收的参数可以在页面内共享同一个LocalStorage
实例。
详细文档参考
HarmonyOS Developer文档 - @LocalStorageProp
@LocalStorageLink装饰器
@LocalStorageLink(key)
是和LocalStorage
中key
对应的属性建立双向数据同步
关系。
详细文档参考
HarmonyOS Developer文档 - @LocalStorageLink
@StorageProp装饰器
@StorageProp(key)
是和AppStorage
中key对应的属性建立单向数据同步
关系。
AppStorage
是应用全局
的UI状态存储,是和应用的进程绑定
的,由UI框架在应用程序启动时创建,为应用程序UI状态
属性提供中央存储
。
详细文档参考
HarmonyOS Developer文档 - @StorageProp
@StorageLink装饰器
@StorageLink(key)
是和AppStorage
中key对应的属性建立双向数据同步
关系。
详细文档参考
HarmonyOS Developer文档 - @StorageLink
其他状态管理装饰器
@Watch装饰器
@Watch
用于监听状态变量的变化,当状态变量变化时,@Watch的回调方法将被调用。@Watch
在ArkUI
框架内部判断数值有无更新使用的是严格相等(===)
,遵循严格相等规范。
详细文档参考
HarmonyOS Developer文档 - @Watch装饰器:状态变量更改通知
@Track装饰器
@Track
应用于class对象
的属性级更新
。@Track
装饰的属性变化时,只会触发该属性关联的UI更新。而未被标记的属性不能在UI中使用,如果使用,会发生运行时报错。