HarmonyOS 6 列表实测:首屏同是七行,ForEach 和 LazyForEach 处理了多少个键
配套工程源码、测试材料与运行说明
前言 先把窗口固定在能看见七行的宽高。底片目录换成 ForEach 后还是这七行,变化发生在取键的位置。API 24 模拟器的首屏读数是 240 个键对 7 个键。我保留两只计数器,一只在列表行报告出现时记编号,另一只在 ArkUI 循环处理键时记编号。读者可以先判断这两个数字分别来自哪里,再顺着下面的表找最容易误读的一项。
首屏同是七行,处理过的不同键差多少
| MateBook Pro 模拟器 API 24 | 出现过的行 | 处理过的不同键 |
| LazyForEach 首屏 | 7 | 7 |
| LazyForEach 跳到 073 | 14 | 14 |
| ForEach 首屏 | 7 | 240 |
| 重新切回 LazyForEach 跳到 073 | 14 | 14 |

目录有 240 条,窗口内的列表高 350 vp,行高固定 58 vp,缓存计数设为零。观察的是同一个窗口、同样的素材和同一个下方 List。跳到 073 后的十四,是先看过起点一组,再看过目的地一组,集合合并起来的数量。它没有说当前同时显示十四个,也没有说真实相册所有项目都会拿到同样的首屏数。

在实际运行里先按采样,当时模式是 LazyForEach。读到第一组以后,点「跳到 073」,图里真实出现编号 073 左右的内容,自动脚本也找到了 frame-073。然后再次采样。若只看十四这个数字而不检查目标行,实际上滚到了 072 或 074 也可能给同样读数。切到 ForEach 后窗口退回起点,仍只出现约七行,但「处理过的不同键」变成 240。最后再切回 LazyForEach 并重跳,这一轮回到十四和十四。四步连在一起可以检查采样范围清了没有,还能证明虽然显示位置重建过,跳转行为没丢。
两个 Set 的入口在不同地方
先看一行。FrameLine 出现时把自己的编号通过回调给父页。父页把编号写进 appeared。用 Set 是为了同一张底片滚出又滚回时仍只占一格;如果你关心行组件经历了多少次出现,就该另记事件次数。显示这格数字时按「采样」读取集合大小,而不在每个回调里刷新状态,省得一边观察一边给页面添很多额外刷新。
aboutToAppear(): void {
this.report(this.code);
}
另一个点在构造键的回调。identify 把这条底片的编号加到 evaluated,再返回给框架实际使用的键。两种路径共同用这一个入口。它记录的是有多少不同编号到过键处理处。ForEach 首屏报 240,说明这一轮传入的数组项都走过键函数,但不能用这一个数字宣称创建、显示并保留了 240 行。LazyForEach 在这个视口回报较少的键,说明按需路径中的工作范围不同。
private identify(prefix: string, film: Film): string {
this.evaluated.add(film.code);
return prefix + film.code;
}
如果一条底片因为可见区域变化再次经过这个函数,Set 不会从一变二。读报告之前要先问「统计的是唯一编号还是函数调用总量」。若要研究工作开销,可以各加一个只增长的调用量,用它观察布局和重新构建时到底多做了多少回调。排查内存时则用独立手段留当前活跃视图与资源,不能把先后出现的独立编号换成驻留大小。这一轮为了讲清两个采样点保留累计去重口径。把脚本条件改成「当前屏幕上七条」时,应采当前渲染区域获取实际范围,而不是从统计器倒推。
动手看 List 里两条分支
List({ scroller: this.viewport }) {
if (this.lazy) {
LazyForEach(this.sheet, (film: Film) => {
ListItem() {
FrameLine({ code: film.code, caption: film.title, tint: film.tint,
report: (code: string): void => this.mark(code) })
}
}, (film: Film): string => this.identify('lazy-', film))
} else {
ForEach(this.sheet.rows, (film: Film) => {
ListItem() {
FrameLine({ code: film.code, caption: film.title, tint: film.tint,
report: (code: string): void => this.mark(code) })
}
}, (film: Film): string => this.identify('eager-', film))
}
}.width('100%').height(350).cachedCount(0).backgroundColor('#1F294A')
ForEach 直接拿 ContactSheet 中的数组,LazyForEach 经过 IDataSource 把需要的项交给同一套 FrameLine。两个分支故意保持行内文字、颜色和回调一致,差别才容易落到列表机制。多数实践里你还会给 IDataSource 加增删改通知,因为当前示例只读固定的 240 条,没有模拟每秒插入新图。调试动态加载时,最好另外记服务端取页和本地构建,不要把框架处理过键等同于访问了数据库或网络。这个工程在进入页面时已经准备好这批 Film 对象。

