鸿蒙（HarmonyOS）是华为推出的一款面向全场景的分布式操作系统，它旨在实现“一次开发，多端运行”。而在鸿蒙开发中，builderparam（构建参数）是一个重要的概念，它可以帮助开发者优化构建过程，提高开发效率。本文将带您深入了解鸿蒙builderparam，并通过代码示例演示其使用方法。
## 什么是builderparam
在鸿蒙开发中，builderparam是指构建参数，用于配置
原创
2024-01-09 21:37:34
227阅读
在实际的开发中，我们经常会遇到自定义组件的情况，比如通用的列表组件，选项卡组件等等，由于使用方的样式不一，子组件是动态变化的，针对这一情况，就不得不让使用方把子组件视图传递过来，如何来接收这个UI视图，这就是@BuilderParam装饰器的作用。
当开发者创建了自定义组件，并想对该组件添加特定功能时，例如在自定义组件中添加一个点击跳转操作。若直接在组件内嵌入事件方法，将会导致所有引入该自定义组件的地方均增加了该功能。为解决此问题，ArkUI引入了@BuilderParam装饰器，@BuilderParam用来装饰指向@Builder方法的变量，开发者可在初始化自定义组件时对此属性进行赋值，为自定义组件增加特定的功能。该装饰器用于声明任意UI
原创
2023-09-27 17:31:00
219阅读
在查看common.d.ts声明文件的时候发现有两个文档上没见过的常量/** * Defining BuilderParam PropertyDecorator * @since 7 */declare const BuilderParam: PropertyDecorator;/** * Defining Styles MethodDecorator * @since 8 */declare c
原创
2022-04-25 11:56:44
1071阅读
允许在自定义组件内定义一个或多个@Builder方法，该方法被认为是该组件的私有、特殊类型的成员函数。自定义构建函
原创
2024-08-07 17:30:52
523阅读
使用 @Builder、@BuilderParam 开发自定义组件，不同的传值方式会造成 this 指向的宿主对象不同，出现 undefinde 错误。
一、核心概念解析
1. @Builder装饰器：UI复用的基石
定义：将重复的UI逻辑抽象为独立函数，支持组件内或全局复用。
特性：
作用域控制：组件内（私有）或全局定义。
状态访问：组件内可通过this直接访问状态变量。
参数传递：支持按值（默认）或按引用（$$范式）传递状态变量。
示例：// 组件内私有构建函数
@Component
struct CounterComponent {
一、@Builder装饰器：UI复用的核心机制 1. 基本概念 @Builder是ArkTS中用于抽象UI构建逻辑的装饰器，可将重复的UI片段封装为独立函数，支持组件内或全局复用。其核心特性包括： 组
@Require是校验@Prop、@State、@Provide、@BuilderParam和普通变量(无状态装饰器修饰的变量)是否需要构造传参的一个装饰器。
当@Require装饰器和@Prop、@State、@Provide、@BuilderParam、普通变量(无状态装饰器修饰的变量)结合使用时，在构造该自定义组件时，@Prop、@State、@Provide、@BuilderParam和普通变量(无状态装饰器修饰的变量)必须在构造时传参。
@Require装饰器仅用于装饰struct内的@Prop、@State、@Provide、@BuilderParam和普通变量(无状态装饰器修饰的变量)。
当开发者创建自定义组件，并想对该组件添加特定功能时(例如在自定义组件中添加一个点击跳转操作)。为解决此问题，引入了@BuilderParam装饰器，此装饰器修饰的属性值可为@Builder装饰的函数，开发者可在初始化自定义组件时对此属性进行赋值，为自定义组件增加特定的功能。@BuilderParam装饰器用于修饰自定义组件内函数类型的属性(例如：@BuilderParam noParam: () => void)，并且在初始化自定义组件时被@BuilderParam修饰的属性必须赋值。
最近做开发任务的时候，想把Tabs自定义了，并且动态配置TabContent里面的内容，不是写死一样的，这个问题困扰了很长时间，试过**@BuilderParam**（类似于vue的插槽）传组件方式的，但是**@BuilderParam**只能传一个，我想要传递的是一个数组，找了很多Api最后找到了**WrappedBuilder[]**这种方式
【关键词】ArkTS、通用属性、 @BuilderParam【问题背景】有个开发者使用ArkTS自定义了一个子组件AnimationButton，里面用到了装饰器 @BuilderParam，在父页面中引用的时候使用自定义组件时，使用以下方式调用：就报了这个错【问题分析】开发者的想法是：既然是组件，就应该可以使用通用属性，甚至可以让自定义属于这个组件的属性，比如说增加自定义组件
原创
2023-07-27 16:11:16
344阅读
在HarmonyOS NEXT中，如何实现类似Vue-Slot或React-RenderProps的功能？即允许将UI结构的函数（被@Builder修饰的函数）作为参数传递给组件，并在组件内的指定位置渲染，可以使用@BuilderParam装饰器。
在鸿蒙Next开发中，ArkTS对自定义组件的成员变量使用的访问限定符private/public/protected有特定的校验规则，当不按规范使用时会产生相应的日志信息。一、使用限制概述（一）private修饰相关限制对于@State/@Prop/@Provide/@BuilderParam/常规成员变量（不涉及更新的普通变量），使用private修饰时，在自定义组件构造时不允许进行赋值传参，
一、@Require装饰器：强制校验组件构造参数的完整性
基本概念
@Require是ArkTS的参数校验装饰器，用于强制父组件在构造子组件时必须传递指定参数。自API 11开始支持@Prop和@BuilderParam校验，API 12扩展至@State、@Provide和普通变量。
核心特性
编译时校验：未传参直接导致编译失败
版本兼容：支持元服务开发（API 11+）
类型覆盖：支持主流状
背景这是一个基础概念，其实没有什么原因，练习过程中，自然可以感受到其用法，后期加上真实项目的演练，会形成习惯功能核心理念“在自定义组件中添加一个点击跳转操作。若直接在组件内嵌入事件方法，将会导致所有引入该自定义组件的地方均增加了该功能。为解决此问题，ArkUI引入了@BuilderParam装饰器”这样的场景在任何平台任何公司都会遇到，是否采用在公共组件中定义某个功能还是在外部定义某个
