鸿蒙5.0开发进阶:ArkTS组件-Repeat

鸿蒙HarmonyOS实战:循环渲染-Repeat组件 Repeat组件开启virtualScroll开关时,Repeat将从提供的数据源中按需迭代数据,并在每次迭代过程中创建相应的组件。当在滚动容器中使用了Repeat,框架会根据滚动容器可视区域按需创建组件,当组件滑出可视区域外时,框架会缓存组件,并在下一次迭代中使用。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


Repeat

说明

本模块首批接口从API version 12开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

接口

Repeat: <T>(arr: Array<T>)

Repeat组件non-virtualScroll场景(不开启virtualScroll开关)中,Repeat基于数据源进行循环渲染,需要与容器组件配合使用,且接口返回的组件应当是允许包含在Repeat父容器组件中的子组件。Repeat循环渲染和ForEach相比有两个区别,一是优化了部分更新场景下的渲染性能,二是组件生成函数的索引index由框架侧来维护。

Repeat组件virtualScroll场景中,Repeat将从提供的数据源中按需迭代数据,并在每次迭代过程中创建相应的组件,必须与滚动类容器组件配合使用。当在滚动类容器组件中使用了Repeat,框架会根据滚动容器可视区域按需创建组件,当组件滑出可视区域外时,框架会缓存组件,并在下一次迭代中使用。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
arrArray<T>是数据源,为Array<T>类型的数组,由开发者决定数据类型。

示例:

// arr是Array<string>类型的数组,以arr为数据源创建Repeat组件
Repeat<string>(this.arr)

事件

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

each

each(itemGenerator: (repeatItem: RepeatItem<T>) => void): RepeatAttribute<T>

组件生成函数。template和templateId匹配不上的数据项走默认生成函数each。

说明

each属性必须有,否则运行时会报错。

itemGenerator的参数为RepeatItem,该参数将item和index结合到了一起,请勿将RepeatItem参数拆开使用。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
repeatItemRepeatItem<T>是repeat数据项。

示例:

// arr是Array<string>类型的数组,为每个数据创建一个Text组件
Repeat<string>(this.arr)
  .each((obj: RepeatItem<string>) => { Text(obj.item) })

key

key(keyGenerator: (item: T, index: number) => string): RepeatAttribute<T>

键值生成函数。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
itemT是arr数组中的数据项。
indexnumber是arr数组中的数据项索引。

示例:

// arr是Array<string>类型的数组,为每个数据创建一个Text组件
// 并将字符串的值作为其键值
Repeat<string>(this.arr)
  .each((obj: RepeatItem<string>) => { Text(obj.item) })
  .key((obj: string) => obj)

virtualScroll

virtualScroll(virtualScrollOptions?: VirtualScrollOptions): RepeatAttribute<T>

Repeat开启虚拟滚动。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
virtualScrollOptionsVirtualScrollOptions否虚拟滚动配置项。

示例:

// arr是Array<string>类型的数组,为每个数据创建一个Text组件
// 在List容器组件中使用Repeat,并打开virtualScroll
List() {
  Repeat<string>(this.arr)
    .each((obj: RepeatItem<string>) => { ListItem() { Text(obj.item) }})
    .virtualScroll()
}

template

template(type: string, itemBuilder: RepeatItemBuilder<T>, templateOptions?: TemplateOptions): RepeatAttribute<T>

复用模板。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
typestring是当前模板类型。
itemBuilderRepeatItemBuilder<T>是组件生成函数。
templateOptionsTemplateOptions否当前模板配置项。

示例:

// arr是Array<string>类型的数组
// 在List容器组件中使用Repeat,并打开virtualScroll
// 创建模板temp,该模板为数据创建Text组件
List() {
  Repeat<string>(this.arr)
    .each((obj: RepeatItem<string>) => {})
    .virtualScroll()
    .template('temp', (obj: RepeatItem<string>) => { ListItem() { Text(obj.item) }})
}

templateId

templateId(typedFunc: TemplateTypedFunc<T>): RepeatAttribute<T>

为当前数据项分配templateId。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
typedFuncTemplateTypedFunc<T>是生成当前数据项对应的templateId。

示例:

// arr是Array<string>类型的数组
// 在List容器组件中使用Repeat,并打开virtualScroll
// 创建模板temp,该模板为数据创建Text组件
// 所有数据项都使用temp模板
List() {
  Repeat<string>(this.arr)
    .each((obj: RepeatItem<string>) => {})
    .virtualScroll()
    .template('temp', (obj: RepeatItem<string>) => { ListItem() { Text(obj.item) }})
    .templateId((item: string, index: number) => { return 'temp' })
}

