ArkTS 状态管理入门:@State、@Prop、@Link 各自解决什么问题

举报
yd_49982434 发表于 2026/11/05 12:07:37 2026/11/05
【摘要】 在 ArkUI 里写页面,最容易出问题的地方往往不是布局,而是“数据变了,界面却没变”。ArkTS 用一组装饰器把状态和视图刷新绑定起来,入门阶段最常用的三个是 @State、@Prop、@Link,它们解决的是三种不同的数据流向问题。一、@State:组件自己的状态@State 修饰的变量属于当前组件的内部状态。它变化时,只有使用它的这个组件会重新渲染。@Entry@Componentst...

在 ArkUI 里写页面,最容易出问题的地方往往不是布局,而是“数据变了,界面却没变”。ArkTS 用一组装饰器把状态和视图刷新绑定起来,入门阶段最常用的三个是 @State、@Prop、@Link,它们解决的是三种不同的数据流向问题。


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


@State 修饰的变量属于当前组件的内部状态。它变化时,只有使用它的这个组件会重新渲染。


@Entry

@Component

struct Counter {

  @State count: number = 0

  build() {

    Column() {

      Text(`当前计数:${this.count}`)

      Button('加一').onClick(() => { this.count++ })

    }

  }

}


判断依据很简单:这份数据只由本组件维护,外界不需要知道,就用 @State。


二、@Prop:父组件传给子组件的单向副本


@Prop 用于父组件向子组件传值,方向是单向的:父组件的数据变化会同步到子组件,但子组件内部修改 @Prop 不会回写到父组件。它接收的是一份拷贝,因此适合传简单类型或不需要回传的小对象。


@Component

struct Label {

  @Prop text: string = ''

  build() { Text(this.text) }

}


需要强调的是“拷贝”这件事:子组件改 @Prop 只是改自己手里那份,父组件毫无感知。


三、@Link:与父组件共享同一份数据


@Link 是双向的:子组件修改它,父组件的数据源同步变化。使用时有两个约束:一是父组件传进来的必须是 @State、@Link 这类可以被引用的数据源,传常量会编译报错;二是子组件不能自己给 @Link 赋初值。


@Component

struct Stepper {

  @Link value: number

  build() {

    Row() {

      Button('-').onClick(() => { this.value-- })

      Text(`${this.value}`)

      Button('+').onClick(() => { this.value++ })

    }

  }

}


父组件里这样调:Stepper({ value: $count }),$ 前缀表示传引用而不是传值,这是 @Link 能双向同步的前提。


四、三者怎么选


数据只在本组件用,选 @State;子组件只负责显示、不需要改父组件数据,选 @Prop;子组件要改父组件的数据,选 @Link。兄弟组件之间需要共享时,把这部分状态提升到共同的父组件,再用 @Link 往下传,或者干脆用 AppStorage 做应用级共享。


五、一个容易忽略的坑


@State 观察的是变量本身是否被整体替换或赋值。如果状态是一个对象,只改它的某个属性,比如 this.user.name = 'x',界面可能不刷新。这种情况需要用 @Observed 修饰类,并在子组件用 @Obj


写在最后


这三个装饰器的核心区别其实就一个词:数据流向。搞清楚“谁拥有这份数据、谁能改它”,选型时就不会犹豫。


(说明:本文整理过程中使用了 AI 辅助,内容与实际 API 用法已由本人核对。)ectLink 接收,才能观察到对象内部属性的变化。很多人误以为是双向绑定,改了半天父页面没反应,就是踩在这里。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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