ArkTS 自定义组件封装复用实战:从重复代码到可复用组件库

举报
yd_239489350 发表于 2026/11/19 01:36:34 2026/11/19
【摘要】 做鸿蒙应用做到第三个页面时,标题栏、评分、卡片这些 UI 会反复出现:改一个样式要改五六处,漏一处就是样式问题。本文以一个可复用的评分组件为例,讲清 ArkTS 自定义组件封装的思路:什么时候抽组件、参数怎么设计、状态归谁管。 一、什么时候值得封装出现下面三种信号时,再抽也不迟:同一段 UI 在两个以上页面出现;改一个样式要同时改好几处,容易改漏;这个 UI 边界明确,只负责展示和反馈,不掺...

做鸿蒙应用做到第三个页面时,标题栏、评分、卡片这些 UI 会反复出现:改一个样式要改五六处,漏一处就是样式问题。本文以一个可复用的评分组件为例,讲清 ArkTS 自定义组件封装的思路:什么时候抽组件、参数怎么设计、状态归谁管。

一、什么时候值得封装

出现下面三种信号时,再抽也不迟:

  1. 同一段 UI 在两个以上页面出现;
  2. 改一个样式要同时改好几处,容易改漏;
  3. 这个 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 开始,把它抽成组件,页面代码会立刻清爽很多。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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