HarmonyOS @builder方法的ui不刷新？

Question

@Entry
@Component
export struct AAMainPage {
  // ViewB中有@State装饰的ClassA[]
  @State arrA: ClassA[] = [new ClassA(0), new ClassA(0)];

  build() {
    Column() {

      hahah({ a: this.arrA[0] })

      ForEach(this.arrA, (item: ClassA, index: number) => {
        hahah({ a: item }).backgroundColor('red')
      }, (item: ClassA, index: number) => index + "")

      this.testBuilder(this.arrA[0])

      Button(`ViewB:  item property in middle`)
        .width(320)
        .margin(10)
        .onClick(() => {
          this.arrA[0].c = 10;
        })
    }
  }

  @Builder
  testBuilder($$: ClassA) {
    Text($$.c + " builder")
  }
  // @Builder
  // testBuilder(a: ClassA) {
  //   Text(a.c + " builder")
  // }
}

@Preview
@Component
export struct hahah {
  @ObjectLink a: ClassA
  build() {
    Text(this.a.c + " 123213")
  }
}
let NextID: number = 1;

@Observed
class ClassA {
  public id: number;
  public c: number;

  constructor(c: number) {
    this.id = NextID++;
    this.c = c;
  }
}

Answer 1

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

详见：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-builder-V5\#参数传递规则

修改建议：

@Entry
@Component
export struct AAMainPage {
  // ViewB中有@State装饰的ClassA[]
  @State arrA: ClassA[] = [new ClassA(2),new ClassA(3)];
  @State changeNum: number = 0


  build() {
    Column() {

      hahah({ a: this.arrA[0] })

      ForEach(this.arrA, (item: ClassA, index: number) => {
        hahah({ a: item }).backgroundColor('red')
      }, (item: ClassA, index: number) => index + JSON.stringify(item))

      testBuilder({c:this.changeNum})
      Button(`ViewB: chg item property in middle`)
        .width(320)
        .margin(10)
        .onClick(() => {
          this.arrA[0].c = 10;
          this.changeNum = this.arrA[0].c
          console.log('cccc-',JSON.stringify(this.arrA))
        })
    }
  }


  // @Builder
  // testBuilder(a: ClassA) {
  // Text(a.c + " builder")
  // }
}

@Builder function testBuilder($$: ClassB) {
  Text($$.c + " builder")
}


@Observed
class ClassA {
  id: number = 0;
  c: number = 0;

  constructor(c: number) {
    this.id = Math.random();
    this.c = c;
  }
}

class ClassB {
  c: number = 0
}

@Component
struct hahah {
  @ObjectLink a: ClassA
  build() {
    Text(this.a.c + " 123213")
  }
}

目前@Builder设计模式是这样，刷新内容必须用引用传递。示例中的@observed 修饰的实体类采用了构造方法，不能作为引用传递。只要是引用传递就可以，不一定非要$$。按引用传递参数时，如果在@Builder方法内调用自定义组件，ArkUI提供$$作为按引用传递参数的范式。如果在@Builder方法内调用自定义组件或者其他@Builder方法，ArkUI提供$$作为按引用传递参数的范式。