RepeatItem<T>

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
itemT是arr中每一个数据项。T为开发者传入的数据类型。
indexnumber是当前数据项对应的索引。

VirtualScrollOptions对象说明

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
totalCountnumber否加载的数据项总数,可以大于/小于数据源长度

示例:

// arr是Array<string>类型的数组,在List容器组件中使用Repeat,并打开virtualScroll
// 将加载的数据项总数设为数据源的长度
List() {
  Repeat<string>(this.arr)
    .each((obj: RepeatItem<string>) => { ListItem() { Text(obj.item) }})
    .virtualScroll( { totalCount: this.arr.length } )
}

RepeatItemBuilder<T>

type RepeatItemBuilder<T> = (repeatItem: RepeatItem<T>) => void

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
repeatItemRepeatItem<T>是将item和index结合到一起的一个状态变量。

TemplateOptions对象说明

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
cachedCountnumber否当前模板在Repeat的缓存池中可缓存子节点的最大数量,仅在开启virtualScroll后生效。

示例:

// arr是Array<string>类型的数组,在List容器组件中使用Repeat,并打开virtualScroll
// 创建模板temp,该模板为数据创建Text组件,所有数据项都使用temp模板
// 将temp模板的最大缓存节点数量设为2
List() {
  Repeat<string>(this.arr)
    .each((obj: RepeatItem<string>) => {})
    .virtualScroll()
    .template('temp', (obj: RepeatItem<string>) => { ListItem() { Text(obj.item) }}, { cachedCount: 2 })
    .templateId((item: string, index: number) => { return 'temp' })
}

TemplateTypedFunc<T>

type TemplateTypedFunc<T> = (item : T, index : number) => string

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
itemT是arr中每一个数据项。T为开发者传入的数据类型。
indexnumber是当前数据项对应的索引。

鸿蒙next开发实战:Repeat子组件复用规范详解 Repeat组件的virtualScroll场景不完全兼容V1装饰器,使用V1装饰器存在渲染异常,不建议开发者同时使用V1装饰器和virtualScroll场景。 阅读详情

相关推荐

AURIX™ TC49x芯片手册中文分享(二)

主要内容为第一章、功能模块的特征

xibaofenqi的博客 1564

鸿蒙HarmonyOS 5.0开发:Repeat:子组件复用

Repeat组件non-virtualScroll场景(不开启virtualScroll开关)中...........

m0_73088370的博客 1056

金蝶云星空-协同开发云-安装开发环境

金蝶协同开发云就是不需要每一个开发都在自己的本机安装开发环境,自己安装可容易出错,包括源代码管理也一并解决了,大大减少了开发人员的工作量和降低了上手的难度。

qq_33881408的博客 5604

鸿蒙开发0基础【Repeat:可复用的循环渲染】状态管理

Repeat基于数组类型数据来进行循环渲染,一般与容器组件配合使用。Repeat组件包含两种模式:**non-virtualScroll模式**和**virtualScroll模式**。

zhenggaoxiao232的博客 1092

芯片设计中的setup和hold检查:为什么你的电路会跑飞?

本文深入解析了芯片设计中Setup与Hold检查的核心原理,它们是确保电路可靠运行的“黄金窗口”。通过剖析触发器物理本质、时序路径公式及检查方法,解释了Setup违例(数据太慢)和Hold违例(数据太快)如何导致电路“跑飞”,并提供了从RTL优化到物理实现的实战修复策略与协同优化技巧。

weixin_29268267的博客 480

MATLAB安装配置libsvm(附MinGW64配置)

首先声明版本,本人PC系统Windows10 64bit,matlab安装的2016b,libsvm安装的version3.2.21.首先需要下载libsvm包:从林教授的网站上下载: http://www.csie.ntu.edu.tw/~cjlin/libsvm/2.将libsvm3.2.2解压到matlab/toolbox目录下:解压后:D:\matlab2016b\toolbox\libs...

github_35807147的博客 4万+

鸿蒙6.0应用开发——Repeat组件的使用

