LazyForEach从提供的数据源中按需迭代数据,并在每次迭代过程中创建相应的组件,可以保证数据加载以及绘制的流畅度,提升使用体验。LazyForEach依赖生成的键值判断是否刷新子组件,若键值不发生改变,则无法触发LazyForEach刷新对应的子组件。
List() {
ListItemGroup() {
ListItem() {
List() {
LazyForEach(this.data, (index: number) => {
ListItem() {
Text(`index = ${index}`)
}
.backgroundColor(Color.Green)
})
}
// 为外层组件添加高度
.height(300)
}
}
} 示例代码如下:
List() {
LazyForEach(this.data, (index: number) => {
ListItem() {
Text(`index = ${index}`)
.reuseId('article')
}
// 需确保每个index值唯一
}, (index: number) => index.toString())
} 修改方式: 构造reloadData方法,在改变数据项后调用,重建后面的数据项。详细可参考:渲染结果非预期。
完整代码示例如下:
class BasicDataSource<T> implements IDataSource {
private listeners: DataChangeListener[] = [];
private originDataArray: T[] = [];
public totalCount(): number {
return this.originDataArray.length;
}
public getData(index: number): T {
return this.originDataArray[index];
}
registerDataChangeListener(listener: DataChangeListener): void {
if (this.listeners.indexOf(listener) < 0) {
console.info('add listener');
this.listeners.push(listener);
};
}
unregisterDataChangeListener(listener: DataChangeListener): void {
const pos = this.listeners.indexOf(listener);
if (pos >= 0) {
console.info('remove listener');
this.listeners.splice(pos, 1);
};
}
notifyDataReload(): void {
this.listeners.forEach(listener => {
listener.onDataReloaded();
});
}
notifyDataAdd(index: number): void {
this.listeners.forEach(listener => {
listener.onDataAdd(index);
});
}
notifyDataChange(index: number): void {
this.listeners.forEach(listener => {
listener.onDataChange(index);
});
}
notifyDataDelete(index: number): void {
this.listeners.forEach(listener => {
listener.onDataDelete(index);
});
}
notifyDataMove(from: number, to: number): void {
this.listeners.forEach(listener => {
listener.onDataMove(from, to);
});
}
notifyDatasetChange(operations: DataOperation[]): void {
this.listeners.forEach(listener => {
listener.onDatasetChange(operations);
});
}
}
// LazyForEach的数据源需要实现IDataSource接口
export class DataSource extends BasicDataSource<number> {
private dataArray: number[] = [];
public getAllData(): number[] {
return this.dataArray;
}
public totalCount(): number {
return this.dataArray.length;
}
public getData(index: number): number {
return this.dataArray[index];
}
public pushData(data: number): void {
this.dataArray.push(data);
this.notifyDataAdd(this.dataArray.length - 1);
}
} import { DataSource } from '../models/DataSource';
@Entry
@Component
struct Index {
// LazyForEach的数据源需要实现IDataSource接口,DataSource为自定义类,已实现IDataSource接口
@State data: DataSource = new DataSource();
// 构造数据
aboutToAppear(): void {
for (let i = 0; i < 50; i++) {
this.data.pushData(i);
};
}
build() {
Column() {
Row() {
List() {
ListItemGroup() {
ListItem() {
List() {
LazyForEach(this.data, (index: number) => {
ListItem() {
Text(`index = ${index}`)
}
.backgroundColor(Color.Green)
})
}
// 为外层组件添加高度
.height(300)
}
}
}
.width('50%')
.height('100%')
List() {
LazyForEach(this.data, (index: number) => {
ListItem() {
Text(`index = ${index}`)
.reuseId('article')
}
// 需确保每个index值唯一
}, (index: number) => index.toString())
}
.cachedCount(10)
.width('50%')
.height('100%')
.edgeEffect(EdgeEffect.None)
.padding({ left: '10vp', right: '10vp' })
}
.width('100%')
.height('100%')
}
.width('100%')
.height('100%')
}
} Q:LazyForEach是否适用所有组件实现懒加载?
A:LazyForEach必须在容器组件内使用,仅有List、ListItemGroup、Grid、Swiper以及WaterFlow组件支持数据懒加载(可配置cachedCount属性,即只加载可视部分以及其前后少量数据用于缓冲),其他组件仍然是一次性加载所有的数据。
Q:LazyForEach是否可嵌套使用?
A:容器组件内使用LazyForEach的时候,只能包含一个LazyForEach。以List为例,同时包含ListItem、ForEach、LazyForEach的情形是不推荐的;同时包含多个LazyForEach也是不推荐的。