logo
积分中心
鸿蒙UI开发——Builder与LocalBuilder对比
头像 蓝亭书序 2026-11-18 14:12:57    发布
0 浏览 0 收藏

1、概 述

在ArkUI中,有的朋友应该接触过@Builder和@LocalBuilder。其中有了@LocalBuilder的存在,是为了解决组件的父子关系和状态管理的父子关系保持一致的问题。

这里面最直观的表现则是this的指向问题与组件刷新问题,本文对@Builder与@LocalBuilder的这两个问题做简单讨论。

2、引入问题

2.1. this指向问题

有下面一段代码:


class CounterInfo {
  count: number = 0;
}
@Builder
function defaultBuilder() {}

@Entry
@Component
struct Parent {
  label: string = 'parent';
  @State CounterInfo: CounterInfo = { count: 0 };

  @Builder
  componentBuilder($: CounterInfo) {
    Text(`${'this指向: ' + this.label}`);
    Text(`${'count参数: ' + $.count}`).margin(10);
  }
  build() {
    Column() {
      Child({ contentBuilder: this.componentBuilder });
    }
  }
}

@Component
struct Child {
  label: string = 'child';
  @BuilderParam contentBuilder: ((CounterInfo: CounterInfo) => void) = defaultBuilder;
  @State CounterInfo: CounterInfo = { count: 2 };
  build() {
    Column() {
      this.contentBuilder({ count: this.CounterInfo.count });
      Text("本地count: " + this.CounterInfo.count)
      Button("count递增 ").onClick(() => {
        this.CounterInfo.count += 1;
      }).margin(10)
    }.width('100%')
  }
}


界面效果如下(此时停留一下,想想为什么):

图片

接下来,我们将上述代码中的13行,@Builder改为@LocalBuilder,代码将变成如下:


class CounterInfo {
  count: number = 0;
}
@Builder
function defaultBuilder() {}

@Entry
@Component
struct Parent {
  label: string = 'parent';
  @State CounterInfo: CounterInfo = { count: 0 };

  @LocalBuilder
  componentBuilder($: CounterInfo) {
    Text(`${'this指向: ' + this.label}`);
    Text(`${'count参数: ' + $.count}`).margin(10);
  }
  build() {
    Column() {
      Child({ contentBuilder: this.componentBuilder });
    }
  }
}

@Component
struct Child {
  label: string = 'child';
  @BuilderParam contentBuilder: ((CounterInfo: CounterInfo) => void) = defaultBuilder;
  @State CounterInfo: CounterInfo = { count: 2 };
  build() {
    Column() {
      this.contentBuilder({ count: this.CounterInfo.count });
      Text("本地count: " + this.CounterInfo.count)
      Button("count递增 ").onClick(() => {
        this.CounterInfo.count += 1;
      }).margin(10)
    }.width('100%')
  }
}


显示效果将是如何呢?停下来稍微想想。

实际效果如下:

图片

可以看到,我们将@Builder改为@LocalBuilder后,this.label取到的值发生了变化,从原来的child变为了parent,我们可以得到第一个结论:

@LocalBuilder修饰的方法,可以保证该方法的this永远指向最初创建的那个组件实例(在本例子中为parent)

另外,由于count参数和本地count都是2,由于这两个组件不在@LocalBuilder修饰的方法中,因此,this指向的是当前渲染的组件,即 child


2.2. 组件刷新问题

👉🏻 @Builder装饰器

继续上述例子,当我们13行的代码装饰器为@Builder时,点击【count递增】按钮的效果如下:

图片

可以看到,count参数和本地count都发生了刷新。

👉🏻 @LocalBuilder装饰器

此时,我们如果将13行的装饰器改为@LocalBuilder时,点击【count递增】按钮的效果如下:

图片

可以看到,只有本地count发生了刷新,而count参数并没有发生刷新。

❓ 为什么@LocalBuilder装饰器后的count参数不刷新呢?

原因是:@Localbuilder装饰的函数绑定在父组件上,状态变量刷新机制是刷新本组件以及其子组件,对父组件无影响,所以无法引发刷新。而若使用@Builder修饰则可引发刷新,原因是@Builder改变了函数的this指向,此时函数被绑定到子组件上,故能引发UI刷新。


3、总 结

@LocalBuilder与@Builder之处在于:

  1. @LocalBuilder可以保证this永远指向创建该函数的组件,this不会因为传递而发生变化。
  2. 由于状态变量的刷新机制为刷新本组件以及其子组件,因此,当@LocalBuilder被传递到子组件时,由于this指向了父组件,因此,引入入参不会引起组件的刷新。



©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255