HarmonyOS ArkUI 声明式开发实践笔记:组件、状态管理与页面路由
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 里读取。
五、性能与工程化建议
- 列表一定用 LazyForEach 而不是 ForEach 渲染大数据量,前者按需创建、复用组件,内存和首屏都能明显改善。
- 避免在 build() 里做耗时运算,build() 可能被频繁调用,重逻辑应放到 aboutToAppear 或状态更新的回调里。
- 组件拆分要克制,过度拆分会让 @Prop/@Link 的参数链变长,反而增加维护成本。
- 善用 Previewer 快速验证布局,减少真机反复编译的时间。
六、小结
ArkUI 的声明式模型上手不难,真正的门槛在于"状态放哪里、数据怎么流"。把这套心智模型建立起来之后,页面开发会变得非常顺滑。以上是个人实践中的整理,示例代码均在本机 SDK 上验证可运行,供同样学习鸿蒙开发的同学参考。
- 点赞
- 收藏
- 关注作者
评论(0)