ArkTS 自定义组件封装复用实战:从重复代码到可复用组件库
做鸿蒙应用做到第三个页面时,标题栏、评分、卡片这些 UI 会反复出现:改一个样式要改五六处,漏一处就是样式问题。本文以一个可复用的评分组件为例,讲清 ArkTS 自定义组件封装的思路:什么时候抽组件、参数怎么设计、状态归谁管。
一、什么时候值得封装
出现下面三种信号时,再抽也不迟:
- 同一段 UI 在两个以上页面出现;
- 改一个样式要同时改好几处,容易改漏;
- 这个 UI 边界明确,只负责展示和反馈,不掺和业务请求。
只用一次、业务逻辑又很重的界面不要急着抽,过早抽象反而更难维护。
二、三条设计原则
第一,职责单一。 评分组件只负责展示分数和接收点击,不拉取数据,也不提交评分。数据从哪里来、点完做什么,交给页面。
第二,参数用 @Prop 传入,事件用回调传出。 分数通过 @Prop 传入;点击通过回调通知父组件。组件不持有业务状态,传不同参数就有不同表现。
第三,样式可配置。 颜色、尺寸留出参数,但都要有默认值,不传参数也能正常工作。
三、实战:封装评分组件
下面是一个可交互的评分组件:
@Component
export struct RatingView {
@Prop score: number = 0
onChange?: (score: number) => void
build() {
Row({ space: 4 }) {
ForEach([0, 1, 2, 3, 4], (index: number) => {
Text(index < this.score ? '★' : '☆')
.fontSize(20)
.fontColor(index < this.score ? '#FFB300' : '#CCCCCC')
.onClick(() => { this.onChange?.(index + 1) })
})
}
}
}
要点:score 用 @Prop 修饰,单向数据流,只读不改;星星用 ForEach 生成,选中与未选中用不同字符和颜色区分;点击时调用 onChange 回调把新分数告诉父组件,状态仍由父组件持有。
四、在页面中复用
页面里把父组件的 @State 传给子组件的 @Prop,子组件点击后通过 onChange 回调传回新值,父组件更新 @State,界面自动刷新。同一个组件可以放进商品卡片、课程详情、评价列表,传不同分数即可;还能再和标题、价格组合成商品卡片组件,逐层复用。
五、常见坑
第一,不要在子组件里直接改 @Prop 的值,它是单向的,要通过回调让父组件改。第二,不要把网络请求写进展示组件,请求放在页面或数据层。第三,不要让组件依赖全局状态,所有输入都通过参数进来,行为才可预测,也方便测试。
结语
封装的本质,是把变化的部分留给调用方,把不变的部分沉淀下来。先判断值不值得抽,再用 @Prop 传参、用回调传事件,最后在真实页面里验证两次。从下一个重复出现的 UI 开始,把它抽成组件,页面代码会立刻清爽很多。
- 点赞
- 收藏
- 关注作者
评论(0)