HarmonyOS 入门实战:用 @State、@Prop 与 @Link 管理 ArkTS 状态
写 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 这些跨层级的状态方案,会顺得多。
- 点赞
- 收藏
- 关注作者
评论(0)