HarmonyOS应用开发-自定义组件中装饰器都有哪些？_harmony os 装饰器

本文链接：https://blog.csdn.net/2401_84182665/article/details/137849265

先自我介绍一下，小编浙江大学毕业，去过华为、字节跳动等大厂，目前阿里P7

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新HarmonyOS鸿蒙全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

htt

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上鸿蒙开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以添加V获取：vip204888 （备注鸿蒙）

正文

4 @BuilderParam

ArkUI引入了@BuilderParam装饰器，@BuilderParam用来装饰指向@Builder方法的变量，开发者可在初始化自定义组件时对此属性进行赋值，为自定义组件增加特定的功能。该装饰器用于声明任意UI描述的一个元素，类似slot占位符。

我理解在自定义组件A中可以定义一个变量，使用@BuilderParam装饰器修饰，在调用自定义组件A的时候，可传递一个@Builder修饰的变量。如下代码：

定义自定义组件Child，该组件中aBuilder0使用@BuilderParam修饰
在自定义组件Child的build()中构建aBuilder0
在Parent中定义componentBuilder，并使用@Builder修饰
在Parent调用Child时，传递一个参数，该参数为componentBuilder

@Component
struct Child {
@BuilderParam aBuilder0: () => void;

build() {
Column() {
this.aBuilder0()
}
}
}

@Entry
@Component
struct Parent {
@Builder componentBuilder() {
Text(Parent builder )
}

build() {
Column() {
Child({ aBuilder0: this.componentBuilder })
}
}
}

5 @Styles

@Styles装饰器可以将多条样式设置提炼成一个方法，直接在组件声明的位置调用。

通过@Styles装饰器可以快速定义并复用自定义样式。用于快速定义并复用自定义样式。

// 定义在全局的@Styles封装的样式
@Styles function globalFancy () {
.width(150)
.height(100)
.backgroundColor(Color.Pink)
}

@Entry
@Component
struct FancyUse {
@State heightValue: number = 100
// 定义在组件内的@Styles封装的样式
@Styles fancy() {
.width(200)
.height(this.heightValue)
.backgroundColor(Color.Yellow)
.onClick(() => {
this.heightValue = 200
})
}

build() {
Column({ space: 10 }) {
// 使用全局的@Styles封装的样式
Text(‘FancyA’)
.globalFancy ()
.fontSize(30)
// 使用组件内的@Styles封装的样式
Text(‘FancyB’)
.fancy()
.fontSize(30)
}
}
}

6 @Extend

在@Styles的基础上，提供了@Extend，用于扩展原生组件样式。

@Styles不同，@Extend装饰的方法支持参数

// xxx.ets
@Extend(Text) function fancy (fontSize: number) {
.fontColor(Color.Red)
.fontSize(fontSize)
}

@Entry
@Component
struct FancyUse {
build() {
Row({ space: 10 }) {
Text(‘Fancy’)
.fancy(16)
Text(‘Fancy’)
.fancy(24)
}
}
}

7 stateStyles

@Styles和@Extend仅仅应用于静态页面的样式复用，stateStyles可以依据组件的内部状态的不同，快速设置不同样式。stateStyles是属性方法，可以根据UI内部状态来设置样式，类似于css伪类，但语法不同。ArkUI提供以下四种状态：

focused：获焦态。
normal：正常态。
pressed：按压态。
disabled：不可用态。

Button1处于第一个组件，Button2处于第二个组件。按压时显示为pressed态指定的黑色。使用Tab键走焦，先是Button1获焦并显示为focus态指定的粉色。当Button2获焦的时候，Button2显示为focus态指定的粉色，Button1失焦显示normal态指定的红色。

@Entry
@Component
struct StateStylesSample {
build() {
Column() {
Button(‘Button1’)
.stateStyles({
focused: {
.backgroundColor(Color.Pink)
},
pressed: {
.backgroundColor(Color.Black)
},
normal: {
.backgroundColor(Color.Red)
}
})
.margin(20)
Button(‘Button2’)
.stateStyles({
focused: {
.backgroundColor(Color.Pink)
},
pressed: {
.backgroundColor(Color.Black)
},
normal: {
.backgroundColor(Color.Red)
}
})
}.margin(‘30%’)
}
}