文档开发者中心
我的
|

HarmonyOS 5

LazyForEach @Reusable 复用池错位完整定位清单

列表复用错位是 ArkUI 长列表经典难题,很多人只知道 “不要用 index 当 key”,但踩坑点远不止这一处。

下面是一套可直接放进项目的规范写法,附带可用来调试的埋点:

收起
自动换行
深色代码主题
复制
import { IDataSource, DataChangeListener } from '@ohos/common';

export class RecordDataSource implements IDataSource {
  private dataList: Array<{ id: string; title: string }> = [];
  private listeners: DataChangeListener[] = [];

  totalCount(): number {
    return this.dataList.length;
  }

  getData(index: number): { id: string; title: string } {
    return this.dataList[index];
  }

  addData(item: { id: string; title: string }) {
    this.dataList.push(item);
    this.listeners.forEach(l => l.onDataAdd(this.dataList.length - 1, 1));
  }

  changeData(id: string, newTitle: string) {
    const idx = this.dataList.findIndex(v => v.id === id);
    if (idx >= 0) {
      this.dataList[idx].title = newTitle;
      this.listeners.forEach(l => l.onDataChange(idx, 1));
    }
  }

  registerDataChangeListener(listener: DataChangeListener): void {
    this.listeners.push(listener);
  }

  unregisterDataChangeListener(listener: DataChangeListener): void {
    const pos = this.listeners.indexOf(listener);
    if (pos >= 0) this.listeners.splice(pos, 1);
  }
}

@Reusable
@Component struct ListItemCard {
  @Param item: { id: string; title: string }
  // 所有状态提升到外层,组件内部不存选中、展开标记

  aboutToReuse(params: Record<string, Object>): void {
    // 复用到来,重置所有渲染字段,阻断旧状态残留
    const p = params as { item: { id: string; title: string } };
    this.item = p.item;
  }

  build() {
    Column() {
      Text(this.item.title)
    }
  }
}

排查顺序

  1. keyGenerator 使用稳定唯一业务 ID,禁止 index;
  2. 需要复用的条目必须标记 @Reusable,否则复用池不会生效;
  3. 选中、展开、收藏等状态统一放在外层 ViewModel,以 item.id 索引;
  4. 更新数据优先使用 onDataAdd / onDataChange / onDataDelete,尽量避免粗暴的 onDataReloaded;
  5. 不要在每次刷新页面 new 一个全新的 IDataSource;
  6. 使用 AppAnalyzer 观察组件创建数量,如果滚动时大量新建,说明复用没有命中。
点赞
收藏
1
回复
3
分享
举报
浏览10 发布于3天前广东
全部评论
最多点赞
最新发布
最早发布
写的非常好
3楼回复于3天前 来自北京
写的还不错,学习了
2楼回复于3天前 来自北京
总结得很好
1楼回复于3天前 来自四川
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

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