HarmonyOS应用开发：WaterFlow（容器组件）

于 2024-06-19 15:35:25 发布
阅读量1k 收藏 21
点赞数 27
分类专栏： 鸿蒙 文章标签： harmonyos 华为 windows 鸿蒙系统 android 鸿蒙
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/situnanQAQ/article/details/139804887
版权

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

说明：

该组件从API Version 9 开始支持。

子组件

包含FlowItem子组件。

说明：

WaterFlow子组件的visibility属性设置为None时不显示，但该子组件周围的gap还会生效。

接口

WaterFlow(options?: {footer?: CustomBuilder, scroller?: Scroller})

参数：

参数名参数类型必填参数描述
footerCustomBuilder否设置WaterFlow尾部组件。
scrollerScroller否可滚动组件的控制器，与可滚动组件绑定。
目前瀑布流仅支持Scroller组件的scrollToIndex接口。

属性

除支持通用属性外，还支持以下属性：

名称参数类型描述
columnsTemplatestring设置当前瀑布流组件布局列的数量，不设置时默认1列。
例如, '1fr 1fr 2fr' 是将父组件分3列，将父组件允许的宽分为4等份，第一列占1份，第二列占1份，第三列占2份。
可使用columnsTemplate('repeat(auto-fill,track-size)')根据给定的列宽track-size自动计算列数，其中repeat、auto-fill为关键字，track-size为可设置的宽度，支持的单位包括px、vp、%或有效数字，使用方法参见示例2。
默认值：'1fr'
rowsTemplatestring设置当前瀑布流组件布局行的数量，不设置时默认1行。
例如, '1fr 1fr 2fr'是将父组件分三行，将父组件允许的高分为4等份，第一行占1份，第二行占一份，第三行占2份。
可使用rowsTemplate('repeat(auto-fill,track-size)')根据给定的行高track-size自动计算行数，其中repeat、auto-fill为关键字，track-size为可设置的高度，支持的单位包括px、vp、%或有效数字。
默认值：'1fr'
itemConstraintSizeConstraintSizeOptions设置约束尺寸，子组件布局时，进行尺寸范围限制。
columnsGapLength设置列与列的间距。
默认值：0
rowsGapLength设置行与行的间距。
默认值：0
layoutDirectionFlexDirection设置布局的主轴方向。
默认值：FlexDirection.Column
enableScrollInteraction10+boolean设置是否支持滚动手势，当设置为false时，无法通过手指或者鼠标滚动，但不影响控制器的滚动接口。
默认值：true
nestedScroll10+NestedScrollOptions嵌套滚动选项。设置向前向后两个方向上的嵌套滚动模式，实现与父组件的滚动联动。
friction10+number | Resource设置摩擦系数，手动划动滚动区域时生效，只对惯性滚动过程有影响，对惯性滚动过程中的链式效果有间接影响。
默认值：非可穿戴设备为0.6，可穿戴设备为0.9
说明：
设置为小于等于0的值时，按默认值处理

layoutDirection优先级高于rowsTemplate和columnsTemplate。根据layoutDirection设置情况，分为以下三种设置模式:

  • layoutDirection设置纵向布局（FlexDirection.Column 或 FlexDirection.ColumnReverse）

    此时columnsTemplate有效（如果未设置，取默认值）。例如columnsTemplate设置为"1fr 1fr"、rowsTemplate设置为"1fr 1fr 1fr"时，瀑布流组件纵向布局，辅轴均分成横向2列。

  • layoutDirection设置横向布局（FlexDirection.Row 或 FlexDirection.RowReverse）

    此时rowsTemplate有效（如果未设置，取默认值）。例如columnsTemplate设置为"1fr 1fr"、rowsTemplate设置为"1fr 1fr 1fr"时，瀑布流组件横向布局，辅轴均分成纵向3列。

  • layoutDirection未设置布局方向

    布局方向为layoutDirection的默认值：FlexDirection.Column，此时columnsTemplate有效。例如columnsTemplate设置为"1fr 1fr"、rowsTemplate设置为"1fr 1fr 1fr"时，瀑布流组件纵向布局，辅轴均分成横向2列。

事件

除支持通用事件外，还支持以下事件：

