文档开发者中心
我的
|

HarmonyOS 5

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)
  }
}

配套要点:

  1. 复杂对象不要直接在 aboutToReuse 浅拷贝,容易引发共享引用;
  2. 如果组件里面有 BuilderNode、定时器、事件监听,务必在回收阶段解绑;
  3. 如果条目差异化极大、状态很难清理,干脆放弃复用,避免排坑成本更高。

最后搭配 LazyForEach + cachedCount,复用才能真正降低帧率抖动,而不是埋下偶现 Bug。

点赞
收藏
回复
1
分享
举报
浏览20 发布于7天前广东
全部评论
最多点赞
最新发布
最早发布
打卡
1楼回复于7天前 来自安徽
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

了解社区公约,与您携手共创和谐专业的开发者社区。