使用List + LazyForEach实现高性能笔记瀑布流布局
前言
在笔记类应用里,瀑布流是很适合的布局形态:每条笔记卡片高度不统一,按照内容长短自适应填充,视觉上错落自然。HarmonyOS ArkUI 中,原生没有直接提供瀑布流组件,但我们可以基于 List + LazyForEach 配合多列布局实现,同时利用懒加载规避大量笔记数据一次性渲染造成的卡顿。
本文聚焦纯技术实现,讲清楚选型理由、完整代码、性能要点以及可优化方向。
选型思考
很多开发者第一想法是用 Grid 做多列瀑布流,但是 Grid 有一个短板:单元格高度默认对齐,很难实现高度动态、错落排布。
Grid:适合尺寸相对规整的卡片(相册、图标)List + LazyForEach + 自定义列分发:适合不定高内容,实现瀑布流效果,滚动复用能力更好,和笔记场景匹配
核心思路:提前把笔记数据分发到左右两个数据队列,渲染两个并排 List,各自独立滚动、互不干扰,形成视觉上的瀑布流。
完整实现代码
1. 笔记实体类与懒加载数据源
// NoteItem.ets
export class NoteItem {
id: string;
title: string;
content: string;
height: number; // 模拟动态高度,真实场景由内容测量得到
constructor(id: string, title: string, content: string, height: number) {
this.id = id;
this.title = title;
this.content = content;
this.height = height;
}
}
// 懒加载数据源
export class NoteDataSource implements IDataSource {
private notes: NoteItem[] = [];
private listeners: DataChangeListener[] = [];
constructor(list: NoteItem[]) {
this.notes = list;
}
totalCount(): number {
return this.notes.length;
}
getData(index: number): NoteItem {
return this.notes[index];
}
registerDataChangeListener(listener: DataChangeListener): void {
this.listeners.push(listener);
}
unregisterDataChangeListener(listener: DataChangeListener): void {
this.listeners.splice(this.listeners.indexOf(listener), 1);
}
notifyDataReload(): void {
this.listeners.forEach(listener => listener.onDataReloaded());
}
}
2. 瀑布流页面主代码
// WaterfallNotePage.ets
import { NoteItem, NoteDataSource } from './NoteItem'
@Entry
@Component
struct WaterfallNotePage {
@State leftList: NoteItem[] = []
@State rightList: NoteItem[] = []
@State leftDs: NoteDataSource = new NoteDataSource([])
@State rightDs: NoteDataSource = new NoteDataSource([])
aboutToAppear() {
// 构造模拟笔记数据,高度随机模拟不同内容长度
const rawData: NoteItem[] = []
for (let i = 0; i < 30; i++) {
const h = 120 + Math.floor(Math.random() * 180)
rawData.push(new NoteItem(
`${i}`,
`笔记标题 ${i + 1}`,
`这里是笔记正文,记录灵感、想法、待办,长短不一。`,
h
))
}
// 分发策略:短的放左边、长的放右边,也可以轮流分配
this.dispatchData(rawData)
}
// 分发数据到两列
dispatchData(raw: NoteItem[]) {
const l: NoteItem[] = []
const r: NoteItem[] = []
raw.forEach((item, idx) => {
if (idx % 2 === 0) {
l.push(item)
} else {
r.push(item)
}
})
this.leftList = l
this.rightList = r
this.leftDs = new NoteDataSource(l)
this.rightDs = new NoteDataSource(r)
}
// 笔记卡片组件
@Builder NoteCard(item: NoteItem) {
Column() {
Text(item.title)
.fontSize(16)
.fontWeight(FontWeight.Medium)
.width('100%')
Text(item.content)
.fontSize(14)
.fontColor('#666')
.margin({ top: 6 })
}
.padding(12)
.width('100%')
.borderRadius(12)
.backgroundColor('#fff')
.shadow({ radius: 6, color: '#1A000000', offsetY: 2 })
}
build() {
Column() {
Text('灵感笔记瀑布流')
.fontSize(20)
.fontWeight(FontWeight.Bold)
.margin(16)
Row() {
// 左列 List
List() {
LazyForEach(this.leftDs, (item: NoteItem) => {
ListItem() {
this.NoteCard(item)
}
}, (item: NoteItem) => item.id)
}
.layoutWeight(1)
.space(12)
.scrollBar(BarState.Off)
// 右列 List
List() {
LazyForEach(this.rightDs, (item: NoteItem) => {
ListItem() {
this.NoteCard(item)
}
}, (item: NoteItem) => item.id)
}
.layoutWeight(1)
.space(12)
.margin({ left: 8 })
.scrollBar(BarState.Off)
}
.padding({ left: 16, right: 16 })
.width('100%')
.height('100%')
}
.width('100%')
.height('100%')
.backgroundColor('#F5F5F5')
}
}
效果说明
运行后,页面分为左右两列,各自独立滚动。笔记卡片高度随机,形成错落的瀑布流视觉效果;依靠 LazyForEach,只有进入视口的卡片才会创建组件实例,滚动长列表时内存和帧率表现远优于一次性循环渲染 ForEach。
现存技术痛点(也就是可以提 Issue 的点)
这种双List方案有一个经典缺陷:两列滚动不同步。上下滑动时,左右滚动位置各自独立,不是一个真正统一的瀑布流。
- 方案优点:实现简单、性能稳定、兼容性好,低版本SDK也能用
- 方案缺点:无法统一滚动上下文;新增/删除笔记时,列高度均衡逻辑需要自己维护
如果要做到真正对齐高度的瀑布流,需要:
- 监听每个卡片布局完成,拿到真实渲染高度
onAreaChange - 维护左右两列当前总高度,新卡片总是追加到当前总高度更小的那一列
- 数据变更后重新分配,保证两列高度尽量均衡
进阶优化方向
- 真实高度测量:去掉模拟height,在卡片上绑定
onAreaChange获取渲染后的真实高度,动态调度分到短列 - 下拉刷新 + 上拉加载:外层套
Refresh,在列表触底时追加笔记,重新执行分发均衡逻辑 - 动画增强:新增笔记入场动画,避免数据重排时页面闪烁
- 预加载:利用
LazyForEach的预加载特性,提前渲染即将进入视口的卡片 - 多端适配:平板自动切换3列瀑布流,手机保持2列,使用
mediaQuery判断设备类型
总结
ArkUI 没有内置瀑布流组件,但借助 List + LazyForEach 可以低成本实现笔记场景的瀑布流布局,非常适合灵感笔记这类内容高度不确定的应用。这套方案上手门槛低,懒加载机制天然解决长列表性能问题,是当前开发笔记类应用很实用的落地方案。
如果追求工业级完美瀑布流,就需要自己封装高度均衡调度逻辑,这也是后续可以继续迭代的技术点。
- 点赞
- 收藏
- 关注作者
评论(0)