鸿蒙_自定义组件包含多个引用自定义构建函数@BuilderParam时的用法

有时候我们为了增加自定义组件的灵活性,可能放置多个引用自定义构建函数(通过@BuilderParam修饰的变量,指向一个自定义构建函数),那么和只有一个时有什么区别呢,我们新建一个页面来测试一下:

TypeScript 复制代码
@Entry
@Component
struct TestBuilderParamInMultiComponent {
  @State message: string = 'Test @BuilderParam In Multiple Component';

  //编写一个自定义构建函数,用于替换自定义组件的部分UI
  @Builder
  builderInMainPage() {
    Row() {
      Text('在父组件中定义、').fontColor(Color.Green)
      Text('自定义构建函数作为参数')
    }
  }

  build() {
    Column() {
      Text(this.message)
        .margin({ bottom: 10 })
        .fontSize(15)
        .fontWeight(FontWeight.Bold)

      //不传参(如果自定义组件内的builderParamInComp加了@Require不传会报错)
      CompWithTwoBuilderParam()

      // 普通传参1个
      CompWithTwoBuilderParam({
        builderParam2InComp: this.builderInMainPage
      })

      // 普通传参2个
      CompWithTwoBuilderParam({
        builderParam1InComp: this.builderInMainPage,
        builderParam2InComp: this.builderInMainPage
      })

      //尾随闭包不可用,会报错
      /*CompWithTwoBuilderParam() {
        Row() {
          Text('尾随闭包不适用多@BuilderParam参数')
        }
      }*/

    }
    .padding(10)
    .height('100%')
    .width('100%')
  }
}

//自定义组件
@Component
struct CompWithTwoBuilderParam {
  //自定义构建函数1
  @Builder
  builder1InComp() {
    Text('1、自定义构建函数1的默认内容')
  }
  //自定义构建函数2
  @Builder
  builder2InComp() {
    Text('2、自定义构建函数2的默认内容')
  }

  //引用自定义构建函数1(把自定义构建函数整体作为一个参数)
  //@Require
  @BuilderParam
  builderParam1InComp: () => void = this.builder1InComp;

  //引用自定义构建函数2
  //@Require
  @BuilderParam
  builderParam2InComp: () => void = this.builder2InComp;

  build() {
    Column({ space: 10 }) {
      Text('这是一个自定义组件').fontWeight(FontWeight.Bold)
      this.builderParam1InComp()
      this.builderParam2InComp()
    }
    .padding(10)
    .width('100%')
    .margin({ bottom: 10 })
    .border({ width: 1, color: Color.Blue })
  }
}

通过测试我们发现,在有多个@BuilderParam修饰的参数时,之前的尾随闭包方式不可用了,因为尾随闭包在调用自定义组件时,在后边大括号内直接写UI组件,是不指定参数名的,那么当参数大于1个时,就不知道该传给谁了,所以就不能再使用了。另外,如果我们在参数上没有设置@Require的必传验证,那么我们可以不传参或传部分参数,未传参的则保持默认值。


实际运行效果如下:

相关推荐
传奇开心果编程15 小时前
【ArkUI进阶练中学】第13课:元服务与卡片开发
学习·ui·华为·harmonyos
李游Leo16 小时前
HarmonyOS 7 InsightBoard 多形态适配实录 06:ArkUI × 多设备回归:布局抖动、监听释放与全形态验收【鸿蒙心迹】
回归·kotlin·harmonyos
李游Leo16 小时前
HarmonyOS 7 PixelBridge 原生库适配实录 04:Native Buffer Pool、批任务背压与取消链路【鸿蒙心迹】
华为·harmonyos
李游Leo16 小时前
HarmonyOS 7 Spatial Recon Kit 开发实录 01:支持检测、Session 创建与首条有效重建链路【鸿蒙心迹】
华为·harmonyos
传奇开心果编程16 小时前
【ArkUI进阶练中学】第19课:AI安全与隐私治理
学习·ui·华为·harmonyos
李游Leo17 小时前
HarmonyOS 7 QuickDock 闪控窗开发实录 06:floatView × 回归验收:25轮场景回归、资源基线与发布前收口【鸿蒙心迹】
回归·kotlin·harmonyos
李游Leo17 小时前
HarmonyOS 7 DualCart 平行视界适配实录 06:Navigation × 多窗口回归:路由冲突、恢复一致性与性能验收【鸿蒙心迹】
回归·kotlin·harmonyos
传奇开心果编程17 小时前
【ArkUI进阶练中学】第18课:Agent亲和架构与应用智能化改造
学习·ui·华为·harmonyos
李游Leo17 小时前
HarmonyOS 7 QuickDock 闪控窗开发实录 02:floatView × floatingBall:形态切换、位置恢复与单一状态源【鸿蒙心迹】
java·华为·harmonyos