HarmonyOS ArkUI 声明式开发实践笔记:组件、状态管理与页面路由

举报
yd_238692410 发表于 2026/11/08 10:14:10 2026/11/08
【摘要】 ArkUI 声明式开发实践笔记:从命令式到声明式的思路转变,@State/@Prop/@Link 状态管理分层,router 页面路由与参数传递,以及 LazyForEach、build() 性能优化等工程化建议。

HarmonyOS ArkUI 声明式开发实践笔记:组件、状态管理与页面路由

一、从命令式到声明式

做过 Android 或前端开发的同学,第一次接触 ArkUI 时最直观的感受是:界面不再是"找到控件、修改属性",而是"描述状态、界面自动跟随"。ArkUI 采用声明式范式,开发者用 build() 描述某一时刻 UI 应该长什么样,框架负责在状态变化时做最小化刷新。这种思路把"如何更新界面"的负担从业务代码里剥离出来,代码量往往能少一半。

二、一个最小可运行页面

下面是一个用 ArkUI(ArkTS)写的计数器,展示了声明式 UI 的基本结构:状态用 @State 修饰,界面在 build() 里描述,交互通过事件回调修改状态。

@Entry
@Component
struct CounterPage {
  @State count: number = 0;

  build() {
    Column({ space: 16 }) {
      Text(`当前计数:${this.count}`)
        .fontSize(24)
        .fontWeight(FontWeight.Bold)

      Row({ space: 12 }) {
        Button('-1')
          .onClick(() => { if (this.count > 0) this.count--; })
        Button('+1')
          .onClick(() => { this.count++; })
      }
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
  }
}

这里的关键点:count 变化后不需要手动去 setText,框架会发现依赖 count 的 Text 组件并只刷新它。这就是声明式 UI 的核心收益——开发者维护的是"数据与界面的映射关系",而不是一条条 UI 指令。

三、状态管理的层次

实际项目里状态是有层次的,ArkUI 提供了一组装饰器来区分:

装饰器 作用范围 典型场景
@State 组件内部 组件私有、会变化的 UI 数据
@Prop 父到子单向 子组件只读的入参
@Link 父子双向 父子需要共同修改的字段
@Provide / @Consume 跨层级 深层组件共享,避免层层透传
@Observed / @ObjectLink 对象内部 监听对象属性变化

我在实践中的经验是:能用 @State 就别升级到 @Provide,状态尽量靠近使用它的组件。跨层级共享虽然方便,但会让数据流向变模糊,后期排查 bug 成本高。

四、页面路由与参数传递

页面跳转使用 router,配合参数对象传递数据:

import router from '@ohos.router';

// 跳转并带参
router.pushUrl({
  url: 'pages/DetailPage',
  params: { id: 42, title: '实践笔记' }
});

// 目标页取参
const params = router.getParams() as Record<string, Object>;

注意 getParams() 返回的是 Object,取字段时要做类型断言,否则编译器会报错。路由返回用 router.back(),如果需要在返回时回传结果,可以在 pop 时附带参数并在原页面的 onPageShow 里读取。

五、性能与工程化建议

  1. 列表一定用 LazyForEach 而不是 ForEach 渲染大数据量,前者按需创建、复用组件,内存和首屏都能明显改善。
  2. 避免在 build() 里做耗时运算,build() 可能被频繁调用,重逻辑应放到 aboutToAppear 或状态更新的回调里。
  3. 组件拆分要克制,过度拆分会让 @Prop/@Link 的参数链变长,反而增加维护成本。
  4. 善用 Previewer 快速验证布局,减少真机反复编译的时间。

六、小结

ArkUI 的声明式模型上手不难,真正的门槛在于"状态放哪里、数据怎么流"。把这套心智模型建立起来之后,页面开发会变得非常顺滑。以上是个人实践中的整理,示例代码均在本机 SDK 上验证可运行,供同样学习鸿蒙开发的同学参考。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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