HarmonyOS 鸿蒙Next的 List 组件如何实现“瀑布流”布局（Waterfall）？

【背景知识】 瀑布流容器，由“行”和“列”分割的单元格所组成，通过容器自身的排列规则，将不同大小的“项目”自上而下，如瀑布般紧密布局。 瀑布流布局的特点：

• 每一列盒子的宽度一致，盒子的高度不一致。
• 自上而下，形成参差错落效果。

瀑布流布局是一种常见的网页或应用界面布局方式，它通过动态排列一组高度不一的元素，给予用户一种流畅的视觉体验。在HarmonyOS开发中，虽然具体的API可能与Web开发有所不同，但基本原理可以借鉴。以下是在HarmonyOS中实现瀑布流布局的一般步骤：

1. 布局设计：首先，需要设计一个容器来容纳瀑布流的物品。这可以通过使用List或Grid布局组件来实现，具体选择取决于你的应用场景和需求。
2. 动态高度设置：瀑布流的关键在于每个物品的高度是动态的，这通常通过编程方式动态计算并设置。在HarmonyOS中，可以根据数据动态改变组件的height属性来实现这一效果。
3. 加载和渲染：根据数据动态生成界面元素，并将其添加到布局容器中。这一步骤通常涉及到数据绑定和事件监听，确保数据变化时视图能够更新。
4. 优化性能：为了保证应用的性能，可以采用虚拟滚动技术，即只渲染视线内的物品，从而优化滚动性能和减少内存使用。

【解决方案】 以下示例展示了WaterFlow组件数据加载处理、属性设置和事件回调等基本使用场景。 示例代码如下所示： WaterFlowDataSource.ets。

export class WaterFlowDataSource implements IDataSource {
  private dataArray: number[] = []
  private listeners: DataChangeListener[] = []

  constructor() {
    for (let i = 0; i < 1000; i++) {
      this.dataArray.push(i)
    }
  }

  // 获取索引对应的数据
  public getData(index: number): number {
    return this.dataArray[index]
  }

  // 通知控制器数据重新加载
  notifyDataReload(): void {
    this.listeners.forEach(listener => {
      listener.onDataReloaded()
    })
  }

  // 通知控制器数据增加
  notifyDataAdd(index: number): void {
    this.listeners.forEach(listener => {
      listener.onDataAdd(index)
    })
  }

  // 通知控制器数据变化
  notifyDataChange(index: number): void {
    this.listeners.forEach(listener => {
      listener.onDataChange(index)
    })
  }

  // 通知控制器数据删除
  notifyDataDelete(index: number): void {
    this.listeners.forEach(listener => {
      listener.onDataDelete(index)
    })
  }

  // 通知控制器数据位置变化
  notifyDataMove(from: number, to: number): void {
    this.listeners.forEach(listener => {
      listener.onDataMove(from, to)
    })
  }

  // 获取数据总数
  public totalCount(): number {
    return this.dataArray.length
  }

  // 注册改变数据的控制器
  registerDataChangeListener(listener: DataChangeListener): void {
    if (this.listeners.indexOf(listener) < 0) {
      this.listeners.push(listener)
    }
  }

  // 注销改变数据的控制器
  unregisterDataChangeListener(listener: DataChangeListener): void {
    const pos = this.listeners.indexOf(listener)
    if (pos >= 0) {
      this.listeners.splice(pos, 1)
    }
  }

  // 增加数据
  public Add1stItem(): void {
    this.dataArray.splice(0, 0, this.dataArray.length)
    this.notifyDataAdd(0)
  }

  // 在数据尾部增加一个元素
  public AddLastItem(): void {
    this.dataArray.splice(this.dataArray.length, 0, this.dataArray.length)
    this.notifyDataAdd(this.dataArray.length - 1)
  }

  // 在指定索引位置增加一个元素
  public AddItem(index: number): void {
    this.dataArray.splice(index, 0, this.dataArray.length)
    this.notifyDataAdd(index)
  }

  // 删除第一个元素
  public Delete1stItem(): void {
    this.dataArray.splice(0, 1)
    this.notifyDataDelete(0)
  }

  // 删除第二个元素
  public Delete2ndItem(): void {
    this.dataArray.splice(1, 1)
    this.notifyDataDelete(1)
  }

  // 删除最后一个元素
  public DeleteLastItem(): void {
    this.dataArray.splice(-1, 1)
    this.notifyDataDelete(this.dataArray.length)
  }

  // 重新加载数据
  public Reload(): void {
    this.dataArray.splice(1, 1)
    this.dataArray.splice(3, 2)
    this.notifyDataReload()
  }
}

WaterFlowDemo.ets。

import { WaterFlowDataSource } from './WaterFlowDataSource'

@Entry
@Component
struct WaterFlowDemo {
  @State fontSize: number = 24
  @State colors: number[] = [0xFFC0CB, 0xDA70D6, 0x6B8E23, 0x6A5ACD, 0x00FFFF, 0x00FF7F]
  scroller: Scroller = new Scroller()
  datasource: WaterFlowDataSource = new WaterFlowDataSource()
  private itemWidthArray: number[] = []
  private itemHeightArray: number[] = []

  // 计算flow item宽/高
  getSize() {
    return 100
  }

  // 保存flow item宽/高
  getItemSizeArray() {
    for (let i = 0; i < 1000; i++) {
      this.itemWidthArray.push(this.getSize())
      this.itemHeightArray.push(this.getSize())
    }
  }

  aboutToAppear() {
    this.getItemSizeArray()
  }

  @Builder
  itemFoot() {
    Column() {
      Text(`Footer`)
        .fontSize(10)
        .backgroundColor(Color.Red)
        .width(50)
        .height(50)
        .align(Alignment.Center)
        .margin({ top: 2 })
    }
  }

  build() {
    Column({ space: 2 }) {
      WaterFlow() {
        LazyForEach(this.datasource, (item: number, index: number) => {
          FlowItem() {
            Column() {
              if (this.itemWidthArray[index] > 100) {
                Grid() {
                  GridItem() {
                    Text("N" + item)
                      .fontSize(16)
                      .width('100%')
                      .height('100%')
                      .textAlign(TextAlign.Center)
                  }.columnStart(1).columnEnd(2)
                }
              } else {
                Grid() {
                  GridItem() {
                    Text("N" + item)
                      .fontSize(16)
                      .width('100%')
                      .height('100%')
                      .textAlign(TextAlign.Center)
                      .borderStyle(BorderStyle.Dashed)
                      .borderWidth(5)
                      .borderColor(Color.Red)
                      .borderRadius(10)
                  }

                  GridItem() {
                    Text("N1" + item)
                      .fontSize(16)
                      .width('100%')
                      .height('100%')
                      .textAlign(TextAlign.Center)
                      .borderStyle(BorderStyle.Dashed)
                      .borderWidth(5)
                      .borderColor(Color.Green)
                      .borderRadius(10)
                  }
                }
                .columnsTemplate('1fr 1fr')
              }
            }
          }
          .onAppear(() => {
            // 即将触底时提前增加数据
            if (item + 20 == this.datasource.totalCount()) {
              for (let i = 0; i < 100; i++) {
                this.datasource.AddLastItem()
              }
            }
          })
          .width('100%')
          .height(this.itemHeightArray[item % 100])
          .backgroundColor(this.colors[item % 5])
        }, (item: string) => item)
      }
      .columnsTemplate("1fr")
      .columnsGap(10)
      .rowsGap(5)
      .backgroundColor(0xFAEEE0)
      .width('100%')
      .height('100%')
    }
  }
}