Skip to content

Lazyload 图片懒加载 ​

在图片接近可见区域时加载图片,并支持占位图和加载结果事件。

支持平台 ​

以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。

App-vueApp-nvue微信小程序支付宝小程序百度小程序字节小程序QQ小程序H5PC快手小程序钉钉小程序
✓✓✓✓✓✓✓✓✓✓✓

基础用法 ​

vue
<!-- 懒加载图片 -->
<fui-lazyload src="https://example.com/image.png" :width="320" :height="320" />

请将示例地址替换为实际图片地址。

属性 ​

尺寸和间距的单位为 rpx。

属性类型说明官网默认值
srcString图片地址-
widthNumber / String图片宽度,-1 表示 100%320
heightNumber / String图片高度,0 或 -1 表示自动320
radiusNumber / String圆角0
placeholderString占位图片地址-
backgroundString占位背景色#EEEEEE
modeString图片裁剪模式,使用 uni-app image 的 mode 值widthFix
webpBoolean是否支持网络 WebP 图片false
draggableBoolean是否允许拖动图片true
marginTopNumber / String上外边距0
marginRightNumber / String右外边距0
marginBottomNumber / String下外边距0
marginLeftNumber / String左外边距0
paramNumber / String回调携带的自定义参数0

事件 ​

事件说明回调参数
click点击图片时触发{ param }
load图片加载成功时触发{ param, detail },detail 包含图片宽高
error图片加载失败时触发{ param, detail },detail 包含错误信息

插槽 ​

插槽说明
default显示在图片上的绝对定位内容

平台说明 ​

webp 对应微信小程序 2.9.0 以上的网络图片能力;draggable 对应 H5 3.1.1 以上及 App iOS 15 以上平台。