鸿蒙开发实践案例分析——WrapBuilder:封装全局@Builder
本文介绍了HarmonyOS开发中的全局@Builder与wrapBuilder功能。主要包含: wrapBuilder模板函数的使用方法,它可以包装全局@Builder方法,返回可传递的WrappedBuilder对象; 两个典型使用场景: 将wrapBuilder赋值给变量,替代直接使用@Builder方法; 通过wrapBuilder数组实现不同@Builder方法的动态调用; 使用限制:只
·
📝往期推文全新看点(文中附带最新·鸿蒙全栈学习笔记)
1️⃣ 鸿蒙应用开发与鸿蒙系统开发哪个更有前景?
2️⃣ 嵌入式开发适不适合做鸿蒙南向开发?看完这篇你就了解了~
3️⃣ 对于大前端开发来说,转鸿蒙开发究竟是福还是祸?
4️⃣ 鸿蒙岗位需求突增!移动端、PC端、IoT到底该怎么选?
5️⃣ 记录一场鸿蒙开发岗位面试经历~
6️⃣ 持续更新中……
全局@Builder作为wrapBuilder的参数返回WrappedBuilder对象,实现 全局@Builder 可以进行赋值和传递。
说明:
从API version 11开始使用。
接口说明
wrapBuilder是一个模板函数,返回一个WrappedBuilder对象。
declare function wrapBuilder< Args extends Object[]>(builder: (...args: Args) => void): WrappedBuilder;
同时 WrappedBuilder对象也是一个模板类。
declare class WrappedBuilder< Args extends Object[]> {
builder: (...args: Args) => void;
constructor(builder: (...args: Args) => void);
}
说明:模板参数
Args extends Object[]是需要包装的builder函数的参数列表
使用方法:
let builderVar: WrappedBuilder<[string, number]> = wrapBuilder(MyBuilder)
let builderArr: WrappedBuilder<[string, number]>[] = [wrapBuilder(MyBuilder)] //可以放入数组
限制条件
wrapBuilder方法只能传入 全局@Builder 方法。
wrapBuilder方法返回的WrappedBuilder对象的builder属性方法只能在struct内部使用。
使用场景1
将wrapBuilder赋值给globalBuilder,且把MyBuilder作为wrapBuilder参数,用来替代MyBuilder不能直接赋值给globalBuilder。
@Builder
function MyBuilder(value: string, size: number) {
Text(value)
.fontSize(size)
}
let globalBuilder: WrappedBuilder<[string, number]> = wrapBuilder(MyBuilder);
@Entry
@Component
struct Index {
@State message: string = 'Hello World';
build() {
Row() {
Column() {
globalBuilder.builder(this.message, 50)
}
.width('100%')
}
.height('100%')
}
}
使用场景2
自定义组件Index使用ForEach来进行不同@Builder函数的渲染,可以使用builderArr声明的wrapBuilder数组进行不同@Builder函数效果体现。整体代码会较整洁。
@Builder
function MyBuilder(value: string, size: number) {
Text(value)
.fontSize(size)
}
@Builder
function YourBuilder(value: string, size: number) {
Text(value)
.fontSize(size)
.fontColor(Color.Pink)
}
const builderArr: WrappedBuilder<[string, number]>[] = [wrapBuilder(MyBuilder), wrapBuilder(YourBuilder)];
@Entry
@Component
struct Index {
@Builder testBuilder() {
ForEach(builderArr, (item: WrappedBuilder<[string, number]>) => {
item.builder('Hello World', 30)
}
)
}
build() {
Row() {
Column() {
this.testBuilder()
}
.width('100%')
}
.height('100%')
}
}
错误场景
function MyBuilder() {
}
// wrapBuilder必须传入被@Builder修饰的全局函数。
const globalBuilder: WrappedBuilder<[string, number]> = wrapBuilder(MyBuilder);
@Entry
@Component
struct Index {
@State message: string = 'Hello World';
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
globalBuilder.builder(this.message, 30)
}
.width('100%')
}
.height('100%')
}
}

更多推荐


所有评论(0)