Appearance
Image 图片
移动端图片组件,支持宽高、填充模式、加载失败事件和错误插槽。
示例
基础用法
通过 src 设置图片地址,width 和 height 设置宽高,fit 设置填充模式,对应 CSS object-fit。
错误状态
通过 error 插槽自定义图片加载失败时的占位内容,默认展示占位图标。
API
Props
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
src | string | '' | 图片地址 |
width | number | string | '100%' | 图片宽度 |
height | number | string | '100%' | 图片高度 |
fit | 'fill' | 'contain' | 'cover' | 'none' | 'scale-down' | 'cover' | 图片填充模式,对应 CSS object-fit |
Events
| 事件名 | 参数 | 说明 |
|---|---|---|
load | - | 图片加载成功时触发 |
error | - | 图片加载失败时触发 |
Slots
| 插槽名 | 说明 |
|---|---|
error | 图片加载失败时展示的内容 |
注意事项
src变化时组件会重新进入加载流程。- 建议在移动端图片列表中明确设置
width和height,减少布局抖动。 - 如需自定义错误占位内容,请使用
error插槽。