Skip to content

Image 图片

图片容器,在保留所有原生 img 的特性,自定义占位、加载失败等功能的同时,图片预览等功能。

基础用法

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

加载失败

可通过 fallback-src来定义加载失败时显示的图片。error-text 来定义加载失败时显示的文字。使用error插槽自定义加载失败时的内容。

预览

可通过 previewSrcList 来定义预览图片列表。preview 来开启图片预览功能。previewTextColor 来定义预览文字颜色。

预览
预览

自定义大小

可通过 widthheight 来定义图片的大小。

让我帮你整理 Image 组件的事件和属性表格:

属性(Props)

属性名说明类型可选值默认值
size图片尺寸string-""
src图片源地址string-""
fit图片适应容器的方式stringfill/contain/cover/none/scale-down""
fallbackSrc加载失败时的备选图片string-""
alt图片描述string-""
width图片宽度number/string-100
height图片高度number/string-100
radius圆角大小number/string-0
errorText加载失败时显示的文本string-"加载失败"
isZoomed是否缩放boolean-false
preview是否可预览boolean-false
previewSrcList预览图片列表array-[]
previewTextColor预览文本颜色string-"#fff"

事件(Events)

事件名说明回调参数
error图片加载失败时触发-
load图片加载成功时触发-
close预览窗口关闭时触发(scale: number)
prev切换至上一张图片时触发(index: number)
next切换至下一张图片时触发(index: number)
rotate图片旋转时触发(rotate: number)
zoomIn图片放大时触发(e: Event)
zoomOut图片缩小时触发(scale: number)

插槽(Slots)

插槽名说明
error自定义加载失败内容
content自定义图片内容