【HarmonyOS Next】鸿蒙实用装饰器一览(一)

  装饰器是现代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中使用，如果使用，会发生运行时报错。

详细文档参考
HarmonyOS Developer文档 - @Track装饰器：class对象属性级更新

原文地址：https://blog.csdn.net/EverRose/article/details/143946576

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！