鸿蒙应用开发入门(二):跨组件传状态与页面跳转,给签到页加一个记录页

举报
yd_224991768 发表于 2026/11/11 09:36:47 2026/11/11
【摘要】 鸿蒙应用开发入门(二):跨组件传状态与页面跳转,给签到页加一个记录页上一篇用二十多行代码跑通了一个签到页:点一下按钮,状态翻转,界面跟着变。今天接着往下走两步,给它加一个签到记录页:首页点签到,跳转到记录页能看到当天状态,返回后状态还在。这两步正好覆盖 ArkTS 里最常用的两个能力:跨组件传状态,和多页面跳转。 一、@State、@Prop、@Link 分工不同上一篇只用了 @State...

鸿蒙应用开发入门(二):跨组件传状态与页面跳转,给签到页加一个记录页

上一篇用二十多行代码跑通了一个签到页:点一下按钮,状态翻转,界面跟着变。今天接着往下走两步,给它加一个签到记录页:首页点签到,跳转到记录页能看到当天状态,返回后状态还在。这两步正好覆盖 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 就已经像一个真正的应用了。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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