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)
}
}
}
排查顺序
keyGenerator使用稳定唯一业务 ID,禁止 index;- 需要复用的条目必须标记
@Reusable,否则复用池不会生效; - 选中、展开、收藏等状态统一放在外层 ViewModel,以 item.id 索引;
- 更新数据优先使用
onDataAdd / onDataChange / onDataDelete,尽量避免粗暴的onDataReloaded; - 不要在每次刷新页面
new一个全新的IDataSource; - 使用 AppAnalyzer 观察组件创建数量,如果滚动时大量新建,说明复用没有命中。
1
3
浏览10 发布于3天前广东
全部评论
最多点赞
最新发布
最早发布
写回答
所见即所得编辑器, editor1
工具栏
0/50000
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要发帖子
了解社区公约,与您携手共创和谐专业的开发者社区。





































苏公安网备 32011402010933号