WaterFlow的使用范例有哪些?

瀑布流容器,由“行”和“列”分割的单元格所组成,通过容器自身的排列规则,将不同大小的“项目”自上而下,如瀑布般紧密布局。

HarmonyOS
2024-05-26 15:12:05
7401浏览
收藏 0
回答 1
回答 1
按赞同
/
按时间
netos

使用的核心API

名称

功能描述

onReachStart(event: () => void)

瀑布流组件到达起始位置时触发。

onReachEnd(event: () => void)

瀑布流组件到底末尾位置时触发。

onScrollFrameBegin10+(event: (offset: number, state: ScrollState) => { offsetRemain })

瀑布流开始滑动时触发,事件参数传入即将发生的滑动量,事件处理函数中可根据应用场景计算实际需要的滑动量并作为事件处理函数的返回值返回,瀑布流将按照返回值的实际滑动量进行滑动。

- offset:即将发生的滑动量,单位vp。

- state:当前滑动状态。

- offsetRemain:实际滑动量,单位vp。

触发该事件的条件:手指拖动WaterFlow、WaterFlow惯性划动时每帧开始时触发;List超出边缘回弹、使用滚动控制器的滚动不会触发。

核心代码解释

// WaterFlowDataSource.ets 
 
// 实现IDataSource接口的对象,用于瀑布流组件加载数据 
export class WaterFlowDataSource implements IDataSource { 
  private dataArray: number[] = [] 
  private listeners: DataChangeListener[] = [] 
 
  constructor() { 
    for (let i = 0; i < 100; 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.onDataAdded(index) 
    }) 
  } 
 
  // 通知控制器数据变化 
  notifyDataChange(index: number): void { 
    this.listeners.forEach(listener => { 
      listener.onDataChanged(index) 
    }) 
  } 
 
  // 通知控制器数据删除 
  notifyDataDelete(index: number): void { 
    this.listeners.forEach(listener => { 
      listener.onDataDeleted(index) 
    }) 
  } 
 
  // 通知控制器数据位置变化 
  notifyDataMove(from: number, to: number): void { 
    this.listeners.forEach(listener => { 
      listener.onDataMoved(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() 
  } 
}
// Index.ets 
import { WaterFlowDataSource } from './WaterFlowDataSource' 
 
@Entry 
@Component 
struct WaterFlowDemo { 
  @State minSize: number = 80 
  @State maxSize: number = 180 
  @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() { 
    let ret = Math.floor(Math.random() * this.maxSize) 
    return (ret > this.minSize ? ret : this.minSize) 
  } 
 
  // 保存flow item宽/高 
  getItemSizeArray() { 
    for (let i = 0; i < 100; 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) => { 
          FlowItem() { 
            Column() { 
              Text("N" + item).fontSize(12).height('16') 
              Image('res/waterFlowTest(' + item % 5 + ').jpg') 
                .objectFit(ImageFit.Fill) 
                .width('100%') 
                .layoutWeight(1) 
            } 
          } 
          .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 1fr") 
      .columnsGap(10) 
      .rowsGap(5) 
      .backgroundColor(0xFAEEE0) 
      .width('100%') 
      .height('100%') 
    } 
  } 
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.
  • 58.
  • 59.
  • 60.
  • 61.
  • 62.
  • 63.
  • 64.
  • 65.
  • 66.
  • 67.
  • 68.
  • 69.
  • 70.
  • 71.
  • 72.
  • 73.
  • 74.
  • 75.
  • 76.
  • 77.
  • 78.
  • 79.
  • 80.
  • 81.
  • 82.
  • 83.
  • 84.
  • 85.
  • 86.
  • 87.
  • 88.
  • 89.
  • 90.
  • 91.
  • 92.
  • 93.
  • 94.
  • 95.
  • 96.
  • 97.
  • 98.
  • 99.
  • 100.
  • 101.
  • 102.
  • 103.
  • 104.
  • 105.
  • 106.
  • 107.
  • 108.
  • 109.
  • 110.
  • 111.
  • 112.
  • 113.
  • 114.
  • 115.
  • 116.
  • 117.
  • 118.
  • 119.
  • 120.
  • 121.
  • 122.
  • 123.
  • 124.
  • 125.
  • 126.
  • 127.
  • 128.
  • 129.
  • 130.
  • 131.
  • 132.
  • 133.
  • 134.
  • 135.
  • 136.
  • 137.
  • 138.
  • 139.
  • 140.
  • 141.
  • 142.
  • 143.
  • 144.
  • 145.
  • 146.
  • 147.
  • 148.
  • 149.
  • 150.
  • 151.
  • 152.
  • 153.
  • 154.
  • 155.
  • 156.
  • 157.
  • 158.
  • 159.
  • 160.
  • 161.
  • 162.
  • 163.
  • 164.
  • 165.
  • 166.
  • 167.
  • 168.
  • 169.
  • 170.
  • 171.
  • 172.
  • 173.
  • 174.
  • 175.
  • 176.
  • 177.
  • 178.
  • 179.
  • 180.
  • 181.
  • 182.
  • 183.
  • 184.
  • 185.
  • 186.
  • 187.
  • 188.
  • 189.
  • 190.
  • 191.
  • 192.
  • 193.
  • 194.
  • 195.
  • 196.
  • 197.

注明适配的版本信息

  •  IDE:DevEco Studio 4.0.1.501
  • SDK:HarmoneyOS 4.0.10.11
分享
微博
QQ
微信
回复
2024-05-27 20:14:13
相关问题
HarmonyOS lazyForEach相关范例
933浏览 • 1回复 待解决
LazyForEach使用限制哪些
1459浏览 • 1回复 待解决
使用具体类型哪些
1151浏览 • 1回复 待解决
uiTest使用问题哪些
1176浏览 • 1回复 待解决
List使用问题哪些
1246浏览 • 1回复 待解决
Marquee组件使用问题哪些
1144浏览 • 0回复 待解决
关于Grid容器和WaterFlow使用问题
1443浏览 • 1回复 待解决
公共事件哪些简单使用
1743浏览 • 1回复 待解决
MongoDB优势哪些
5228浏览 • 1回复 待解决
HarmonyOS特性哪些
749浏览 • 1回复 待解决
NoSQLMongoDB哪些优点?
4626浏览 • 1回复 待解决
媒体逻辑操作符哪些,都怎么使用?
1086浏览 • 1回复 待解决
PolarDB MySQL 参数哪些
3850浏览 • 1回复 待解决
HarmonyOS api作用哪些
1038浏览 • 1回复 待解决
哪些创建线程方式
3160浏览 • 1回复 待解决
背景属性问题哪些
1075浏览 • 1回复 待解决
webview 问题哪些
1145浏览 • 1回复 待解决