ArkTS学习笔记_封装复用之@builderParam装饰器

ArkTS学习笔记_封装复用之@builderParam装饰器

  • 作用:
    在自定义组件中,该装饰器用于装饰函数成员变量,@builderParam装饰的函数成员变量的值必须是经过@builder装饰的方法。变量初始化后可以在自定义组件内调用。
  • 初始化:
    可以使用自定义组件的自定义构建函数进行初始化;也可以使用全局自定义构建函数初始化。初始化的工作一般由使用者进行。
  • 运用场景:
    比方,封装了一个组件,这个组件有一个对外的回调函数(@builderParam装饰的函数变量),当想让调用者添加额外的新功能时,可以实现其回调函数(初始化@builderParam装饰的函数变量)。
  • 简单的说:
    @builderParam装饰器用于声明一个的成员函数变量,相当于在自定义组件中添加了一个占位符,调用该函数的地方就是占位的地方,当开发者调用该自定义组件时,想添加新的UI描述,就初始化即可,不需要添加新的U描述,可以不初始化。有点类似有容器功能的组件,可以让调用者往里添加新组件。

装饰器使用说明

  • 使用组件自身的自定义构建函数或者全局的自定义构建函数
javascript 复制代码
// 全局构建函数
@Builder function overBuilder() {}

@Component
struct Child { 
  // 组件自定义构建函数 
  @Builder doNothingBuilder() {};

  // 使用自定义组件的自定义构建函数初始化@BuilderParam
  @BuilderParam customBuilderParam: () => void = this.doNothingBuilder;
  
  // 使用全局自定义构建函数初始化@BuilderParam
  @BuilderParam customOverBuilderParam: () => void = overBuilder;
  
  build(){}
}
  • 用父组件自定义的构建函数初始化子组件@BuilderParam装饰的方法。
javascript 复制代码
@Component
struct Child {
  // 声明一个@BuilderParam函数变量
  @BuilderParam customBuilderParam: () => void;

  build() {
    Column() {
      // 占位的地方,会在此构建外面传进来的组件  
      this.customBuilderParam()
    }
  }
}

@Entry
@Component
struct Parent { 
  // 组件自定义构建函数   
  @Builder componentBuilder() {
    Text(`Parent builder `)
  }

  build() {
    Column() {
      // 使用父组件的构建函数初始化子组件的@BuilderParam函数变量
      Child({ customBuilderParam: this.componentBuilder })
    }
  }
}
相关推荐
岑梓铭8 分钟前
考研408《计算机组成原理》复习笔记,第五章(3)——CPU的【数据通路】
笔记·考研·408·计算机组成原理·计组
非凡ghost2 小时前
AMS PhotoMaster:全方位提升你的照片编辑体验
windows·学习·信息可视化·软件需求
云间月13144 小时前
飞算JavaAI智慧教育场景实践:从个性化学习到教学管理的全链路技术革新
学习·飞算javaai挑战赛
weixin_456904276 小时前
一文讲清楚Pytorch 张量、链式求导、正向传播、反向求导、计算图等基础知识
人工智能·pytorch·学习
Blossom.1186 小时前
把 AI 推理塞进「 8 位 MCU 」——0.5 KB RAM 跑通关键词唤醒的魔幻之旅
人工智能·笔记·单片机·嵌入式硬件·深度学习·机器学习·搜索引擎
草莓熊Lotso7 小时前
《吃透 C++ 类和对象(中):const 成员函数与取地址运算符重载解析》
c语言·开发语言·c++·笔记·其他
Python私教7 小时前
从“Hello World”到“高并发中间件”:Go 语言 2025 系统学习路线图
学习·中间件·golang
玖別ԅ(¯﹃¯ԅ)8 小时前
PID学习笔记6-倒立摆的实现
笔记·stm32·单片机
想学全栈的菜鸟阿董9 小时前
Django5个人笔记
笔记