文档开发者中心
我的
|

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,类型并不一致。

cke_528.png

【版本信息】:不涉及

【复现代码】:不涉及

点赞
收藏
回复
1
分享
举报
浏览84 发布于2026-05-12 07:00湖北
全部评论
最多点赞
最新发布
最早发布
|
采纳答复
您好,文档这个示例中使用的build是API12的接口,设置了BuildOptions的nestingBuilderSupported参数为true,没有限制@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 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。