Skip to content

Image 图片

图片

基本用法

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

占位

可通过slot = placeholder可自定义占位内容

错误

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

懒加载

TIP

如果当前浏览器支持原生图片延迟加载,则先使用原生能力,否则将使用滚动监听实现相同效果。

可通过lazy开启懒加载功能, 当图片滚动到可视范围内才会加载。 可通过 scroll-container 来设置滚动容器, 若未定义,则为最近一个 overflow 值为 autoscroll 的父元素。

图片预览

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

API

Attributes

参数说明类型默认值
src图片地址string''
fit填充方式ImageFit''
loading加载方式ImageLoading''
lazy是否懒加载boolean''
preview-src-list预览图片列表string[][]
zIndexz-indexnumber-
infinite是否循环查看booleantrue
hide-on-click-modal点击遮罩层关闭boolean-
close-on-press-escape按 esc 关闭booleantrue
teleported是否插入到 body 上boolean-
zoom-rate缩放倍数number1.2
min-scale最小缩放比例number0.2
max-scale最大缩放比例number7

Events

事件名称说明类型
load加载完毕后触发(evt: Event) => void
error加载出错时(evt: Event) => void
switch预览图片切换时(val: number) => void
close预览图片关闭时() => void
show预览图片显示时() => void