Skip to content
CONTENTS

Image 图片

图片容器,在保留所有原生 img 的特性下,支持懒加载,自定义占位、加载失败等

基本使用

可通过 fit 确定图片如何适应到容器框,同原生 object-fit

加载失败

可通过 slot = error 可自定义加载失败内容

懒加载

可通过 lazy 开启懒加载功能, 当图片滚动到可视范围内才会加载。 可通过 scroll-container 来设置滚动容器, 若未定义,默认为 window

图片预览

可通过 previewSrcList 开启预览大图的功能。 你可以通过 initial-index 初始化第一张预览图片,默认初始位置为 0

Image API

Image 属性

属性名说明类型默认值
src图片源地址,同原生属性一致string
width图片宽度string
height图片高度string
fit确定图片如何适应容器框,同原生 object-fit.fill / contain / cover / none / scale-down
lazy是否使用懒加载booleanfalse
altImg开启懒加载后,未开始加载图片的占位图string
scrollContainer开启懒加载功能后,监听 scroll 事件的容器string / HTMLElementwindow
lazyList懒加载的图片地址列表string[][]
previewSrcList开启图片预览功能string[][]
initialIndex初始预览图像索引,小于 url-list 的长度number0
infinite是否可以无限循环预览booleantrue
zoomRate缩放事件的缩放速度number1.2

Image 事件

事件名说明类型
load图片加载成功触发(e: Event) => void
error图片加载失败触发(e: Error) => void
switch切换图像时触发。(index: number) => void
close当点击 X 按钮时触发() => void

Image 插槽

插槽名说明
placeholder当图像尚未加载时,自定义的占位符内容
error自定义图像加载失败的内容

Released under the MIT License.