- 该装饰器从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
@Builder装饰器：自定义构建函数
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
复制页面
本文导读
@Builder装饰的函数也称为“自定义构建函数”，用于封装可复用的UI构建逻辑，可在自定义组件中多次调用，从而减少代码重复、提升UI构建的可维护性，适用于需要复用相同UI结构的场景。
开发指南参考：@Builder装饰器：自定义构建函数。
说明
@Builder
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
const Builder: MethodDecorator
系统能力： SystemCapability.ArkUI.ArkUI.Full
卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。
元服务API： 从API version 11开始，该接口支持在元服务中使用。
示例：
@Entry
@Component
struct BuilderDemo {
// @Builder装饰此函数，使其成为自定义构建函数，用于配置并构建Text组件
@Builder
showTextBuilder() {
Text('Hello World')
.fontSize(30)
.fontWeight(FontWeight.Bold)
}
@Builder
showTextValueBuilder(param: string) {
Text(param)
.fontSize(30)
.fontWeight(FontWeight.Bold)
}
build() {
Column() {
// 无参数
this.showTextBuilder()
// 有参数
this.showTextValueBuilder('Hello @Builder')
}
}
} 
华为开发者联盟 版权所有 ©2026