Skip to content

Image 图片

图片容器,在保留原生 img 的特性下,支持懒加载,自定义占位、加载失败,以及故障风、3D倾斜、放大镜等特色功能。

基础用法

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

占位内容

可通过 slot = placeholder 可自定义加载时的占位内容。

加载失败

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

懒加载

可通过 lazy 开启懒加载功能,当图片滚动到可视范围内才会加载。

大图预览

可通过 previewSrcList 开启预览大图的功能。

特色功能:故障风 (Cyberpunk Glitch)

为图片添加赛博朋克风格的故障动画效果。

特色功能:3D 倾斜 (Tilt)

鼠标悬停时,图片会跟随鼠标位置产生 3D 倾斜效果。

特色功能:倒影 (Reflection)

为图片添加底部倒影效果,增加视觉层次感。

特色功能:放大镜 (Magnifier)

鼠标悬停时显示局部放大镜效果,适用于查看图片细节。

Image 属性

属性说明类型可选值默认值
src图片源,同原生string
fit确定图片如何适应容器框,同原生 object-fitstringfill / contain / cover / none / scale-down
loading原生 loading 属性stringeager / lazy
lazy是否开启懒加载booleanfalse
preview-src-list开启图片预览功能string[][]
initial-index初始预览图像索引number0
z-index设置图片预览的 z-indexnumber2000
preview-teleportedimage-viewer 是否插入至 body 元素上booleantrue
hide-on-click-modal当点击遮罩层时,是否关闭图片预览booleanfalse
glitch开启故障风动画效果booleanfalse
tilt开启 3D 倾斜效果booleanfalse
reflection开启倒影效果booleanfalse
magnifier开启放大镜效果booleanfalse

Image 事件

事件名说明回调参数
load图片加载成功触发(e: Event)
error图片加载失败触发(e: Event)
switch切换预览图片时触发(index: number)
close关闭预览时触发
show打开预览时触发

Image 插槽

插槽名说明
placeholder图片未加载的占位内容
error图片加载失败的内容