waterfall

HarmonyOS Next 不支持

app端nvue专用组件。

<waterfall> 组件是提供瀑布流布局的核心组件。瀑布流，又称瀑布流式布局，是比较流行的一种页面布局，视觉表现为参差不齐的多栏布局。随着页面滚动条向下滚动，这种布局还可以不断加载数据块并附加至当前尾部。

在nvue中，使用普通view做瀑布流，无法实现复用和不可见渲染资源释放。使用<waterfall>组件且指定cell后，原生引擎会自动优化性能。

<template>
  <waterfall column-count="2" column-width="auto">
    <cell v-for="num in lists" >
      <text>{{num}}</text>
    </cell>
  </waterfall>
</template>
<script>
  export default {
    data () {
      return {
        lists: ['A', 'B', 'C', 'D', 'E']
      }
    }
  }
</script>

<style></style>

子组件

和 <list> 组件一样, <waterfall> 组件的子组件只能包括以下四种组件或是 fix 定位的组件，其他形式的组件将不能被正确渲染。

• <cell>：用于定义列表中的子列表项，类似于 HTML 中的 ul 之于 li。<waterfall> 会对 <cell> 进行高效的内存回收以达到更好的性能。
• <header>：当 <header> 到达屏幕顶部时，吸附在屏幕顶部。
• <refresh>：用于给列表添加下拉刷新的功能。
• <loading>：<loading> 用法与特性和 <refresh> 类似，用于给列表添加上拉加载更多的功能。

属性

• show-scrollbar : [可选] 可选值为 true/ false，默认值为 true。控制是否出现滚动条。
• column-count: [可选]描述瀑布流的列数
  • auto: 意味着列数是被其他属性所决定的(比如 column-width)
  • <integer>: 最佳列数，column-width 和 column-count 都指定非0值， 则 column-count 代表最大列数。
• column-width : [可选]描述瀑布流每一列的列宽
  • auto: 意味着列宽是被其他属性所决定的(比如 column-count)
  • <length>: 最佳列宽，实际的列宽可能会更宽(需要填充剩余的空间)， 或者更窄(如果剩余空间比列宽还要小)。 该值必须大于0
• column-gap: [可选]列与列的间隙. 如果指定了 normal ，则对应 32.
• left-gap: [可选]左边cell和列表的间隙. 如果未指定 ，则对应 0
• right-gap: [可选]右边cell和列表的间隙. 如果未指定，则对应 0
• always-scrollable-vertical : [可选] 可选值为 true/ false，默认值为 false，iOS 平台，内容不满一屏无法触发下拉刷新时需要设置为true，因为默认子视图高度不超过父视图高度的时候 waterfall 不能滑动

其他支持的属性参见 <list> 组件属性部分

事件

支持所有通用事件：

• click：用于监听点击事件。（例如：一般绑定于子组件之上触发跳转）。
• longpress：用于监听长按事件（一般绑定于子组件之上例如：长按可删除）。
• appear：用于监听子组件出现事件（一般绑定于子组件之上例如：监听最后一个元素出现，加载新的数据）
• disappear：用于监听子组件滑出屏幕事件（一般绑定于子组件之上）

注意

• waterfall是区域滚动，不会触发页面滚动，无法触发pages.json配置的下拉刷新、页面触底onReachBottomDistance、titleNView的transparent透明渐变。
• 如出现waterfall列表下边大面积空白区域（多列和单列时的整体高度相同，多列展示没有高度自适应），那么可以将waterfall放到父容器下边，给父容器高度设置为窗口高度，除瀑布流展示的列表外，其他的组件都放在
  中即可。 示例代码如下：

<template>
  <waterfall column-count="2" column-width="auto" :style="{ height: windowHeight + 'px' }">
    <header>
      <!--轮播-->
      <swiper class="swiper_banner">
        ......
      </swiper>
      <!--广告位-->
      <view class="ads_List_box">
        ......
      </view>
    </header>
    <!--瀑布流展示的商品列表-->
    <cell v-for="num in lists" >
      <text>{{num}}</text>
    </cell>
  </waterfall>
</template>
<script>
  export default {
    data () {
      return {
        lists: ['A', 'B', 'C', 'D', 'E'],
        windowHeight: uni.getSystemInfoSync().windowHeight
      }
    }
  }
</script>

<style></style>