两条分支给键分别加上 lazy- 和 eager- 前缀,切到另一种模式时不沿用同一项的视图键。统计却保存 film.code,没把前缀混进去。这样读到的 240 是底片编号的数量;若把两种键都丢进同一个长期集合,来回切换以后同一底片可能会算成两项。当前 toggle 会清集合,样本可以比较相同起点。迁到实际目录时,只改 UI 模式不应让业务选中的底片换一个 ID,选中状态还要按真实底片编号恢复。
完整的数据源还有 totalCount 和 getData。总量让列表知道可以跳的范围,按下标取项才交出具体的一条。这个例子把它们都接到已有数组,没有在 getData 里做读盘。若把读盘加入同一个入口,键处理的数量就和昂贵工作搅在一起,重现时还会受读盘缓存干扰。更清晰的做法是先给每一条一个可以同步读取的身份,再独立记录缩略图什么时候请求、什么时候解码完成。
生成键还被用来做诊断。在当前代码里它顺手记一次编号,是因为这两套分支共享同一处观测。正式用法尽量让生成键只返回身份。诊断期间如果要保留计数,也别在里面改可观察的业务数据。组件可能因为布局或列表更新再次调用它,给同一条减少重复处理比预设只执行一次稳得多。这个示例的两个 Set 都不承担业务判断。
切换按钮先让 Scroller 回到 0,然后清掉两套观测集合和面板文字。因此两项首屏可以单独对比。想在产品中记住滑到哪一张时,不必复制这个实验的回起点行为。可以先保存当前稳定编号,再用更新后的数据找到它,而不是把某个数组下标写进长期状态。插入或删除以后下标会变,原来的片还在也不能用旧位置猜。
换成照片应用,要补哪组检查
先给一张底片在旧位置启动很慢的缩略图读取,在它前面再插一张。旧回调抵达时,应校验返回的底片 ID,仍然写回原来的条目。若列表在滚动时复用节点,拿当前的下标当身份就可能出现短暂串图。接着给两张照片起相同标题,选中一张,滚远再返回,确认选中还对应原 ID。教学样本用三位编号,真实场景用项目可稳定保存的 ID。
还可以做两张性能表。一张记录切进页面后多久能看到首条和整个首屏,另一张记录快速滚动时的帧、后台缩略图请求和内存。前者容易受首次加载的影响,后者更关心新的行在什么时候出现。这篇只测两个去重计数。如果真实应用在行的出现回调里启动了多个高代价操作,换控件以后还应衡量每行自身有没有变轻。
真实目录长短不一时,还可以单独测试只有五行的场景。两个路径几乎都需要处理整屏时,可见效果和计数会接近。这能帮团队选适合的场景:固定设置项只有几条,简单数组可能足够;每行有图、位置跳得远或者长到几百条,才值得逐个收集工作范围的证据。所谓「用了懒加载就一定划算」没有给出列表长度和行的成本,不能当选型条件。
有些相册首屏是从系统选图器回来以后展开的。此时先比较应用恢复前后有没有重建页面,再看所谓第一次显示是哪一次。若滚动位置已经留在很远,拿起点的预期七行去判定就会跑偏。脚本可以在打开前明确复位或保存一份预期位置,随后读键及画面。列表跳到一个不存在的 ID 时,再检查回退到最近项还是回首行,这由产品来定。
跑完整例子
打开文首工程,运行 API 24 的 entry。默认的 LazyForEach 下点「采样」,记首屏出现行与键数,随后跳到 073 再取一次样。再切 ForEach 回到首屏,明细数据、窗口和表项高度保持一致。最后切回按需模式重放跳转,确认上一轮的 240 个键没有混到这一轮。短到一屏就能放完的目录可以作反例。两种循环的取键数可能接近,仍应按当前窗口和实际键数判断适用性。
class Film {
code: string;
title: string;
tint: string;
constructor(index: number) {
const names: string[] = ['退潮后的堤岸', '车窗外的云', '正午邮局', '沿街的灯'];
const colors: string[] = ['#9CAFFF', '#F8C7AC', '#CAEEA7', '#F1A9C6'];
this.code = (index + 1).toString().padStart(3, '0');
this.title = names[index % names.length];
this.tint = colors[index % colors.length];
}
}
class ContactSheet implements IDataSource {
rows: Film[] = [];
private listeners: DataChangeListener[] = [];
constructor() {
for (let i = 0; i < 240; i++) this.rows.push(new Film(i));
}
totalCount(): number { return this.rows.length; }
getData(index: number): Film { return this.rows[index]; }
registerDataChangeListener(listener: DataChangeListener): void {
if (!this.listeners.includes(listener)) this.listeners.push(listener);
}
unregisterDataChangeListener(listener: DataChangeListener): void {
this.listeners = this.listeners.filter((existing: DataChangeListener) => existing !== listener);
}
}
@Component
struct FrameLine {
@Prop code: string = '';
@Prop caption: string = '';
@Prop tint: string = '#9CAFFF';
report: (code: string) => void = (_code: string): void => {};
aboutToAppear(): void {
this.report(this.code);
}
build() {
Row({ space: 14 }) {
Text(this.code).fontSize(18).fontColor('#AFB9D9').width(51)
Stack() {
Column().width(44).height(17).backgroundColor(this.tint).rotate({ angle: -16 })
Circle({ width: 11, height: 11 }).fill('#F0EFFB').position({ x: 37, y: 7 })
}.clip(true).width(62).height(34).backgroundColor('#293458')
Text(this.caption).fontSize(21).fontColor('#F4F3FF').layoutWeight(1)
Text('35 MM').fontSize(12).fontColor('#AFB9D9')
}.id('frame-' + this.code).width('100%').height(58).padding({ left: 18, right: 18 })
.border({ width: { bottom: 1 }, color: '#303C5F' })
}
}
@Entry
@Component
struct Index {
@State lazy: boolean = true;
@State measured: string = '待采样';
@State measuredKeys: string = '待采样';
private sheet: ContactSheet = new ContactSheet();
private appeared: Set<string> = new Set<string>();
private evaluated: Set<string> = new Set<string>();
private viewport: Scroller = new Scroller();
private mark(code: string): void { this.appeared.add(code); }
private identify(prefix: string, film: Film): string {
this.evaluated.add(film.code);
return prefix + film.code;
}
private toggle(): void {
this.viewport.scrollToIndex(0, false);
this.appeared.clear();
this.evaluated.clear();
this.measured = '待采样';
this.measuredKeys = '待采样';
this.lazy = !this.lazy;
}
build() {
Column({ space: 14 }) {
Row() {
Column({ space: 5 }) {
Text('底片目录').fontSize(42).fontColor('#F5F3FF').fontWeight(FontWeight.Bold)
Text('CONTACT SHEET / 240 格').fontSize(15).fontColor('#9CABDC')
}.alignItems(HorizontalAlign.Start).layoutWeight(1)
Button(this.lazy ? '切到 ForEach' : '切到 LazyForEach').id('film-toggle')
.onClick(() => this.toggle()).fontColor('#171F3F').backgroundColor('#D4DBFF')
}.width('100%')
Row({ space: 12 }) {
Text(this.lazy ? 'LazyForEach' : 'ForEach').id('film-mode')
.fontSize(18).fontColor('#C8D3FF').layoutWeight(1)
Button('跳到 073').id('film-jump').onClick(() => this.viewport.scrollToIndex(72, false))
.fontColor('#E4E8FF').backgroundColor('#293457')
Button('采样').id('film-measure').onClick(() => {
this.measured = this.appeared.size.toString();
this.measuredKeys = this.evaluated.size.toString();
})
.fontColor('#E4E8FF').backgroundColor('#293457')
}.width('100%')
List({ scroller: this.viewport }) {
if (this.lazy) {
LazyForEach(this.sheet, (film: Film) => {
ListItem() {
FrameLine({ code: film.code, caption: film.title, tint: film.tint,
report: (code: string): void => this.mark(code) })
}
}, (film: Film): string => this.identify('lazy-', film))
} else {
ForEach(this.sheet.rows, (film: Film) => {
ListItem() {
FrameLine({ code: film.code, caption: film.title, tint: film.tint,
report: (code: string): void => this.mark(code) })
}
}, (film: Film): string => this.identify('eager-', film))
}
}.width('100%').height(350).cachedCount(0).backgroundColor('#1F294A')
Row() {
Text('本轮出现过的行').fontSize(16).fontColor('#ADB9DF')
Text(this.measured).id('film-count').fontSize(27).fontWeight(FontWeight.Bold)
.fontColor('#E6FFAE').margin({ left: 12 })
Blank()
Text('处理过的不同键').fontSize(16).fontColor('#ADB9DF')
Text(this.measuredKeys).id('film-keys').fontSize(27).fontWeight(FontWeight.Bold)
.fontColor('#E6FFAE').margin({ left: 12 })
}.width('100%')
}.width('100%').padding({ top: 28, bottom: 20, left: '7%', right: '7%' })
.height('100%').align(Alignment.Top)
.backgroundColor('#171F3F')
}
}
准备 DevEco 的 ArkTS Stage 空工程时保留默认 Index 路由,替换页面代码,选 MateBook Pro 模拟器运行。本次 API 24 系统版本 6.1.0.125(SP12DEVC00E47R1P3)。启动后先看顶栏和「240 格」是否出现,断言当前模式是 LazyForEach,再按采样。换模式前后最好用同一窗口宽高,等待新内容建立再点。截图里两个大数字来自按键捕获,不自动刷新,所以按钮仍显示旧读数时先重新采样。做自己的测量还可把 viewport 的高和 row 的高一起打印,免得稍后窗口改了大小还把旧读数当作固定标准。
做独立回归时保留「只改一个条件」的版本。调高 cachedCount 时,先固定首屏尺寸和素材,再看附近是不是早准备了一两行,滑到远处是否更平滑。调高列表本身高度则是另一组实验,首屏会显示更多行。不要两者一起改,否则数据量变化不知归哪个原因。最后加上大图片做一次真实相册的冷与暖回放,记录首组缩略图可用时间和异步结果是否串项。这个练习的四组键和行计数可以作为动手验证的起点。
FAQ|屏幕一直写着「待采样」怎么办? 两个大数字只在按「采样」后显示,本轮初次打开和切换模式时都表现为「待采样」,不意味着集合等于零。按一次后若确实显示 0,再查 FrameLine 是否已经进入可见区、List 有无拿到数据,以及 toggle 是不是刚清过集合。
还有一个对照专门查样本是否被误读。关掉页面再进一次,把两套集合和当前模式都从初始观察开始;若界面保留旧号码,先确认那是历史采样还是这一轮重新统计。然后在同一模式下逐步往下滑,采到新带宽时核对具体新增的编号。这样能分辨程序是真的取了新一段,还是某条相同编号被重复加入计数。实际产品如果处理分页,把服务器返了哪几页与 UI 生成了哪几行留两份索引。两张表对不上并不一定是错误,例如已预取一页但还未上屏。把这类情况从异常里分出来,比直接让两个总数相等更符合列表行为。
FAQ|缓存数为零才能用按需列表吗? 示例用它让观察范围受控制。业务可以调缓存去平衡快速滚动的显示与资源占用,但修改后要重测,尤其是缩略图重的列表。窗口高度、行高和预留条目都会改变这张表,实测的七行只是这个设置下的记录。
还可以留一组只滚回去、不换模式的观察。两套集合不清,数字不能下降,但同一批编号重复出现也不应该再加。这能查出统计用了哪种口径。若想知道当前屏幕同时出现过什么,用当下可见范围另采一张表,别直接把累计数字作为当前活跃数量。
总结 七行在两边都能看到,键处理却走到了不同范围。把「出现」与「准备」分别记,才看得清 LazyForEach 在当前列表少处理的是什么。真实相册轮到更新与滚动时,还要加上身份和异步回写的验收。
如果只留一张图给同事就留首屏两列的读数,这比直接数屏幕上的照片更容易讲明白。
更多推荐
所有评论(0)