名称功能描述
onReachStart(event: () => void)瀑布流组件到达起始位置时触发。
onReachEnd(event: () => void)瀑布流组件到底末尾位置时触发。
onScrollFrameBegin10+(event: (offset: number, state: ScrollState) => { offsetRemain })瀑布流开始滑动时触发，事件参数传入即将发生的滑动量，事件处理函数中可根据应用场景计算实际需要的滑动量并作为事件处理函数的返回值返回，瀑布流将按照返回值的实际滑动量进行滑动。
- offset：即将发生的滑动量，单位vp。
- state：当前滑动状态。
- offsetRemain：实际滑动量，单位vp。
触发该事件的条件：手指拖动WaterFlow、WaterFlow惯性划动时每帧开始时触发；List超出边缘回弹、使用滚动控制器的滚动不会触发。

示例

示例1

WaterFlow的基本使用。

// 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%')
    }
  }
}

zh-cn_image_WaterFlow.gif

示例2

auto-fill的使用。

//index.ets
import { WaterFlowDataSource } from './WaterFlowDataSource'

@Entry
@Component
struct WaterflowDemo {
  @State minSize: number = 80
  @State maxSize: number = 180
  @State colors: number[] = [0xFFC0CB, 0xDA70D6, 0x6B8E23, 0x6A5ACD, 0x00FFFF, 0x00FF7F]
  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()
  }

  build() {
    Column({ space: 2 }) {
      WaterFlow() {
        LazyForEach(this.datasource, (item: number) => {
          FlowItem() {
            Column() {
              Text("N" + item).fontSize(12).height('16')
            }
          }
          .width('100%')
          .height(this.itemHeightArray[item % 100])
          .backgroundColor(this.colors[item % 5])
        }, (item: string) => item)
      }
      .columnsTemplate('repeat(auto-fill,80)')
      .columnsGap(10)
      .rowsGap(5)
      .padding({left:5})
      .backgroundColor(0xFAEEE0)
      .width('100%')
      .height('100%')
    }
  }
}

waterflow_auto-fill.png

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。 

