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
相关问题
LazyForEach使用限制哪些
355浏览 • 1回复 待解决
List使用问题哪些
244浏览 • 1回复 待解决
Marquee组件使用问题哪些
181浏览 • 0回复 待解决
关于Grid容器和WaterFlow使用问题
782浏览 • 1回复 待解决
公共事件哪些简单使用
797浏览 • 1回复 待解决
MongoDB优势哪些
4051浏览 • 1回复 待解决
NoSQLMongoDB哪些优点?
3825浏览 • 1回复 待解决
PolarDB MySQL 参数哪些
2859浏览 • 1回复 待解决
HarmonyOS api作用哪些
289浏览 • 1回复 待解决
背景属性问题哪些
322浏览 • 1回复 待解决
哪些创建线程方式
2086浏览 • 1回复 待解决
webview 问题哪些
137浏览 • 1回复 待解决
ability主题哪些可以设置?
16803浏览 • 3回复 待解决
redis相比memcached优势哪些
2292浏览 • 1回复 待解决
访问控制系统控件哪些
304浏览 • 1回复 待解决
查看文件列表方式哪些
275浏览 • 1回复 待解决
哪些好用MySQL监控软件?
2302浏览 • 1回复 待解决
支持鸿蒙系统手机哪些
4754浏览 • 2回复 待解决
Tabs滑动距离问题哪些
210浏览 • 1回复 待解决
网络监听最佳实践哪些
344浏览 • 1回复 待解决