ArkUI @Reusable 组件复用避坑,列表滚动偶发状态错乱
很多同学用上 @Reusable 之后,滚动列表时不时出现数据串位、旧状态残留,以为是 LazyForEach 的 bug,其实是复用组件没有做好状态清理。本文带大家理清复用时机、重置逻辑,附上可直接使用的代码。
很多人开启组件复用只写一个 @Reusable,忽略一个核心事实:组件实例不会销毁,只是回收进复用池,上次留在里面的输入框内容、开关选中、动画状态会保留到下一条数据。
核心规则:
aboutToReuse:取出复用实例,接收新数据;aboutToRecycle:组件回收入池,在这里清理临时状态。
@Reusable
@Component
struct ListItemCard {
@State toggleOn: boolean = false
@Prop title: string = ""
aboutToReuse(params: Record<string, ESObject>) {
// 载入新业务数据
this.title = params.title as string
// 不要在这里重置 toggle,业务按需处理
}
aboutToRecycle() {
// 回收时清空易残留临时状态
this.toggleOn = false
}
build() {
Row() {
Text(this.title)
Toggle({ type: ToggleType.Switch, isOn: this.toggleOn })
}
.padding(12)
}
}
配套要点:
- 复杂对象不要直接在 aboutToReuse 浅拷贝,容易引发共享引用;
- 如果组件里面有 BuilderNode、定时器、事件监听,务必在回收阶段解绑;
- 如果条目差异化极大、状态很难清理,干脆放弃复用,避免排坑成本更高。
最后搭配 LazyForEach + cachedCount,复用才能真正降低帧率抖动,而不是埋下偶现 Bug。
1
浏览20 发布于7天前广东
全部评论
最多点赞
最新发布
最早发布
写回答
所见即所得编辑器, editor1
工具栏
0/50000
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要发帖子
了解社区公约,与您携手共创和谐专业的开发者社区。






































苏公安网备 32011402010933号