【鸿蒙实战开发】@Builder装饰器：如何自定义构建函数

● 允许在自定义组件内定义一个或多个@Builder方法。

●自定义构建函数可以在所属组件的build方法和其他自定义构建函数中调用，但不允许在组件外调用。

●在自定义函数体中，this指代当前所属组件，组件的状态变量可以在自定义构建函数内访问。建议通过this访问自定义组件的状态变量而不是参数传递。

定义：

@Builder function MyGlobalBuilderFunction() { … }

使用：

MyGlobalBuilderFunction()

按引用传递参数（状态变量的改变会引起UI刷新）
按引用传递参数时，传递的参数可为状态变量，且状态变量的改变会引起@Builder方法内的UI刷新。

class Tmp {
  paramA1: string = ''
}
 
@Builder function overBuilder(params: Tmp) {
  Row() {
    Text(`UseStateVarByReference: ${params.paramA1} `)
  }
}
@Entry
@Component
struct Parent {
  @State label: string = 'Hello';
  build() {
    Column() {
      // 传递this。当在父组件中调用overBuilder组件时，标记对overBuilder组件的引用。
      overBuilder({ paramA1: this.label })
      Button('Click me').onClick(() => {
        // 单击Click me后，UI文本从Hello变为ArkUI
        this.label = 'ArkUI';
      })
    }
  }
}

如果在@Builder方法内调用自定义组件，ArkUI提供$作为按引用传递参数的范式。

class Tmp {
  paramA1: string = ''
}
 
@Builder function overBuilder($$: Tmp) {
  Row() {
    Column() {
      Text(`overBuilder===${$$.paramA1}`)
      HelloComponent({message: $$.paramA1})
    }
  }
}
 
@Component
struct HelloComponent {
  @Link message: string;
 
  build() {
    Row() {
      Text(`HelloComponent===${this.message}`)
    }
  }
}
 
@Entry
@Component
struct Parent {
  @State label: string = 'Hello';
  build() {
    Column() {
      // Pass the this.label reference to the overBuilder component when the overBuilder component is called in the Parent component.
      overBuilder({paramA1: this.label})
      Button('Click me').onClick(() => {
        // After Click me is clicked, the UI text changes from Hello to ArkUI.
        this.label = 'ArkUI';
      })
    }
  }
}

按值传递参数（状态变量的改变不会引起UI刷新）
调用@Builder装饰的函数默认按值传递。当传递的参数为状态变量时，状态变量的改变不会引起@Builder方法内的UI刷新。所以当使用状态变量的时候，推荐使用按引用传递，

@Builder function overBuilder(paramA1: string) {
  Row() {
    Text(`UseStateVarByValue: ${paramA1} `)
  }
}
@Entry
@Component
struct Parent {
  @State label: string = 'Hello';
  build() {
    Column() {
      overBuilder(this.label)
    }
  }
}

写在最后

●如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我两个小忙：
●点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
●关注小编，同时可以期待后续文章ing ，不定期分享原创知识。