【鸿蒙开发实战】HarmonyOS装饰详解

前言

2024年对鸿蒙来说可谓至关重要，生态建设的前提，就是要有足够的开发人才。与之对应的，今年春招市场上与鸿蒙相关岗位和人才旺盛的热度，一方面反应了鸿蒙生态的逐渐壮大，另一方面也让人们对鸿蒙下一阶段的发展更具信心。

随着鸿蒙市场份额的不断提升，相应的岗位也会迎来一个爆发式的增长。这对于想要换赛道的程序员来说是一个非常好的消息，话说大家最近有想法转型鸿蒙开发吗？

这篇文章主要给大家讲讲关于鸿蒙装饰器的一些知识

@Builder装饰器： 自定义构建函数

自定义组件内构建函数

@Builder function(){...}

调用的时候可以直接使用this.function()使用
自定义组件内@Builder方法个数不限制，可以在build()函数内调用，也可以在其他自定义函数，但是不能在组件外调用。

全局自定义构建函数

@Builder function GlobalBuilderFunction(){...}

使用方法GlobalBuilderFunction()
可以被整个应用获取，不允许使用this和bind方法。
如果不涉及组件状态变化，建议使用全局自定义构建方法

参数传递规则

参数的传递主要有两种：按值传递和按引用传递两种。
参数的类型必须与声明的类型保持一致。
在自定义构建函数内部，不允许改变参数值。如果需要改变参数值，且同步回调用点，建议使用@Link

按引用传递参数

传递的参数可为状态变量，且状态变量的改变会引起@Builder方法内部的UI刷新。
ArkUI提供 $$作为按引用传递参数的范式

按值传递参数

调用@Builder装饰的函数默认按值传递。当传递的参数为状态变量的时候，状态变量的改变不会引起@Builder方法内的UI刷新。所以当使用状态变量的时候，推荐使用按引用传递。

@BuildeParam装饰器：引用@Builder函数

用来装饰指向@Builder方法的变量，可以在初始化自定义组件时对属性进行复制，为自定义组件增加特定的功能。
这个装饰器用于声明任意UI描述的一个元素，类似slot占位符。

初始化@BuilderParam装饰的方法

@BuilderParam装饰的方法只能被@Builder装饰的方法初始化（自定义构建函数）。
参数初始化组件
@BuilderParam装饰的放大可以是有参数和无参数的两种形式，需与指向的@Builder方法类型匹配。
例如：

// 我们声明一个全局构建函数
@Builder function overBuilder($$:{label:string}){
...
}
// 这里我们用了按引用传递参数的方式

那么我们被@BuilderParam装饰的变量的参数也要采用这样的形式与之匹配。
例如：

@BuilderParam customBuilderParam:($$:{label:string}) => void

尾随闭包初始化组件

就是在初始化自定义组件的时候，组件后紧跟一个大括号{}形成尾随闭包场景。

@Styles装饰器：定义组件重用样式

我们可以理解为这个装饰器可以把我们开发中组件重复的样式设置代码进行抽离成一个方法。

使用说明

●当前@Styles仅支持通用属性和通用事件
●@Styles方法不支持带参数
●@Styles可以定义在组件内或全局，在全局定义时需要在方法前添加function关键字。和自定义构建函数是一样的
●定义在组件内的@Styles可以通过this访问组件的常量和状态变量，并可以在@Styles里通过时间来改变状态变量的值
●组件内的@Styles优先级高于全局@Styles，框架优先找当前组件内的@Styles，如果找不到，则会全局查找

@Extend装饰器：定义扩展组件样式

使用说明

语法

@Extend(UIcompinentName) function functionName{...}

使用规则

●@Extend仅支持定义在全局，不支持组件内定义
●@Extend支持封装指定组件的私有属性、私有事件和自身定义的全局方法
●@Extend支持代参数，参数可以为function,也可以为状态变量（当状态变量改变的时候，UI可以正常被帅鑫渲染）

stateStyles:多态样式

概述

stateStyles是属性方法，可以根据UI内部状态来设置样式，类似于css伪类，但是语法不同。
ArkUI提供以下四种状态：

●focused : 获焦态
●normal ：正常态
●pressed: 按压态
●disabled : 不可用态
这样我们就可以通过组件的不同状态对组件进行不同状态下的样式设置，也可以配合着@Styles装饰器一起使用

写在最后

有很多小伙伴不知道该从哪里开始学习鸿蒙开发技术？也不知道鸿蒙开发的知识点重点掌握的又有哪些？自学时频繁踩坑，导致浪费大量时间。结果还是一知半解。所以有一份实用的鸿蒙（HarmonyOS NEXT）全栈开发资料用来跟着学习是非常有必要的。

获取完整版高清学习资料，请点击→鸿蒙全栈开发学习资料（安全链接，请放心点击）

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了

最新鸿蒙全栈开发学习线路

鸿蒙HarmonyOS开发教学视频

大厂面试真题

鸿蒙OpenHarmony源码剖析

这份资料能帮住各位小伙伴理清自己的学习思路，更加快捷有效的掌握鸿蒙开发的各种知识。有需要的小伙伴自行领取，，先到先得~无套路领取！！

获取这份完整版高清学习资料，请点击→鸿蒙全栈开发学习资料（安全链接，请放心点击）