王艺舟|
ArkUI (方舟UI框架)
优化建议-ArkUI的BuilderNode的方法介绍需要优化
已解决
【问题描述】:关于@Builder嵌套使用时入参对象一致的要求表述错误,实际嵌套调用时并不要求内外Builder的入参对象类型相同
链接:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-arkui-buildernode
原文:@Builder嵌套使用的时候需要保证内外的@Builder方法的入参对象一致
【问题现象】:文档示例与上方描述不符,示例中外层buildText接收ParamsInterface(包含text和func),内层buildTextWithFunc接收Function,类型并不一致。

【版本信息】:不涉及
【复现代码】:不涉及
1
浏览84 发布于2026-05-12 07:00湖北
全部评论
最多点赞
最新发布
最早发布
云帆扬采纳答复
您好,文档这个示例中使用的build是API12的接口,设置了BuildOptions的nestingBuilderSupported参数为true,没有限制@Builder嵌套使用的时候需要保证内外的@Builder方法的入参对象一致,所以可以嵌套不一致。
关于@Builder嵌套使用的时候需要保证内外的@Builder方法的入参对象一致
报错示例:正确示例
关于@Builder嵌套使用的时候需要保证内外的@Builder方法的入参对象一致
报错示例:
收起
自动换行
深色代码主题
复制
import { BuilderNode, NodeContent } from "@kit.ArkUI";
// 定义传递参数的接口
interface ParamsInterface {
text: string;
func: Function;
}
@Builder
function buildTextWithFunc(fun: Function) {
Text(fun())
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({ bottom: 36 })
}
@Builder
function buildText(params: ParamsInterface) {
Column() {
Text(params.text)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({ bottom: 36 })
buildTextWithFunc(params.func)
}
}
@Entry
@Component
struct Index {
@State message: string = "HELLO";
private content: NodeContent = new NodeContent();
build() {
Row() {
Column() {
Button('addBuilderNode')
.onClick(() => {
let buildNode = new BuilderNode<[ParamsInterface]>(this.getUIContext());
// 创建节点树
buildNode.build(wrapBuilder<[ParamsInterface]>(buildText), {
text: this.message, func: () => {
return "FUNCTION";
}
});
this.content.addFrameNode(buildNode.getFrameNode());
buildNode.dispose();
})
ContentSlot(this.content)
}
.id("column")
.width('100%')
.height('100%')
}
.height('100%')
}
}收起
自动换行
深色代码主题
复制
import { BuilderNode, NodeContent } from "@kit.ArkUI";
// 定义传递参数的接口
interface ParamsInterface {
text: string;
func: Function;
}
@Builder
function buildTextWithFunc(params: ParamsInterface) {
Text(params.func())
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({ bottom: 36 })
}
@Builder
function buildText(params: ParamsInterface) {
Column() {
Text(params.text)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.margin({ bottom: 36 })
buildTextWithFunc(params)
}
}
@Entry
@Component
struct Index {
@State message: string = "HELLO";
private content: NodeContent = new NodeContent();
build() {
Row() {
Column() {
Button('addBuilderNode')
.onClick(() => {
let buildNode = new BuilderNode<[ParamsInterface]>(this.getUIContext());
// 创建节点树
buildNode.build(wrapBuilder<[ParamsInterface]>(buildText), {
text: this.message, func: () => {
return "FUNCTION";
}
});
this.content.addFrameNode(buildNode.getFrameNode());
buildNode.dispose();
})
ContentSlot(this.content)
}
.id("column")
.width('100%')
.height('100%')
}
.height('100%')
}
} 展开全部 
1楼回复于2026-05-13 07:51 来自广东
写回答
所见即所得编辑器, editor1
工具栏 撤消 快捷键 Ctrl+Z 重做 快捷键 Ctrl+Y 格式刷 快捷键 Ctrl+Shift+C 清除格式 加粗 快捷键 Ctrl+B 倾斜 快捷键 Ctrl+I 下划线 快捷键 Ctrl+U 删除线格式调整字号 文本颜色 背景颜色 增加缩进量 减少缩进量 左对齐 居中 右对齐 两端对齐段落间距行间距 项目列表 编号列表 插入水平线 块引用 插入/编辑超链接 快捷键 Ctrl+K 取消超链接 图片 表格 上传附件 导入Word 插入代码 MD编辑器 全屏模式
0/50000
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
相关推荐
换一批
1
HarmonyOS WaterFlow性能不达标,给出优化建议?(API12+)
2
【ArkUI动画系列】四:ArkUI基础动画之粒子动画
3
HarmonyOS 如何使用ArkUI-X开发应用 (API12+)
4
HarmonyOS FrameNode性能如何优化 (API12+)
5
HarmonyOS 复用组件中,在当前struct中不允许builder嵌套builder吗?(API12+)
6
HarmonyOS @BuilderParam刷新问题 (API12+)
7
HarmonyOS new ComponentContent() API中Builder不能支持嵌套。想让中间部分能够自定义。 (API12+)
8
HarmonyOS BuilderNode update和reuse方法的区别(API12+)
了解社区公约,与您携手共创和谐专业的开发者社区。




































苏公安网备 32011402010933号