ArkUI @Builder:复用不是把代码搬来搬去

举报
蓝瘦的蜕变 发表于 2026/11/16 22:46:39 2026/11/16
【摘要】 今天我们用 @Builder 把页面里的小片段收起来。 @Builder 很适合整理页面内部的小结构,比如区块标题、信息行、静态说明卡片。它比自定义组件轻,但也别把它当万能组件。尤其是动态状态刷新,不要随手塞进多参数 Builder 里。 这个 Demo 看什么 页面里有三个局部 @Builder: SectionTi

ArkUI @Builder:复用不是把代码搬来搬去

今天我们用 @Builder 把页面里的小片段收起来。

@Builder 很适合整理页面内部的小结构,比如区块标题、信息行、静态说明卡片。它比自定义组件轻,但也别把它当万能组件。尤其是动态状态刷新,不要随手塞进多参数 Builder 里。

这个 Demo 看什么

页面里有三个局部 @Builder:

  • SectionTitle:统一区块标题和说明。
  • InfoRow:统一一行说明和结果。
  • StaticNoteCard:统一静态提示卡片。

这些片段都只服务当前页面。我们没有把它们赋值给变量,也没有拿它们做复杂动态切换。

这就是本篇想表达的边界:@Builder 先用来整理 UI 片段,不要一开始就把它写成状态管理方案。

你平时最常复制的是标题区、表单行,还是卡片外壳?这种重复片段就很适合先用 @Builder 收一下。

完整代码

@Entry
@Component
struct ArkUIBuilderDemo {
  @Builder
  HeaderBlock() {
    Column({ space: 8 }) {
      Text('ArkUI @Builder')
        .fontSize(28)
        .fontWeight(700)
        .fontColor('#111827')
      Text('复用不是把代码搬来搬去')
        .fontSize(16)
        .fontColor('#4B5563')
      Text('@Builder 适合把一小段 UI 结构收起来。它不是组件,也不负责状态管理;我们先用它整理标题、信息行和静态卡片。')
        .fontSize(14)
        .fontColor('#6B7280')
        .lineHeight(22)
    }
    .width('100%')
    .alignItems(HorizontalAlign.Start)
  }

  @Builder
  SectionTitle(title: string, desc: string) {
    Column({ space: 6 }) {
      Text(title)
        .fontSize(19)
        .fontWeight(700)
        .fontColor('#111827')
      Text(desc)
        .fontSize(13)
        .fontColor('#6B7280')
        .lineHeight(20)
    }
    .width('100%')
    .alignItems(HorizontalAlign.Start)
  }

  @Builder
  InfoRow(labelText: string, valueText: string, accentColor: string) {
    Row({ space: 12 }) {
      Text(labelText)
        .fontSize(14)
        .fontColor('#6B7280')
        .layoutWeight(1)
      Text(valueText)
        .fontSize(14)
        .fontWeight(700)
        .fontColor(accentColor)
    }
    .width('100%')
    .padding({ top: 10, bottom: 10 })
    .border({ width: { bottom: 1 }, color: '#E5E7EB' })
  }

  @Builder
  StaticNoteCard(title: string, desc: string, accentColor: string) {
    Column({ space: 8 }) {
      Text(title)
        .fontSize(17)
        .fontWeight(700)
        .fontColor(accentColor)
      Text(desc)
        .fontSize(14)
        .fontColor('#4B5563')
        .lineHeight(21)
    }
    .width('100%')
    .padding(16)
    .borderRadius(16)
    .backgroundColor('#FFFFFF')
    .border({ width: 1, color: '#E5E7EB' })
    .alignItems(HorizontalAlign.Start)
  }

  build() {
    Scroll() {
      Column({ space: 22 }) {
        this.HeaderBlock()

        this.SectionTitle('先抽小片段', '标题、说明、信息行这种小结构,放进 @Builder 后页面会清爽很多。')
        Column({ space: 0 }) {
          this.InfoRow('适合场景', '重复 UI 片段', '#2563EB')
          this.InfoRow('不适合场景', '复杂状态组件', '#B45309')
          this.InfoRow('本篇重点', '静态结构复用', '#0F766E')
        }
        .width('100%')
        .padding({ left: 16, right: 16 })
        .borderRadius(16)
        .backgroundColor('#FFFFFF')
        .border({ width: 1, color: '#E5E7EB' })

        this.SectionTitle('再抽卡片片段', '如果只是同一段说明样式重复出现,@Builder 比新建组件更轻。')
        this.StaticNoteCard('别在 @Builder 里讲状态', '多参数 @Builder 不适合承载动态状态刷新。动态文本直接在 build() 里读状态,或者等状态章节再处理。', '#7C3AED')
        this.StaticNoteCard('别把 @Builder 当组件库', '@Builder 更像页面内部的小模板。跨页面复用、生命周期和复杂参数,优先考虑自定义组件。', '#0F766E')
      }
      .width('100%')
      .padding(24)
      .alignItems(HorizontalAlign.Start)
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F8FAFC')
  }
}
【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。