使用List + LazyForEach实现高性能笔记瀑布流布局

举报
yd_284811271 发表于 2026/11/09 17:17:48 2026/11/09
【摘要】 前言在笔记类应用里,瀑布流是很适合的布局形态:每条笔记卡片高度不统一,按照内容长短自适应填充,视觉上错落自然。HarmonyOS ArkUI 中,原生没有直接提供瀑布流组件,但我们可以基于 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也能用
  • 方案缺点:无法统一滚动上下文;新增/删除笔记时,列高度均衡逻辑需要自己维护

如果要做到真正对齐高度的瀑布流,需要:

  1. 监听每个卡片布局完成,拿到真实渲染高度 onAreaChange
  2. 维护左右两列当前总高度,新卡片总是追加到当前总高度更小的那一列
  3. 数据变更后重新分配,保证两列高度尽量均衡

进阶优化方向

  1. 真实高度测量:去掉模拟height,在卡片上绑定 onAreaChange 获取渲染后的真实高度,动态调度分到短列
  2. 下拉刷新 + 上拉加载:外层套 Refresh,在列表触底时追加笔记,重新执行分发均衡逻辑
  3. 动画增强:新增笔记入场动画,避免数据重排时页面闪烁
  4. 预加载:利用 LazyForEach 的预加载特性,提前渲染即将进入视口的卡片
  5. 多端适配:平板自动切换3列瀑布流,手机保持2列,使用 mediaQuery 判断设备类型

总结

ArkUI 没有内置瀑布流组件,但借助 List + LazyForEach 可以低成本实现笔记场景的瀑布流布局,非常适合灵感笔记这类内容高度不确定的应用。这套方案上手门槛低,懒加载机制天然解决长列表性能问题,是当前开发笔记类应用很实用的落地方案。
如果追求工业级完美瀑布流,就需要自己封装高度均衡调度逻辑,这也是后续可以继续迭代的技术点。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。