目录

全局与局部自定义构建函数,传递与接收的区别

问题现象

在@Builder装饰的自定义构建函数使用过程中,如何将@Builder装饰的自定义构建函数传递给子组件?全局与局部自定义构建函数在传递过程中是否存在使用的区别?

背景知识

解决方案

常见FAQ

Q:@Builder和@BuilderParam这两个装饰器的区别是什么?

A:@Builder是HarmonyOS中用于定义可复用UI组件的装饰器,可以将一段UI逻辑封装成一个方法,方便在多个地方调用,而@BuilderParam是用于装饰指向@Builder方法的变量,开发者可以在初始化自定义组件时,使用不同的方式(例如:参数初始化、尾随闭包、箭头函数等)对@BuilderParam装饰的自定义构建函数进行传参赋值。传递方式参考正文内容。

Q:@BuilderParam有哪些使用限制?

A:主要有以下几点限制:

Q:自定义组件@BuilderParam以参数初始化的方式添加子组件时可以链式调用属性;以尾随闭包的方式添加子组件时,链式调用属性时,为什么编译错误?

A:以尾随闭包的方式添加子组件不支持通用属性设置,详见官方文档说明:尾随闭包初始化组件。

Q:如何自定义属性方法?

A:通常@Component修饰的自定义组件,都是一个较为完整的UI单元,内部结构比较固定,更为细致的划分,可以考虑使用@Builder装饰器,将相似的UI部分封装成一个自定义构建方法,以实现复用。实现方式参考正文内容。

总结

根据上述场景,总结传递自定义构建函数的注意事项如下:

传递方式

局部自定义构建函数

全局自定义构建函数

参数初始化

  1. 若@Builder内需要使用UI变量时,可以直接采用this指针调用,传入的变量为调用时子组件的变量。
  2. 若子组件中没有this指向的变量名,会运行报错。
  1. 若@Builder内需要使用UI变量时,需要给全局自定义构建函数设置参数,传入的变量为调用时传入的子组件的变量。
  2. 由于全局自定义构建函数含参,子组件的@BuilderParam装饰器接收时,也需要定义参数。

参数初始化-箭头函数

若@Builder内需要使用UI变量时,可以直接采用this指针调用,传入的变量为父组件的变量。

/

尾随闭包

  1. 若@Builder内需要使用UI变量时,可以直接采用this指针调用,传入的变量为父组件的变量。
  2. 以尾随闭包的方式添加子组件不支持通用属性设置。
  3. 自定义组件内仅有一个使用@BuilderParam装饰的属性才能使用尾随闭包的方式。
  1. 若@Builder内需要使用UI变量时,需要给全局自定义构建函数设置参数,传入的变量为传入时的父组件的变量。
  2. 由于全局自定义构建函数含参,子组件的@BuilderParam装饰器接收时,也需要定义参数。
  3. 以尾随闭包的方式添加子组件不支持通用属性设置。
  4. 自定义组件内仅有一个使用@BuilderParam装饰的属性才能使用尾随闭包的方式。

尾随闭包的传递方式存在一定的限制,建议优先使用参数初始化和箭头函数的方式实现Builder函数的传递。