Skip to content

Image 图片

移动端图片组件,支持宽高、填充模式、加载失败事件和错误插槽。

示例

基础用法

通过 src 设置图片地址,widthheight 设置宽高,fit 设置填充模式,对应 CSS object-fit

错误状态

通过 error 插槽自定义图片加载失败时的占位内容,默认展示占位图标。

API

Props

参数类型默认值说明
srcstring''图片地址
widthnumber | string'100%'图片宽度
heightnumber | string'100%'图片高度
fit'fill' | 'contain' | 'cover' | 'none' | 'scale-down''cover'图片填充模式,对应 CSS object-fit

Events

事件名参数说明
load-图片加载成功时触发
error-图片加载失败时触发

Slots

插槽名说明
error图片加载失败时展示的内容

注意事项

  1. src 变化时组件会重新进入加载流程。
  2. 建议在移动端图片列表中明确设置 widthheight,减少布局抖动。
  3. 如需自定义错误占位内容,请使用 error 插槽。