ArkTs之:数据懒加载——LazyForEach的用法

官方描述

LazyForEach从提供的数据源中按需迭代数据,并在每次迭代过程中创建相应的组件。当在滚动容器中使用了LazyForEach,框架会根据滚动容器可视区域按需创建组件,当组件滑出可视区域外时,框架会进行组件销毁回收以降低内存占用。

使用限制

  • LazyForEach必须在容器组件内使用,仅有ListGridSwiper以及WaterFlow组件支持数据懒加载(可配置cachedCount属性,即只加载可视部分以及其前后少量数据用于缓冲),其他组件仍然是一次性加载所有的数据。
  • LazyForEach在每次迭代中,必须创建且只允许创建一个子组件。
  • 生成的子组件必须是允许包含在LazyForEach父容器组件中的子组件。
  • 允许LazyForEach包含在if/else条件渲染语句中,也允许LazyForEach中出现if/else条件渲染语句。
  • 键值生成器必须针对每个数据生成唯一的值,如果键值相同,将导致键值相同的UI组件渲染出现问题。
  • LazyForEach必须使用DataChangeListener对象进行更新,对第一个参数dataSource重新赋值会异常;dataSource使用状态变量时,状态变量改变不会触发LazyForEach的UI刷新。
  • 为了高性能渲染,通过DataChangeListener对象的onDataChange方法来更新UI时,需要生成不同于原来的键值来触发组件刷新。
  • LazyForEach必须和@Reusable装饰器一起使用才能触发节点复用。使用方法:将@Reusable装饰在LazyForEach列表的组件上,见使用规则

实战

LazyForEach是专门用来进行数据懒加载的接口,非常适合大数据量渲染的场景,但是想使用它必须要先实现IDatasource接口才能使用,废话不多说,直接上代码:

typescript 复制代码
//第一步:实现IDataSource接口
// RecommendDataSource.ets
import { Recommend_Item } from '../DataType/index';
export class RecommendDataSource implements IDataSource {
  // 数据源
  private recommends: Array<Recommend_Item>;
  // 监听器
  private listeners: DataChangeListener[] = [];

  constructor(data: Recommend_Item[]) {
    this.recommends = data;
  }
  // 返回数据源中的数据数量
  public totalCount(): number {
    return this.recommends.length;
  }
  // 根据索引返回数据项
  public getData(index: number): Recommend_Item {
    return this.recommends[index];
  }
  // 为 LazyForEach 组件注册监听器
  registerDataChangeListener(listener: DataChangeListener): void {
    if (this.listeners.indexOf(listener) < 0) {
      console.info('add listener');
      this.listeners.push(listener);
    }
  }
  // 为 LazyForEach 组件注销监听器
  unregisterDataChangeListener(listener: DataChangeListener): void {
    const pos = this.listeners.indexOf(listener);
    if (pos >= 0) {
      console.info('remove listener');
      this.listeners.splice(pos, 1);
    }
  }
}

//第二步:在组件中引用并实例化
//Recommend.ets
import { Recommend_Item } from '../DataType/index';
import { RecommendDataSource } from '../MockData/RecommendDataSource';

@Component
export struct Recommend {
  @Prop RecommendList: Array<Recommend_Item> = [];  // 默认初始化为空数组
  private dataSource: RecommendDataSource = new RecommendDataSource([]);//初始化

  aboutToAppear() {
    // 在生命周期钩子中重新初始化 dataSource(如果 RecommendList 有更新)
    this.dataSource = new RecommendDataSource(this.RecommendList);
    console.log('RecommendList updated:', JSON.stringify(this.RecommendList), JSON.stringify(this.dataSource))
  } 
  build() {
    List({ space: 3 }) {
      LazyForEach(this.dataSource, (item: Recommend_Item, index: number) => {
        ListItem() {
          Row() {
            Text(item.type + '')
              .fontSize(50)
              .onAppear(() => {
                console.info("appear:" + item.type);
              });
          }.margin({ left: 10, right: 10 });
        }
        .onClick(() => {
          // 处理点击事件
        });
      }, (item: Recommend_Item) => item.type + '');
    }.cachedCount(5);
  }
}

最终效果

懒加载效果成功实现

相关推荐
爱笑的眼睛1123 分钟前
HarmonyOS 应用开发新范式:深入剖析 Stage 模型与 ArkTS 状态管理
华为·harmonyos
叫我阿柒啊38 分钟前
从Java全栈到前端框架:一次真实面试的深度复盘
java·spring boot·typescript·vue·database·testing·microservices
东风西巷44 分钟前
Balabolka:免费高效的文字转语音软件
前端·人工智能·学习·语音识别·软件需求
萌萌哒草头将军1 小时前
10个 ES2025 新特性速览!🚀🚀🚀
前端·javascript·vue.js
半夏陌离1 小时前
SQL 入门指南:排序与分页查询(ORDER BY 多字段排序、LIMIT 分页实战)
java·前端·数据库
whysqwhw1 小时前
鸿蒙工程版本与设备版本不匹配
前端
gnip1 小时前
http缓存
前端·javascript
爱笑的眼睛112 小时前
深入浅出 HarmonyOS ArkUI 3.0:基于声明式开发范式与高级状态管理构建高性能应用
华为·harmonyos
我不只是切图仔2 小时前
我只是想给网站加个注册验证码,咋就那么难!
前端·后端
XISHI_TIANLAN2 小时前
【多模态学习】Q&A3:FFN的作用?Embedding生成方法的BERT和Word2Vec?非线性引入的作用?
学习·bert·embedding