目录

如何解决使用@State修饰对象数组,数据变化时页面不刷新问题

问题现象

背景知识

解决方案

@State装饰的变量可以观察到简单类型的变量值变化,在状态管理V1中要想观察到Class中对象类型的某个属性的变化,可以使用@Observed/@ObjectLink装饰器。同时,需要注意是否违背装饰器的限制条件,以及是否违背其它组件原则,常见问题现象总结及解决方案如下:

场景

场景描述

解决方案

场景一

使用@State修饰对象数组,未使用@Observed/@ObjectLink装饰器进行深度观测,所以修改深层属性时,页面不刷新。

使用@Observed修饰类,使用@ObjectLink在子组件中接收需要深层观测的对象,且该对象若想要被深度观测必须使用new操作符实例化。

场景二

使用了@Observed/@ObjectLink装饰器进行深度观测,由于@ObjectLink只能观察一层属性导致的页面不刷新。

@ObjectLink仅能观察其代理的属性,无法观察到代理属性的嵌套对象属性,所以每一层被嵌套的对象都需要封装一个子组件并用@ObjectLink接收。

场景三

使用了@Observed/@ObjectLink装饰器进行深度观测,由于ForEach首次渲染与非首次渲染引起的页面不刷新。

应尽量避免状态管理的对象深层嵌套的属性刷新与ForEach针对数组变化的首次渲染刷新,若无法避免可采用以下两种方式解决:

1. 重写系统默认的keyGenerator参数生成规则,加入每次修改的当前时间等唯一性的参数,保证前后两次依靠ForEach首次渲染刷新时,keyGenerator不会重复。

2. 不重写系统默认的keyGenerator参数生成规则,给对象数组的每一个对象添加一个唯一的id标识,保证前后两次依靠ForEach首次渲染刷新时,keyGenerator不会重复。

常见FAQ

Q:@ObjectLink装饰器是否能在@Entry装饰的自定义组件中使用?

A:@ObjectLink装饰器是不能在@Entry装饰的自定义组件中使用,且需要搭配@Observed装饰器一起使用。

Q:定义变量来保存图片src参数,在onClick方法中修改src参数,不生效未触发UI渲染,该怎么处理?

A:可以确认下保存参数的变量是否使用@State进行装饰,未使用@State装饰器,修改src值是不会生效的。

Q:@State和@Local使用有什么区别?

A:可以参考@Local与@State对比,@Local装饰器使用参考@Local装饰器,@State装饰器的使用参考@State装饰器。

Q:对象在UI中刷新渲染是否需要添加@Observed/@ObservedV2装饰器?

A:如果不涉及深度观测,只涉及对象本身的改变,可以不添加@Observed/@ObservedV2装饰器。

Q:嵌套对象中未被@Track装饰器装饰的属性无法刷新UI?

A:是的,如果Class类中使用了@Track装饰器,则未被@Track装饰器装饰的属性不能在UI中使用,如果使用,会发生运行时报错。

Q:@State可以标识基本数据类型的数组,是否可以监听数组的增删?

A:@State可以监听数组的增删,实现UI刷新。

总结

  1. @State装饰器仅能观察到第一层的变化。对于多层嵌套的情况,比如对象数组等,他们的第二层的属性变化是无法观察到的。@Observed装饰的类,可以观察到属性的变化;@ObjectLink装饰器装饰的状态变量用于接收@Observed装饰的类的实例,和父组件中对应的状态变量建立双向数据绑定。使用时应遵循对应装饰器在官方指南的使用限制。
  2. 当数据是对象数组时,若存在状态管理的对象深层嵌套的属性刷新与ForEach针对数组变化的首次渲染刷新时,应尽量避免使用两种方式交替刷新UI。若无法避免可重写系统默认的keyGenerator参数,加入每次修改的当前时间等唯一性的参数,保证前后两次依靠ForEach首次渲染刷新时,keyGenerator不会重复。