Question

LazyLoad 懒加载 平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	头条小程序	QQ小程序
√	√	√	√	√	√	√

基本使用

通过image参数传入图片的src路径即可

注意

由于uni-app认给了image组件的height为225px，同时也只uni-appimage组件的mode参数为widthFix时，image才会自动计算出一个高度值 覆盖默认的height(225px)。其他mode参数下，如果设置height为auto，或者100%的话，图片将会无法显示。

所以：当您使用uView的lazyload组件时，如果设置height参数为auto，或者100%，而img-mode参数又不为widthFix的话，图片将会不显示，这不是uView的BUG。

结论：如果img-mode参数不为widthFix的话，必须设置height参数为一个固定的高度(单位rpx)，否则无效。

<template>
	<view>
		<u-lazy-load v-for="(item, index) in list" :key="index" :image="item.src"></u-lazy-load>
	</view>
</template>
<script>
	export default {
		data() {
			return {
				// 设计成数组内嵌对象而不是纯数组形式，是考虑到真实环境后端返回的数据为如此形式
				list: [{
						src: "https://www.wenjiangs.com/wp-content/uploads/2021/docimg5/TB124_3NXXXXXasXVXXSutbFXXX.jpg_240x240xz.jpg",
					},
					{
						src: "https://www.wenjiangs.com/wp-content/uploads/2021/docimg5/TB1IWtgQFXXXXcmXFXXSutbFXXX.jpg_240x240xz.jpg",
					},
					{
						src: "https://www.wenjiangs.com/wp-content/uploads/2021/docimg5/TB1_f_PLXXXXXbVXpXXSutbFXXX.jpg_240x240xz.jpg",
					},
					{
						// 这里图片不存在，会加载失败，显示错误的占位图
						src: "xxx",
					},
				]
			}
		}
	}
</script>

配置占位图

占位图有两种情况：

• 一种是正常预加载时显示的，通过loading-img配置类似"正在加载"的占位图。
• 另一种是图片加载失败(如图片不存在，路径不完整等)，通过error-img参数配置类似"图片加载错误"的占位图

<template>
	<view>
		<u-lazy-load :image="image" :loading-img="loadingImg" :error-img="errorImg"></u-lazy-load>
	</view>
</template>
<script>
	export default {
		data() {
			return {
				image: "https://www.wenjiangs.com/wp-content/uploads/2021/docimg5/TB124_3NXXXXXasXVXXSutbFXXX.jpg_240x240xz.jpg",
				loadingImg: '/static/uView/loading.png',
				errorImg: '/static/uView/load_error.png'
			}
		}
	}
</script>

图片加载位置

可以通过threshold参数设置图片距离屏幕底部多少距离时触发图片加载，单位rpx，说明：

• 如果取负值(如-300)，为尚未到达屏幕底部，距离300rpx时触发
• 如果取正数(如300)，为图片超出屏幕底部300rpx时触发

<u-lazy-load :image="image" threshold="300"></u-lazy-load>

API

Props

参数	说明	类型	默认值	可选值
index	用户自定义值，在事件触发时回调，用以区分是哪个图片	String | Number	-	-
image	图片路径	String	-	-
loading-img	预加载时的占位图	String	-	-
error-img	图片加载出错时的占位图	String	-	-
threshold	触发加载时的位置，见上方说明，单位 rpx	String	100	-
duration	图片加载成功时，淡入淡出时间，单位ms	String | Number	500	-
effect	图片加载成功时，淡入淡出的css动画效果	String	ease-in-out	linear / ease / ease-in / ease-out
is-effect	图片加载成功时，是否启用淡入淡出效果	Boolean	true	false
border-radius	图片圆角值，单位rpx	String | Number	0	-
height	图片高度，注意：实际高度可能受img-mode参数影响	String | Number	450	-
img-mode	图片的裁剪模式，详见image组件裁剪模式	String | Number	widthFix	-

Events

事件名	说明	回调参数	版本
click	点击图片时触发	index：用户通过props传递的index值	-
load	图片加载成功时触发	index：用户通过props传递的index值	-
error	图片加载失败时触发	index：用户通过props传递的index值	-