WaterFlow的使用范例有哪些?

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

HarmonyOS
2024-05-26 15:12:05
浏览
收藏 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%') 
    } 
  } 
}

注明适配的版本信息

  •  IDE:DevEco Studio 4.0.1.501
  • SDK:HarmoneyOS 4.0.10.11
分享
微博
QQ
微信
回复
2024-05-27 20:14:13
相关问题
关于Grid容器和WaterFlow使用问题
484浏览 • 1回复 待解决
公共事件哪些简单使用
516浏览 • 1回复 待解决
MongoDB优势哪些
2841浏览 • 1回复 待解决
NoSQLMongoDB哪些优点?
2842浏览 • 1回复 待解决
哪些创建线程方式
1074浏览 • 1回复 待解决
PolarDB MySQL 参数哪些
1833浏览 • 1回复 待解决
支持鸿蒙系统手机哪些
3843浏览 • 2回复 待解决
访问控制系统控件哪些
47浏览 • 1回复 待解决
redis相比memcached优势哪些
1378浏览 • 1回复 待解决
哪些好用MySQL监控软件?
1047浏览 • 1回复 待解决
ability主题哪些可以设置?
15629浏览 • 3回复 待解决
Waterflow怎么添加header能力?
31浏览 • 1回复 待解决
Scroll与WaterFlow滑动嵌套
477浏览 • 1回复 待解决
数据持久化方式哪些
420浏览 • 1回复 待解决
Greenplum哪些通用处理方法?
2282浏览 • 1回复 待解决
屏幕自动旋转示例哪些
62浏览 • 1回复 待解决
ArkTS实现时钟方式哪些
436浏览 • 1回复 待解决
物联网操作系统哪些
4476浏览 • 1回复 待解决
GlobalThis替代方案哪些
472浏览 • 1回复 待解决
ArkUI调试技巧哪些
259浏览 • 1回复 待解决
OceanBase业务案例哪些
2822浏览 • 1回复 待解决