HarmonyOS 应用开发之@BuilderParam装饰器：引用 (2)，2024面试题

最新推荐文章于 2024-07-25 20:17:04 发布

2401_83947105

最新推荐文章于 2024-07-25 20:17:04 发布

阅读量700

点赞数 19

分类专栏： 2024年程序员学习文章标签： harmonyos 华为

本文链接：https://blog.csdn.net/2401_83947105/article/details/137566712

版权

2024年程序员学习专栏收录该内容

271 篇文章 1 订阅

订阅专栏

当开发者创建了自定义组件，并想对该组件添加特定功能时，例如在自定义组件中添加一个点击跳转操作。若直接在组件内嵌入事件方法，将会导致所有引入该自定义组件的地方均增加了该功能。为解决此问题，ArkUI引入了@BuilderParam装饰器，@BuilderParam用来装饰指向@Builder方法的变量，开发者可在初始化自定义组件时对此属性进行赋值，为自定义组件增加特定的功能。该装饰器用于声明任意UI描述的一个元素，类似slot占位符。

说明：
从API version 9开始，该装饰器支持在ArkTS卡片中使用。

装饰器使用说明

初始化@BuilderParam装饰的方法

@BuilderParam装饰的方法只能被自定义构建函数（@Builder装饰的方法）初始化。如果在API 11中和 @Require 结合使用，则必须父组件构造传参。

使用所属自定义组件的自定义构建函数或者全局的自定义构建函数，在本地初始化@BuilderParam。

@Builder function overBuilder() {}

@Component
struct Child {
@Builder doNothingBuilder() {};

// 使用自定义组件的自定义构建函数初始化@BuilderParam
@BuilderParam customBuilderParam: () => void = this.doNothingBuilder;
// 使用全局自定义构建函数初始化@BuilderParam
@BuilderParam customOverBuilderParam: () => void = overBuilder;
build(){}
}

用父组件自定义构建函数初始化子组件@BuilderParam装饰的方法。

@Component
struct Child {
@Builder customBuilder() {}
// 使用父组件@Builder装饰的方法初始化子组件@BuilderParam
@BuilderParam customBuilderParam: () => void = this.customBuilder;

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

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

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

图1 示例效果图

需注意this指向正确。

以下示例中，Parent组件在调用this.componentBuilder()时，this指向其所属组件，即“Parent”。@Builder componentBuilder()通过this.componentBuilder的形式传给子组件@BuilderParam customBuilderParam，this指向在Child的label，即“Child”。@Builder componentBuilder()通过():void=>{this.componentBuilder()}的形式传给子组件@BuilderParam customChangeThisBuilderParam，因为箭头函数的this指向的是宿主对象，所以label的值为“Parent”。

@Component
struct Child {
label: string = Child
@Builder customBuilder() {}
@Builder customChangeThisBuilder() {}
@BuilderParam customBuilderParam: () => void = this.customBuilder;
@BuilderParam customChangeThisBuilderParam: () => void = this.customChangeThisBuilder;

build() {
Column() {
this.customBuilderParam()
this.customChangeThisBuilderParam()
}
}
}

@Entry
@Component
struct Parent {
label: string = Parent

@Builder componentBuilder() {
Text(${this.label})
}

build() {
Column() {
this.componentBuilder()
Child({ customBuilderParam: this.componentBuilder, customChangeThisBuilderParam: ():void=>{this.componentBuilder()} })
}
}
}

图2 示例效果图

使用场景

参数初始化组件

@BuilderParam装饰的方法可以是有参数和无参数的两种形式，需与指向的@Builder方法类型匹配。@BuilderParam装饰的方法类型需要和@Builder方法类型一致。

class Tmp{
label:string = ‘’
}
@Builder function overBuilder( $KaTeX parse error: Expected '}', got 'EOF' at end of input: : Tmp) { Text($ .label)
.width(400)
.height(50)
.backgroundColor(Color.Green)
}

@Component
struct Child {
label: string = ‘Child’
@Builder customBuilder() {}
// 无参数类型，指向的componentBuilder也是无参数类型
@BuilderParam customBuilderParam: () => void = this.customBuilder;
// 有参数类型，指向的overBuilder也是有参数类型的方法
@BuilderParam customOverBuilderParam: ($$ : Tmp) => void = overBuilder;

build() {
Column() {
this.customBuilderParam()
this.customOverBuilderParam({label: ‘global Builder label’ } )
}
}
}

@Entry
@Component
struct Parent {
label: string = ‘Parent’

@Builder componentBuilder() {
Text(${this.label})
}

build() {
Column() {
this.componentBuilder()
Child({ customBuilderParam: this.componentBuilder, customOverBuilderParam: overBuilder })

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数HarmonyOS鸿蒙开发工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

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