鸿蒙应用开发入门(二):跨组件传状态与页面跳转,给签到页加一个记录页
鸿蒙应用开发入门(二):跨组件传状态与页面跳转,给签到页加一个记录页
上一篇用二十多行代码跑通了一个签到页:点一下按钮,状态翻转,界面跟着变。今天接着往下走两步,给它加一个签到记录页:首页点签到,跳转到记录页能看到当天状态,返回后状态还在。这两步正好覆盖 ArkTS 里最常用的两个能力:跨组件传状态,和多页面跳转。
一、@State、@Prop、@Link 分工不同
上一篇只用了 @State:状态存在组件自己内部,自己改、自己用。页面一拆成多个组件,就不够用了。
- @State:组件自己的状态,改了只刷新自己。
- @Prop:父组件传给子组件的单向数据。子组件能读,但改了不会同步回父组件,适合只展示不修改的数据,比如把签到日期传给子组件显示。
- @Link:父子组件共享的双向数据。子组件改了,父组件里的值也跟着变,适合子组件要改状态的场景,比如把“已签到”做成一个独立的签到按钮组件,按钮自己改状态,首页的文案也同步变。
新手最容易混的是 @Prop 和 @Link:只读用 @Prop,要回写就用 @Link。选错了的表现很典型:子组件里改了值,父组件纹丝不动。
二、把签到按钮拆成子组件
把昨天的按钮抽出来,状态用 @Link 和父组件共享:
@Component
struct SignButton {
@Link signed: boolean
build() {
Button(this.signed ? '已签到' : '立即签到')
.enabled(!this.signed)
.onClick(() => {
this.signed = true
})
}
}
@Entry
@Component
struct SignInPage {
@State signed: boolean = false
build() {
Column() {
Text('今日签到')
.fontSize(24)
.fontWeight(FontWeight.Bold)
SignButton({ signed: $signed })
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
}
}
注意父组件传参时写的是 $signed,不是 signed:带 $ 表示传的是状态的引用,子组件改的就是父组件那一份。漏了 $,@Link 收到的只是一个普通值,改了也不会同步。
三、用 Navigation 做页面跳转
有了两个页面,就需要路由。ArkUI 推荐用 Navigation 组件做页面栈管理,比直接换 @Entry 的写法更适合多页面应用。
思路很简单:首页放一个 Navigation,签到按钮旁边再加一个“查看记录”按钮,点一下把记录页 push 进页面栈;记录页显示当天的签到状态,左上角的返回按钮自动帮你 pop 回首页,状态还在,因为首页的 @State 没有被销毁重建。
@Entry
@Component
struct MainPage {
@State signed: boolean = false
@State pathStack: NavPathStack = new NavPathStack()
build() {
Navigation(this.pathStack) {
Column() {
Text('今日签到').fontSize(24).fontWeight(FontWeight.Bold)
SignButton({ signed: $signed })
Button('查看签到记录')
.onClick(() => {
this.pathStack.pushPath({ name: 'RecordPage', param: this.signed })
})
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
}
.title('签到')
.navDestination((info: NavPathInfo) => {
if (info.name === 'RecordPage') {
RecordPage({ signed: info.param as boolean })
}
})
}
}
记录页用 @Prop 接首页传来的签到状态,只展示不修改:
@Component
struct RecordPage {
@Prop signed: boolean
build() {
Column() {
Text(this.signed ? '今日已签到' : '今日尚未签到')
.fontSize(20)
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
}
}
四、三个容易踩的坑
一是跨组件传状态记得加 $。@Link、@Prop 传参时漏了 $,子组件拿到的就是快照,改了不同步,这是拆组件后最常见的“改了没反应”。
二是页面栈要共用一个 NavPathStack。每个页面各建一个栈,push 和 pop 就对不上了,跳转会乱。做法是栈放在入口页,跳转时调用同一个实例的 pushPath。
三是返回后状态丢失别急着怪路由。先看状态存在哪一层:存在首页的 @State 里,返回后还在;存在记录页自己的 @State 里,页面 pop 掉就没了。需要跨页面保留的数据,往上放到公共的父组件或应用级状态里。
五、下一步学什么
状态和路由跑通后,一个应用的骨架就有了。接下来建议接网络请求和本地数据库:把签到动作换成一次真实的接口调用,把结果写进本地存储,下次打开应用还能看到昨天的记录。鸿蒙官方案例库里有端云一体的完整示例,照着改一遍,比只看文档快得多。
从一个能点、能变的页面,到一个能跳转、能传状态的小应用,只差 @Link 和 Navigation 这两步。今天花一个下午把记录页加上,你的签到 App 就已经像一个真正的应用了。
- 点赞
- 收藏
- 关注作者
评论(0)