【HarmonyOS实战开发】鸿蒙 ArkTs 自定义组件插槽

前言

HarmonyOS 鸿蒙 arkts中想要自定义组件中要传入其他组件的时候就可以使用自定义组件插槽。
可以在ArkUI引入了@BuilderParam装饰器。@BuilderParam用来装饰指向@Builder方法的变量，开发者可在初始化自定义组件时对此属性进行赋值，为自定义组件增加特定的功能。该装饰器用于声明任意UI描述的一个元素，类似slot占位符。
样例

插槽的使用

自定义组件

// 子组件
@Component
  export struct Card {
    @Builder
    slot() {
      Text('暂无数据').margin(30)
    };

    private title: ResourceStr
    @BuilderParam component: () => void = this.slot;

    build() {
      Column() {
        Row() {
          Text(this.title)
            .fontColor('#333333')
            .fontSize(18)
            .fontWeight(700)
            .lineHeight(26)
        }.justifyContent(FlexAlign.Start).width('100%')

        this.component()
      }
      .backgroundColor(Color.White)
        .width('100%')
        .padding({ left: 16, right: 16, top: 20, bottom: 20 })
        .borderRadius(12)
        .margin({ bottom: 12 })
    }
  }

外部调用

@Builder
function overBuilder() {
  Text('外部组件').margin(30)
}

// 父布局调用：
@Preview
@Component
@Entry
export struct Index {
  @Builder
  componentBuilder() {
    Text('内部组件').margin(30)
  }

  build() {
    Column() {
      Card({ title: '默认插槽' })
      Card({ title: '使用内部的组件插槽', component: this.componentBuilder })
      Card({ title: '使用外部的组件插槽', component: overBuilder })
      Card({ title: '直接传值' }) {
        Text('直接传值').margin(30)
      }

    }.height('100%').padding({ left: 16, right: 16, top: 20, bottom: 20 }).backgroundColor('#f0f3f6')
  }
}

效果图

以上的例子，都是单个插槽，那如果想使用多个插槽呢?

多个插槽使用

子组件有多个BuilderParam，必须通过参数的方式来传入

自定义组件

// 子组件
@Component
export struct Card {
  @Builder
  slot() {
    Text('暂无数据').margin(30)
  };

  @Builder
  defaultRightSlot() {
    Text('详情')
  };

  private title: ResourceStr
  @BuilderParam component: () => void = this.slot;
  @BuilderParam rightSlot: () => void = this.defaultRightSlot;

  build() {
    Column() {
      Row() {
        Text(this.title)
          .fontColor('#333333')
          .fontSize(18)
          .fontWeight(700)
          .lineHeight(26)
        this.rightSlot()

      }.justifyContent(FlexAlign.SpaceBetween).width('100%')

      this.component()
    }
    .backgroundColor(Color.White)
    .width('100%')
    .padding({ left: 16, right: 16, top: 20, bottom: 20 })
    .borderRadius(12)
    .margin({ bottom: 12 })
  }
}

外部调用

@Builder
function overBuilder() {
  Text('外部组件').margin(30)
}

// 父布局调用：
@Preview
@Component
@Entry
export struct Index {
  @Builder
  componentBuilder() {
    Text('内部组件').margin(30)
  }

  @Builder
  rightBuilder() {
    Text('右边的插槽').margin(30)
  }

  build() {
    Column() {
      Card({ title: '默认插槽' })
      Card({ title: '通过参数传递', component: this.componentBuilder, rightSlot: this.rightBuilder })
      // Card({ title: '会报错' }) {
      //   Text('直接传值').margin(30)
      // }
    }.height('100%').padding({ left: 16, right: 16, top: 20, bottom: 20 }).backgroundColor('#f0f3f6')
  }
}

效果图

写在最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）文档包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习文档能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习文档

鸿蒙（HarmonyOS NEXT）5.0最新学习路线

有了路线图，怎么能没有学习文档呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习文档

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V3.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

●ArkTS语言
●安装DevEco Studio
●运用你的第一个ArkTS应用
●ArkUI声明式UI开发
.……

《鸿蒙开发进阶》

●Stage模型入门
●网络管理
●数据管理
●电话服务
●分布式应用开发
●通知与窗口管理
●多媒体技术
●安全技能
●任务管理
●WebGL
●国际化开发
●应用测试
●DFX面向未来设计
●鸿蒙系统移植和裁剪定制
……

《鸿蒙进阶实战》

●ArkTS实践
●UIAbility应用
●网络案例
……

获取以上完整鸿蒙HarmonyOS学习文档，请点击→纯血版全套鸿蒙HarmonyOS学习文档