ArkUI @Builder:复用不是把代码搬来搬去
【摘要】 今天我们用 @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)