ArkTS 长列表用 LazyForEach:IDataSource 最小实现和三个容易踩的坑
在 HarmonyOS 应用里,列表数据少的时候直接用 ForEach 就够了;但一旦数据上千条,ForEach 会一次性创建全部子组件,首屏变慢、内存也上去。LazyForEach 的思路是按可视区域按需创建组件,滑出屏幕的组件可以被回收。本文记录我给一个长列表改造成 LazyForEach 的最小实现,以及实际调试中遇到的三个问题。
一、为什么 ForEach 在长列表里吃亏
ForEach 会在首次渲染时为数组中的每一项都执行一次 itemGenerator。数据量是 2000 条时,就是 2000 个 ListItem 同时创建,即使屏幕上只能看到十几条。LazyForEach 只为可视区域(加上 cachedCount 指定的预加载数量)创建组件,这是两者最核心的区别。
二、IDataSource 的最小实现
LazyForEach 不接受普通数组,而是要求一个实现了 IDataSource 接口的数据源。接口里有四个方法:totalCount、getData、registerDataChangeListener、unregisterDataChangeListener。下面是一个可复用的基础类:
class BasicDataSource<T> implements IDataSource {
private listeners: DataChangeListener[] = [];
protected items: T[] = [];
totalCount(): number {
return this.items.length;
}
getData(index: number): T {
return this.items[index];
}
registerDataChangeListener(listener: DataChangeListener): void {
if (this.listeners.indexOf(listener) < 0) {
this.listeners.push(listener);
}
}
unregisterDataChangeListener(listener: DataChangeListener): void {
const pos = this.listeners.indexOf(listener);
if (pos >= 0) {
this.listeners.splice(pos, 1);
}
}
pushItem(item: T): void {
this.items.push(item);
this.listeners.forEach(l => l.onDataAdd(this.items.length - 1));
}
deleteItem(index: number): void {
this.items.splice(index, 1);
this.listeners.forEach(l => l.onDataDelete(index));
}
}
页面里使用:
@Entry
@Component
struct MessageList {
private source: BasicDataSource<string> = new BasicDataSource<string>();
aboutToAppear(): void {
for (let i = 0; i < 2000; i++) {
this.source.pushItem(`消息 ${i}`);
}
}
build() {
List({ space: 8 }) {
LazyForEach(this.source, (item: string) => {
ListItem() {
Text(item).fontSize(16).padding(12)
}
}, (item: string) => item)
}
.cachedCount(5)
.width('100%')
.height('100%')
}
}
三、坑一:改了数据但界面不刷新
和 @State 修饰的数组不同,LazyForEach 的数据源变化不会被状态管理自动感知。直接修改 items 数组而不调用监听器的 onDataAdd、onDataDelete、onDataChange 等方法,界面不会更新。所以所有增删改都要收口到数据源类自己的方法里,在方法内部通知监听器,不要在页面里直接操作内部数组。
四、坑二:键值生成函数不稳定
LazyForEach 的第三个参数是键值生成函数,框架靠它判断哪些组件可以复用。我一开始写成了用 index 拼键值,结果在列表头部插入数据后,后面所有项的键都变了,框架认为全部是新数据,滚动时出现闪烁。键值应该来自数据本身的唯一标识,比如消息 id,而不是位置下标。示例里直接用字符串内容作键,前提是内容不重复;真实业务里建议用后端返回的 id。
另外要注意键值不能重复。重复的键会导致部分项不渲染或者渲染错位,排查时很难第一时间联想到是键的问题。
五、坑三:cachedCount 不是越大越好
cachedCount 表示在可视区域之外预先创建的列表项数量。设得太小,快速滑动时会看到空白;设得太大,又回到了"提前创建很多组件"的老问题,失去懒加载的意义。我的做法是先按一屏可见条数的一半左右设置,再在真机上快速滑动观察是否出现白块,逐步调整。列表项布局越复杂,越要谨慎增大这个值。
六、小结
- 数据量大时用 LazyForEach 替代 ForEach,按需创建组件。
- 数据源实现 IDataSource,所有数据变化都要通过监听器通知框架。
- 键值生成函数使用数据的稳定唯一标识,不要用下标。
- cachedCount 结合真机滑动效果调整,不要一味调大。
这几条在改造聊天记录、商品列表这类长列表页面时都适用。如果列表项里还有图片,建议再配合图片的尺寸约束和占位图,避免滑动过程中频繁重新布局。
- 点赞
- 收藏
- 关注作者
评论(0)