摘要: Repeat是基于数组数据的循环渲染组件,需与List等滚动容器配合使用,支持懒加载和节点复用。其核心特性包括:仅渲染可视区域及预加载节点(默认1个,可调整);子组件需匹配容器类型(如List中需为ListItem);支持通过.template()定义多模板并根据条件切换。案例展示了全量加载与懒加载(virtualScroll+cachedCount)的性能对比,以及多模板按索引动态渲染的效果。注意事项包括:避免混用V1装饰器、不支持动画、单容器内仅允许一个Repeat等。通过合理配置可显著提升长列

高心星的专栏 2042

Classic AUTOSAR精讲专栏目录

欢迎大家来到钢琴上的汽车软件创建的《Classic AUTOSAR精讲系列专栏》,期待在这里能够与大家一起进步,分享成功,分享喜悦!下面蓝色的文章标题都是传送门,点击直接跳转到对应文章。

酒无忧的博客 3918

【鸿蒙next开发】ArkUI框架:ArkTS组件-Repeat

鸿蒙HarmonyOS 5.0的Repeat组件是一种高效的数据渲染方案

m0_73088370的博客 720

VisionTransformer改进(11):结合CoordAtt注意力机制

​​CoordAtt模块​​:一个轻量级的坐标注意力机制​​ViT模型​​:基于标准Vision Transformer架构,但集成了CoordAtt模块模型最终通过CNNModel函数封装,虽然名称是CNN,但实际上是一个Transformer模型。引入了轻量级的CoordAtt注意力机制,增强了模型对空间位置信息的捕捉能力保持了ViT的主要优势,同时通过注意力机制提升了特征表示能力设计简洁高效,适合作为基础模型进行进一步研究和应用。

2401_82355416的博客 702

24届数字IC验证——SV+UVM基础知识汇总(一)

汇总整理在面试过程中常见的问题,如果都能回答下来,那么面试肯定不成问题的分别构建不同抽象级的transaction,来实现复杂的激励。(以前是单一层次的sequence,对激励复用、上层复用不塌友好)不同层级之间的sequence没有继承关系,相互之间进行转换低层次的sequence从高层次的sequencer中获取高层次的sequence,并将其转换为低层次的sequence,再通过低层次的sequencer发送出去如何连接:低层次的sequencer包含高层次sequencer的句柄。

qq_42135020的博客 3156

用 ArkTS 的 Repeat 组件玩转正向循环渲染:从基础到实战

《HarmonyOS ArkTS Repeat组件:长列表性能优化指南》 本文详细介绍了HarmonyOS ArkTS框架中Repeat组件的使用方法和性能优化技巧。Repeat是专为解决长列表渲染性能问题而设计的组件,通过按需加载和节点复用两大核心技术,显著提升长列表的滑动流畅度。

2401_86731168的博客 848