司徒南QAQ
关注
  • 27
    点赞
  • 踩
  • 21
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
鸿蒙Harmony应用开发—ArkTS声明式开发（容器组件：WaterFlow）
m0_64420071的博客
03-16 995
ArkTS声明式开发（容器组件：WaterFlow）
鸿蒙next开发：WaterFlow高性能开发指南
shudaoshanQAQ的博客
05-21 724
瀑布流常用于展示图片信息，如多用于购物、资讯类应用。
瀑布流布局TS
m0_47195133的博客
09-12 236
瀑布流的实现 TS
【ArkTS】 WaterFlow瀑布流容器的使用
weixin_38622593的博客
12-08 288
arkts瀑布流开发
鸿蒙开发之瀑布流&宫格布局
karision的博客
03-19 1167
瀑布流布局适用于卡片式结构。折叠态的单列卡片，到展开态显示双列卡片，不同高度的卡片形成错落有致的瀑布流布局。可以有效提升页面的浏览效率和可视化效果。瀑布流容器，由“行”和“列”分割的单元格所组成，通过容器自身的排列规则，将不同大小的“项目”自上而下，如瀑布般紧密布局。说明该组件从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
react-wavify::desert_island: :water_wave: React 动画波组件
07-24
一个简单的 React 组件，它创建一个动画波浪。 该组件大量改编自令人敬畏的并且在功能上类似于的插件。 安装 纱 yarn add react-wavify 新产品经理 npm install react-wavify 用法 import React from 'react' ...
WaterFlow:iOS 瀑布流，通过继承UICollectionViewLayout实现
07-12
WaterFlow iOS 瀑布流，通过继承UICollectionViewLayout简单的实现 欢迎根据自己的需要对它进行修改。
baiduimgShowManager:瀑布流 百度图片 waterflow
05-21
瀑布流参考 博客园 文顶顶->ios开发ui篇-自定义瀑布里控件 使用李明杰提供的MJRefresh(下拉刷新),MJPhotoBrowser(图片预览) 集成第三方库:jsonkit,asihttprequest,mbprogressHUB 如有疑问请联系:envelope:080818....
seapig::water_wave::pig_face:用于React组件的一般组成的实用程序
04-27
海猪 :water_wave: :pig_face:海猪代表（C承运P ROPS我nternalģ埃特），除了C是音素拼写。目录 seapig seapig 做seapig做什么！ seapig在这里可以帮助您以一致且灵活的方式seapig React组件。 它提供了一种将组成...
aframe-super-shooter-kit::water_pistol:A-Frame组件套件，用于制作简单的WebVR射击游戏迷你游戏
05-06
组件，用于制作简单的WebVR射击游戏迷你游戏。 来自A-Frame，Supermedium和Supercraft的创建者。 该工具包由一组简单易用的组件组成，可提供一种构建简单射击体验的方式，其中“射手”射击可以击中“目标”的“子弹...
鸿蒙开发实战项目(九):WaterFlow容器的使用（ArkTS）
sybh的博客
01-26 947
本篇Codelab主要介绍WaterFlow容器的使用。如图所示对高度不相等的子组件，实现如瀑布般的紧密布局。
鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之WaterFlow容器组件
zy0412326的专栏
03-15 1436
鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之WaterFlow容器组件。
【HarmonyOS】js文件常见的数组操作1
weixin_58073445的博客
03-18 661
讲述了.js文件中数组长度的读取，数组元素的打印、删除和添加
（五）鸿蒙HarmonyOS主力开发语言ArkTS-数据懒加载(LazyForEach)
qq_44160056的博客
04-01 1397
系列文章目录 （一）鸿蒙HarmonyOS开发基础 （二）鸿蒙HarmonyOS主力开发语言ArkTS-基本语法 （三）鸿蒙HarmonyOS主力开发语言ArkTS-状态管理 （四）鸿蒙HarmonyOS主力开发语言ArkTS-渲染控制 文章目录系列文章目录LazyForEach：数据懒加载接口描述IDataSource类型说明DataChangeListener类型说明使用限制键值生成规则组件创建规则首次渲染 LazyForEach：数据懒加载 LazyForEach从提供的数据源中按需迭代数据，并在
鸿蒙开发之LazyForEach及刷新问题
Lu_Ca的博客
02-20 1776
在开发过程中会遇到list、grid的item过多的情况。例如某些新闻类、某些购物类的页面，如果我们有大量的数据，直接通过ForEach进行全量渲染会直接把手机卡死。这样肯定是不行的，这个时候LazyForEach就该登场了。LazyForEach主要是用来针对列表数据量大、列表组件复杂的场景，减少了页面一次性加载数据的时间消耗，减少了内存峰值。可以显著提升页面的能效比和用户体验。实现原理就是它会从提供的数据源中按需迭代数据，并在每次迭代过程中创建相应的组件。
HarmonyOS实战开发：LazyForEach：数据懒加载
2401_84194030的博客
04-23 944
LazyForEach从提供的数据源中按需迭代数据，并在每次迭代过程中创建相应的组件。
HarmonyOS-LazyForEach：数据懒加载
2301_81624474的博客
01-24 1327
LazyForEach从提供的数据源中按需迭代数据，并在每次迭代过程中创建相应的组件。当在滚动容器中使用了LazyForEach，框架会根据滚动容器可视区域按需创建组件，当组件滑出可视区域外时，框架会进行组件销毁回收以降低内存占用。
HarmonyOS实战开发-合理使用自定义组件冻结功能
2401_82546228的博客
05-09 1024
自定义组件冻结功能是指通过设置freezeWhenInactive属性为true，对非激活页面或者自定义组件进行冻结，使其不响应状态变量引起的UI刷新。当状态变量改变时，处于非激活状态的页面或自定义组件的状态变量将不响应更新，状态变量的@Watch函数不会调用，关联的节点不会刷新。只有当页面或者自定义组件重新激活或者可见时，才会去更新状态变量。本文将介绍冻结功能的原理机制和使用场景，并且通过懒加载场景下使用冻结功能前后的性能对比，帮忙开发者优化页面性能，减少页面渲染的时间，提升用户体验。
[鸿蒙] --- 使用LazyForEach懒加载数据列表
最新发布
qq_45774739的博客
06-03 1033
LazyForEach从提供的数据源中按需迭代数据，并在每次迭代过程中创建相应的组件。当在滚动容器中使用了LazyForEach，框架会根据滚动容器可视区域按需创建组件，当组件滑出可视区域外时，框架会进行组件销毁回收以降低内存占用。简而言之，其实它和前端的虚拟列表基本一样，只渲染可见区域的数据，来提升页面的响应速度，减少卡顿。
Android项目开发实战_益智类游戏-Wo!Water!_编程案例解析实例详解课程教程.pdf
05-13
随着安卓平台上软件的日渐丰富，流行的游戏种类也在变化，而更加贴近现实、同时更富有趣味性的益智解谜类游戏逐渐风靡起来，越来越受广大玩家的青睐。本章将开发一款基于 Android 平台的益智类流体游戏—《Wo!Water!》。通过本章的学习，读者将会对 Android 平台下利用 OpenGL ES 2.0 渲染的 2D 手机游戏的开发步骤有所了解。下面就带领读者详细地了解该游戏的开发过程。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值