#### waterfall app端nvue专用组件。 `` 组件是提供瀑布流布局的核心组件。瀑布流,又称瀑布流式布局,是比较流行的一种页面布局,视觉表现为参差不齐的多栏布局。随着页面滚动条向下滚动,这种布局还可以不断加载数据块并附加至当前尾部。 在nvue中,使用普通view做瀑布流,无法实现复用和不可见渲染资源释放。使用``组件且指定`cell`后,原生引擎会自动优化性能。 ``` ``` #### 子组件 和 `` 组件一样, `` 组件的子组件只能包括以下四种组件或是 fix 定位的组件,其他形式的组件将不能被正确渲染。 - ``:用于定义列表中的子列表项,类似于 HTML 中的 ul 之于 li。`` 会对 `` 进行高效的内存回收以达到更好的性能。 - `
`:当 `
` 到达屏幕顶部时,吸附在屏幕顶部。 - ``:用于给列表添加下拉刷新的功能。 - ``:`` 用法与特性和 `` 类似,用于给列表添加上拉加载更多的功能。 #### 属性 - show-scrollbar : `[可选]` 可选值为 true/ false,默认值为 true。控制是否出现滚动条。 - column-count: `[可选]`描述瀑布流的列数 - auto: 意味着列数是被其他属性所决定的(比如 column-width) - ``: 最佳列数,column-width 和 column-count 都指定非0值, 则 column-count 代表最大列数。 - column-width : `[可选]`描述瀑布流每一列的列宽 - `auto`: 意味着列宽是被其他属性所决定的(比如 column-count) - ``: 最佳列宽,实际的列宽可能会更宽(需要填充剩余的空间), 或者更窄(如果剩余空间比列宽还要小)。 该值必须大于0 - column-gap: [可选]列与列的间隙. 如果指定了 `normal` ,则对应 32. - left-gap: [可选]左边cell和列表的间隙. 如果未指定 ,则对应 `0` - right-gap: [可选]右边cell和列表的间隙. 如果未指定,则对应 `0` - always-scrollable-vertical : `[可选]` 可选值为 true/ false,默认值为 false,iOS 平台,内容不满一屏无法触发下拉刷新时需要设置为true,因为默认子视图高度不超过父视图高度的时候 waterfall 不能滑动 其他支持的属性参见 `` 组件属性部分 #### 事件 支持所有通用事件: - click:用于监听点击事件。(例如:一般绑定于子组件之上触发跳转)。 - longpress:用于监听长按事件(一般绑定于子组件之上例如:长按可删除)。 - appear:用于监听子组件出现事件(一般绑定于子组件之上例如:监听最后一个元素出现,加载新的数据) - disappear:用于监听子组件滑出屏幕事件(一般绑定于子组件之上) **注意** - waterfall是区域滚动,不会触发页面滚动,无法触发pages.json配置的下拉刷新、页面触底onReachBottomDistance、titleNView的transparent透明渐变。