更新记录

1.0.0(2023-12-19)

首次更新


平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
× × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

Props

请注意:1.组件固定为左右两列 2.组件默认使用屏幕宽度进行计算列宽,不要使用padding,用下面props调整位置。

fsz-waterfall 组件

属性名 类型 说明 默认值 平台差异说明
columnGap Number, String 列与列的水平方向间隙,单位rpx 24 -
topGap Number, String 列与列的垂直方向间隙,单位rpx 24 -
leftGap Number, String 列表左侧与屏幕间隙,单位rpx 0 -
rightGap Number, String 列表右侧与屏幕间隙,单位rpx 0 -

fsz-waterfall-item 组件

在初始化的时候,如果知道图片宽高,可以直接设置,减少计算时间

属性名 类型 说明 默认值 平台差异说明
background String item项背景色 #FFFFFF -
radius Number, String item项圆角值,单位rpx 16 -
src String 图片地址,如果列表包含图片,此参数为必传参数 - -
imgWidth Number, String 图片宽度,单位rpx,为0则默认使用列宽度 0 -
imgHeight V1.9.8+ Number, String 图片高度,单位rpx,如果设置值则固定图片高度,不需要等图片加载完成再去渲染,需要自适应高度请勿设置值 0 -
webp Boolean 默认不解析 webP 格式,只支持网络资源 false 微信小程序2.9.0+
draggable Boolean 是否能拖动图片 true -
param Number, String 自定义参数,随事件回传 0 -

Events

fsz-waterfall 组件

请注意:分页加载时,为了避免计算出错,请在end事件执行后再去加载后续数据。

事件名 说明 回调参数
@init 初始化时触发 { itemWidth:列宽度,单位px }
@end 分页数据渲染完成时触发 { }

fsz-waterfall-item 组件

事件名 说明 回调参数
@click 点击item时触发 { param:自定义参数 }

Slots

fsz-waterfall 组件

插槽名称 说明
default 标签显示内容,内部由一个或多个 fsz-waterfall-item 组成

fsz-waterfall-item 组件

插槽名称 说明
default 标签内显示的自定义内容,位于图片下方
upper 标签内显示的自定义内容,位于图片上方

Methods

引用信息将会注册在父组件的$refs对象上。通过 this.$refs.XXX 访问到组件实例。

fsz-waterfall 组件

方法名 说明 传入参数
resetLoadmore 重置加载,当下拉刷新重置数据时需要先调用此方法重置组件 -

使用:

import fszWaterfall from "@/components/fsz-waterfall/fsz-waterfall.vue"
import fszWaterfallItem from "@/components/fsz-waterfall-item/fsz-waterfall-item.vue"
export default {
    components:{
        fszWaterfall,
        fszWaterfallItem
    }
}

<fsz-waterfall @end="waterfallLodEnd">
    <fsz-waterfall-item  v-for="(item,index) in images" :key="index" :src="item">
        <view class="fsz-text">此处为自定义内容,可展示自定义信息</view>
    </fsz-waterfall-item>
</fsz-waterfall>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问