鸿蒙 ArkTS 状态管理避坑手记:嵌套对象改了界面却不动
最近在写一个鸿蒙应用时,遇到一个让人怀疑人生的现象:点击按钮后,日志里明明看到数据已经变了,界面却纹丝不动。反复检查了好几遍点击逻辑都没有问题,最后发现,问题出在状态管理的一个细节上:嵌套对象的属性变化,没有走进 ArkUI 的观测链。
一、先复现:几行代码就能踩坑
假设要做一个玩家等级面板,等级和经验值放在一个类里:
class Player {
level: number = 1
exp: number = 0
}
页面里这样用:
@State player: Player = new Player()
build() {
Column() {
Text('等级:' + this.player.level)
Button('升级')
.onClick(() => {
this.player.level = this.player.level + 1
})
}
}
运行后点升级按钮,等级数字大概率不会变。但如果在点击处理里打印一下,会发现等级确实已经加一了。数据变了,界面没变,这就是典型的观测失效。
二、为什么会这样
ArkUI 的状态观测有一个基本规则:它观测的是被装饰器标记的状态变量本身,而不是变量内部的每一个字段。
@State 标记的是 player 这个变量。当整个 player 被替换成一个新对象时,框架能感知到变化,于是刷新界面。但当我们只改 player 内部的 level 字段时,player 这个变量本身并没有变,框架也就收不到通知。
换句话说,普通类在 ArkUI 眼里是一个黑盒子,框架不知道它内部发生了什么。想要让框架感知到嵌套属性的变化,就要把这个类也变成可观测的。
三、修复方法:给嵌套类加上观测装饰器
正确的做法分两步。第一步,给嵌套的类加上 @Observed:
@Observed
class Player {
level: number = 1
exp: number = 0
}
第二步,如果子组件需要接收这个对象,不要用普通的属性传递,改用 @ObjectLink:
@Component
struct LevelCard {
@ObjectLink player: Player
build() {
Column() {
Text('等级:' + this.player.level)
Text('经验:' + this.player.exp)
}
}
}
父组件里这样传:
@State player: Player = new Player()
build() {
Column() {
LevelCard({ player: this.player })
Button('升级')
.onClick(() => {
this.player.level = this.player.level + 1
})
}
}
这样一改,点击升级后界面立刻跟着刷新。因为 @Observed 让框架能够追踪对象内部属性的变化,而 @ObjectLink 则在父子组件之间建立了同一份数据的观测链。
四、容易一起踩的三个坑
第一个坑:数组里装对象。直接修改数组中某个对象的属性,界面常常不刷新。稳妥的办法是让数组元素的类也加上 @Observed,或者把改完的元素重新赋值回数组对应位置,触发一次整体变化。
第二个坑:多层嵌套。对象里再套对象时,每一层用于承载数据的类都要是可观测的。只要中间有一层是普通类,观测链就会在那一层断掉,底层的变化传不上来。
第三个坑:把状态到处复制。把 player 赋值给另一个普通变量再去修改,改的是另一份引用关系之外的副本,界面自然不会动。状态应当只有一个来源,修改也要沿着可观测的链路进行。
五、排查清单
下次再遇到数据变了界面不动的情况,可以按这个顺序排查:
- 承载数据的类有没有加上 @Observed
- 子组件接收对象时用的是 @ObjectLink 还是普通属性
- 修改的是整个状态变量,还是只改了它的某个字段
- 嵌套是否超过一层,每一层是否都是可观测的
- 状态是否被复制到了别处,改的到底是不是同一份数据
一般查到第二步,问题就已经定位了。
六、小结
ArkUI 的状态管理并不复杂,核心就一条规则:框架只观测它看得见的变化。简单场景可以直接替换整个对象,复杂场景则要给嵌套类加上 @Observed,并用 @ObjectLink 在组件之间传递。理解了观测链的概念,这类界面不同步的问题基本都能在几分钟内定位。
- 点赞
- 收藏
- 关注作者
评论(0)