Skip to content

Image 图片

企业级图片展示组件,支持懒加载、预览、错误兜底等功能。

基础用法

展示一张基础的图片。

Example

适应模式

使用 fit 属性来控制图片如何适应其容器,类似于原生的 object-fit CSS 属性。

cover
contain
fill
none
scale-down
Example

图片预览

使用 preview 属性开启全屏大图预览。你也可以通过 preview-src-list 提供一个图片数组,以实现多图轮播。

Example

懒加载

使用 lazy 属性开启懒加载,图片将在进入可视区域时才开始加载。在加载过程中会自动显示骨架屏。

Scroll down to see lazy loaded image / Scroll down to see lazy loaded images
Example

水印

使用 watermark 属性可以为图片添加水印。你可以传入字符串或配置对象。

Example

错误兜底

当图片加载失败时,会自动显示默认的错误提示占位。

Example

API

BrImage

Props 属性

名称类型默认值说明
srcstring-图片的资源地址
altstring-图片的替代文本
fitstring'cover'图片适应容器的模式:fill, contain, cover, none, scale-down
lazybooleanfalse是否开启懒加载
previewbooleanfalse是否开启图片预览
previewSrcListstring[][]预览图库的图片地址列表
initialIndexnumber0预览图库的初始索引
zIndexnumber100预览遮罩层的 z-index
watermarkstring | object-水印文本或配置对象
roundedstring'none'圆角大小:none, sm, md, lg, xl, 2xl, full
shadowstring'none'阴影大小:none, sm, md, lg, xl
borderedbooleanfalse是否显示边框

Events 事件

名称类型说明
load(e: Event) => void图片加载成功时触发
error(e: Event) => void图片加载失败时触发
show() => void预览打开时触发
close() => void预览关闭时触发
switch(index: number) => void在预览图库中切换图片时触发