uniapp微信小程序 - 解决苹果ios底部输入框被软键盘遮挡的问题,input/textarea底部输入框被弹出的软键盘挡住部分或全部遮住(解决uniApp小程序底部输入框,键盘弹起时页面整体上移

uniapp: IOS微信小程序输入框部分被软键盘遮挡问题,iOS微信小程序键盘弹出时输入框被挡住,uniapp小程序苹果IOS系统软键盘唤起导致底部输入框被遮挡的问题,ios 键盘弹出input输入框被遮挡,uniapp textarea输入框软键盘遮挡问题,苹果手机ios系统,解决uni-app微信小程序底部输入框,键盘弹起时页面整体上移 问题,关于手机端IOS系统微信中虚拟键盘遮挡input输入框问题的解决方案,uniapp使用输入框固定在底部键盘弹起把输入框挡住问题,安卓上没问题就苹果不行,仅ios

🏆 前端领域优质创作者 5601

鸿蒙学习实战之路-ArkTS 循环渲染_Repeat 使用指南

Repeat 是 ArkTS 中的"智能上菜系统"!ForEach:每次客人点菜都要重新炒一遍(重新创建组件):客人点菜时再炒,但炒完就倒掉(销毁组件)Repeat:客人点菜时先看看有没有现成的,没现成的再炒,炒完的菜不倒掉,留着给下个客人用(节点复用)特性ForEachRepeat性能基础中等最佳内存管理无自动释放智能复用大数据支持差好极好实现复杂度简单中等复杂适用场景小数据量中等数据量大数据量+高性能Repeat 组件是鸿蒙开发中的"性能利器"!

u011864152的博客 717

pscad IEEE标准系统搭建说明

pscad IEEE标准系统搭建说明,包含典型的IEEE 9节点、14节点、30节点、39节点和118节点系统。内含标准测试系统的原始数据和潮流结果。

C# WinForm 基于DirectShow.dll编写的程序,可边预览边保存视频,音频和图片

基于微软的DirectShow.dll的二次开发1.自动识别连接的摄像头跟麦克风且可以对其进行选择(默认选中第一个)2.可录制wmv和avi两种格式的视频并且都带有音频,avi可以录制的分辨率和帧数进行选择,wmv默认进行了淸晰度优化如不喜欢可去除代码中有相关提示3.可在预览点开之后进行拍照,也可边录制视频边拍照4.添加了视频和音频的压缩功能(酌情使用)这次二次开发发现C#对DirectShow的相关信息太少,这次做完也不敢藏私共享出来,还望大家指正

鸿蒙5.0&next开发【复杂绘制效果(ArkTS)】媒体服务

除了基础填充颜色、描边颜色和一些样式设置的绘制效果外,还支持通过画刷和画笔实现更多复杂的绘制效果。比如:

bbq的博客 1268

OV9734 DATASHEET,完整规格书

OV9734完整规格书,包括电气参数,尺寸规格,寄存器配置表等

0 基础入门React Native鸿蒙跨平台开发:HarmonyOS ArkTS API 24,Vibration设备振动功能演示

现在第一个位置参数的命名约定为 cls,说明它已经是一个创建好的类对象(元类的实例),而不是一个元类对象。name、bases 和 namespace 参数的含义与前面介绍的 type()调用中的参数相同,• bases:这是父类的列表,将成为__bases__属性,并用于构造新创建的类的 MRO。然是 type 类的子类(参见图 3-4),因为如果不是的话,这个类将在继承方面与其他的类。metaclass 参数的值通常是另一个类对象,但它可以是任意可调用对象,只要接受。定义了对象实例的类也是对象。

2301_77888392的博客 686

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

Arkts语法<Repeat 可复用的循环渲染>

Arkts基础-Repeat可复用循环渲染

wang_xian_sheng_的博客 880

前端转鸿蒙开发实战:ArkTS 语法 3 天快速上手,完成 1 个电商首页 Demo

本文为前端开发人员提供鸿蒙开发实战指南,通过ArkTS语法3天快速上手,完成电商首页Demo。文章详细介绍了环境搭建、ArkTS语法核心差异、电商组件开发及状态管理,帮助开发者顺利转型鸿蒙开发,拓展就业方向。

weixin_33742618的博客 503

汽车改装记录鸿蒙App实战:ArkTS中的多维筛选与Preferences存储

本文介绍了ArkGraphics 3D中节点树的操作方法。3D场景由节点树构成,包括根节点、空节点、几何节点、相机节点和灯光节点等类型。每个节点具有位置、旋转、缩放等核心属性,可通过父子关系实现层级控制。文章详细讲解了如何操作子节点容器,包括追加(append)、插入(insertAfter)、移除(remove)、获取(get)、清空(clear)等常用方法,并提供了TypeScript代码示例。这些操作是3D场景构建的基础,通过节点树的层级关系可以高效管理复杂3D对象的变换和显示状态。

weixin_42299977的博客 232

ArkTS 自定义组件开发:从基础到实战的完整指南

在 HarmonyOS ArkTS 声明式 UI 开发中,随着应用规模的增长,页面代码量会迅速膨胀。将所有 UI 逻辑写在一个build()函数中,不仅导致代码可读性极差,还会造成大量的样式和逻辑重复。组件化开发正是解决这一痛点的核心方案。@Component:自定义组件的基础装饰器,定义可复用的 UI 单元;@Entry:页面入口装饰器,标识页面的根组件;@Builder:自定义构建函数,提取可复用的 UI 逻辑片段;:组件插槽机制,实现类似 Vue/React 的 Slot 功能;

从事移动开发八年,csdn博客专家,阿里云特邀专家,华为云云享专家,高级网络信息安全工程师,大数据工程师(高级),python技术开发(高级),HarmonyOS 应用开发者高级认证,现在某学校任教。 1万+

HarmonyOS ArkTS App 关于页面实战:InfoRow 组件与功能网格布局

关于」页面通常是用户了解应用的窗口,展示版本号、开发者信息、功能列表等内容。InfoRow 信息区:展示应用图标、名称、版本号、开发者、版权等信息Feature Grid 功能区:使用 Grid 组件构建 3 列网格,展示 30 个功能入口项页面布局结构│ 应用 Logo + 名称 │ ← 应用头部│ 版本号 v1.0.0 ││ 开发者:HarmonyOS Team │ ← InfoRow 信息行│ 更新时间:2025-01-15 ││ 联系我们:support@example │。

2403_87838053的博客 164

鸿蒙原生 ArkTS 布局深度解析:Grid rowsTemplate 行模板的灵活控制

本文深度解析鸿蒙ArkTS中Grid组件的rowsTemplate行模板功能。rowsTemplate通过定义行高模板实现灵活布局控制,支持fr弹性单位、固定像素(px/vp)、百分比(%)和auto自适应四种单位。文章详细介绍了其语法规则和计算原理,重点讲解了fr单位的空间分配机制,并通过综合示例展示了多种单位的混合使用方法。作为鸿蒙布局体系中的核心组件,Grid凭借二维网格控制能力,可有效解决复杂UI场景下的精确行高控制需求,避免多层嵌套布局带来的性能问题。

2602_96406334的博客 849

鸿蒙ArkTS实战:HarmonyOS ArkTS API 24传统篆刻工坊全端应用ArkTS API24、@Observed业务状态管理、@ObjectLink对象链路传递、声明式UI组件拆分

在移动互联网与智能穿戴设备高度普及的今天,"习惯养成"已经从一个模糊的自我管理理念,演变为一个可量化、可追踪、可视化的数字化产品赛道。越来越多的人希望借助手中的智能终端,把"早起、冥想、阅读、运动"这些抽象的自律行为,转化为一条条清晰的数据曲线和一张张可触摸的打卡卡片。而鸿蒙生态(HarmonyOS)凭借其跨设备协同、分布式软总线以及声明式 UI 开发框架 ArkUI,为这类注重"轻量化交互 + 即时反馈"的生活方式类应用提供了极为理想的生长土壤。本应用正是一款面向"晨间场景"深度打磨的习惯追踪工具。它聚焦

qq_17776737的博客 97

基于HarmonyOS API 24一款基于 ArkTS(HarmonyOS 开发语言)构建的美妆护肤 APP,主打高端护肤品牌的线上销售与服务

健身管理类应用与之前分析的外卖、招聘等应用有本质差异——它的核心数据不是"交易"或"任务",而是"时间序列的身体状态数据":每次训练有时长、卡路里、组数、重量;每次饮食有热量、蛋白质、碳水、脂肪;每周有运动时长趋势图。这些数据的共同特征是"随时间积累,用户需要横向对比和趋势分析"。这导致健身App的数据层设计必须从第一天就考虑"历史数据查询"和"多维度聚合"的需求,而非仅关注当前单条记录的增删改查。健身应用的用户行为模式也有独特之处:用户使用健身App的目标是"坚持",而不是"一次性完成任务"。这意味着激励

2501_92093170的博客 463

HarmonyOS ArkTS图片画廊深度解析:Grid 宫格布局、条件渲染与 Emoji 可视化

摘要 本文介绍了一个基于ArkTS的图片画廊应用,展示了三个核心概念:Grid宫格布局、条件渲染和全局选中态。应用使用Emoji作为图片占位符,无需真实图片资源即可实现视觉体验。布局采用3列等宽网格(columnsTemplate('1fr 1fr 1fr')),支持图片点击高亮和上下切换功能。通过if条件渲染实现大图展示区的动态显示,并保持网格缩略图与展示区的选中状态同步。Grid布局适合规则网格场景,而List更适合单向滚动列表。该案例完整呈现了复杂交互界面的ArkTS实现方式。

2403_87838053的博客 384

HarmonyOS 6.1 实战 Picker 日期选择器弹窗自定义时间范围限制可选日期业务开发干货

糖画坊:鸿蒙ArkTS实现的非遗糖画UI应用 摘要:本文介绍了一个基于鸿蒙ArkTS开发的"糖画坊"应用,将传统非遗糖画艺术数字化呈现。项目采用声明式UI架构,包含六大数据场景展示和三个交互弹窗。技术亮点包括: 精心设计的焦糖棕主题色板系统 枚举驱动的页签导航体系 状态管理采用@Observed数据类与@State/@ObjectLink绑定 模块化的常量数据与图表数据分离 完整的类型系统定义数据契约 声明式构建可复用的UI组件 项目通过四层架构清晰分离关注点,是理解ArkTS状态驱动开发的优秀范例,完美展

wilbur1688的博客 335
上一篇: 鸿蒙5.0开发进阶:ArkTS组件-LazyForEach
下一篇: 鸿蒙5.0开发进阶:ArkTS组件-基础类型定义
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值