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使用限制哪些
518浏览 • 1回复 待解决
使用具体类型哪些
166浏览 • 1回复 待解决
uiTest使用问题哪些
300浏览 • 1回复 待解决
List使用问题哪些
305浏览 • 1回复 待解决
Marquee组件使用问题哪些
276浏览 • 0回复 待解决
公共事件哪些简单使用
898浏览 • 1回复 待解决
关于Grid容器和WaterFlow使用问题
853浏览 • 1回复 待解决
Scroll与WaterFlow滑动嵌套
978浏览 • 1回复 待解决
Waterflow怎么添加header能力?
413浏览 • 1回复 待解决
MongoDB优势哪些
4133浏览 • 1回复 待解决
NoSQLMongoDB哪些优点?
3925浏览 • 1回复 待解决
HarmonyOS api作用哪些
389浏览 • 1回复 待解决
哪些创建线程方式
2175浏览 • 1回复 待解决
PolarDB MySQL 参数哪些
2958浏览 • 1回复 待解决
背景属性问题哪些
423浏览 • 1回复 待解决