ArkTS 状态管理入门:@State、@Prop、@Link 各自解决什么问题
在 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 接收,才能观察到对象内部属性的变化。很多人误以为是双向绑定,改了半天父页面没反应,就是踩在这里。
- 点赞
- 收藏
- 关注作者
评论(0)