HarmonyOS 入门实战:用 @State、@Prop 与 @Link 管理 ArkTS 状态

举报
yd_274024682 发表于 2026/11/18 23:23:47 2026/11/18
【摘要】 写 ArkTS 界面时,最常遇到的问题是:数据变了,界面为什么没跟着变?答案多半在状态管理上。ArkTS 用装饰器标记哪些数据是"状态",数据一变,依赖它的界面自动刷新。今天讲最常用的三个:@State、@Prop、@Link。 一、@State:组件自己的状态@State 修饰组件内部的状态数据。它的值一变,当前组件就会重新渲染。@Entry@Componentstruct Counter...

写 ArkTS 界面时,最常遇到的问题是:数据变了,界面为什么没跟着变?答案多半在状态管理上。ArkTS 用装饰器标记哪些数据是"状态",数据一变,依赖它的界面自动刷新。今天讲最常用的三个:@State、@Prop、@Link。

一、@State:组件自己的状态

@State 修饰组件内部的状态数据。它的值一变,当前组件就会重新渲染。

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

  build() {
    Column() {
      Text(`当前计数:${this.count}`)
        .fontSize(24)
      Button('加一')
        .onClick(() => {
          this.count++
        })
    }
  }
}

点一下按钮,count 从 0 变成 1,Text 立刻显示新数字。注意两点:@State 只能用在 @Component 修饰的组件里;修改它必须通过 this.count++ 这种赋值方式,直接改它内部属性不会触发刷新。

二、@Prop:父组件传给子组件(单向)

父组件想把数据传给子组件展示,用 @Prop。数据只能从父流向子,子组件里是只读的,改了也不会同步回父组件。

@Component
struct ChildLabel {
  @Prop label: string

  build() {
    Text(this.label)
      .fontSize(18)
  }
}

父组件这样用:ChildLabel({ label: '你好,HarmonyOS' })。@Prop 适合传标题、配置、展示用的文案这类"传下去就不用再改"的数据。

三、@Link:父子双向同步

如果子组件也要改这个数据,并且希望父组件同步更新,就用 @Link。父组件传的时候要在变量前加 $ 符号,表示建立双向绑定。

@Component
struct ChildCounter {
  @Link count: number

  build() {
    Column() {
      Text(`子组件里的计数:${this.count}`)
      Button('子组件加一')
        .onClick(() => {
          this.count++
        })
    }
  }
}

父组件里写 ChildCounter({ count: $count })。这时不管在父组件还是子组件里点加一,两边的数字都会一起变,因为它们指向的是同一份状态。

四、完整可运行示例

把三者拼在一个页面里,对照看最清楚:

@Entry
@Component
struct StateDemoPage {
  @State count: number = 0

  build() {
    Column({ space: 16 }) {
      Text(`父组件计数:${this.count}`)
        .fontSize(22)
      ChildCounter({ count: $count })
      ChildLabel({ label: `当前是第 ${this.count} 次` })
      Button('父组件加一')
        .onClick(() => {
          this.count++
        })
    }
    .width('100%')
    .padding(20)
  }
}

@Component
struct ChildCounter {
  @Link count: number

  build() {
    Column({ space: 8 }) {
      Text(`子组件计数:${this.count}`)
        .fontSize(18)
      Button('子组件加一')
        .onClick(() => {
          this.count++
        })
    }
  }
}

@Component
struct ChildLabel {
  @Prop label: string

  build() {
    Text(this.label)
      .fontSize(18)
      .fontColor('#666666')
  }
}

把这段代码放进新工程的 Index.ets 里替换原有内容,运行后点一点两个加一按钮,就能看到:父组件加一,三个地方的数字都变;子组件加一,同样全都变;只有 @Prop 传过去的那行文字是跟着父组件单向变的。

五、怎么选?记住一张表

装饰器 数据归谁 能改吗 适用场景
@State 自己持有 自己改 组件内部的计数、开关、输入内容
@Prop 父组件持有 子组件只读 传标题、配置、展示文案
@Link 父组件持有 父子都能改 子组件要回写的状态,如弹窗开关、表单值

新手最容易踩的坑有三个:第一,在子组件里改 @Prop 的值,以为父组件会跟着变,结果不会;第二,传 @Link 时漏了 $,写成 count: this.count,双向绑定就没建立;第三,把 @State 写在普通类里而不是组件里,刷新不生效。

状态管理是 ArkTS 开发的地基。先把 @State、@Prop、@Link 这三个用熟,后面再学 @Provide/@Consume、@Observed 这些跨层级的状态方案,会顺得多。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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