Image 图标
优质
小牛编辑
126浏览
2023-12-01
使用指南
组件介绍
增强版的 img 标签,提供多种图片填充模式,支持图片懒加载、加载中提示、加载失败提示
引入方式
import { Image } from 'feart';
components: {
'fe-image': Image,
},
代码演示
默认 Image
基础用法与原生
img
标签一致,可以设置src
、width
、height
、alt
等原生属性
<fe-image width="100" height="100" src="https://nuofe.nntest.cn/feart/images/demoimgs/cat.jpg" />
填充模式
通过
fit
属性可以设置图片填充模式,可选值见下方表格
<fe-image
width="10rem"
height="10rem"
fit="contain"
src="https://nuofe.nntest.cn/feart/images/demoimgs/cat.jpg"
/>
圆形图片
通过
round
属性可以设置图片变圆,注意当图片宽高不相等且fit
为contain
或scale-down
时,将无法填充一个完整的圆形。
<fe-image
round
width="10rem"
height="10rem"
src="https://nuofe.nntest.cn/feart/images/demoimgs/cat.jpg"
/>
加载中提示
Image 组件提供了默认的加载中提示,支持通过
loading
插槽自定义内容
<fe-image src="https://nuofe.nntest.cn/feart/images/demoimgs/cat.jpg">
<div slot:loading>
<fe-loading size="20px" />
</div>
</fe-image>
加载失败提示
Image 组件提供了默认的加载失败提示,支持通过
error
插槽自定义内容
<fe-image src="https://nuofe.nntest.cn/feart/images/demoimgs/cat.jpg">
<div slot:error>加载失败</div>
</fe-image>
API
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
src | 图片链接 | String | - | - |
alt | 替代文本 | String | - | - |
fit | 图片填充模式 | String | fill | - |
width | 宽度,默认单位为 px | String , Number | - | - |
height | 高度,默认单位为 px | String , Number | - | - |
radius | 圆角大小,默认单位为 px | String , Number | 0 | - |
round | 是否显示为圆形 | Boolean | false | - |
show-error | 是否展示图片加载失败提示 | Boolean | true | - |
show-loading | 是否展示图片加载中提示 | Boolean | true | - |
- | - | - | - | - |
图片填充模式
名称 | 含义 | 备注 |
---|---|---|
none | 保持图片原有尺寸 | - |
fill | 拉伸图片,使图片填满元素 | - |
scale-down | 取 none 或 contain 中较小的一个 | - |
contain | 保持宽高缩放图片,使图片的长边能完全显示出来 | - |
cover | 保持宽高缩放图片,使图片的短边能完全显示出来,裁剪长边 | - |
- | - | - |
Events
参数 | 说明 | 回调参数 |
---|---|---|
click | 点击图片时触发 | event: Event |
load | 图片加载完毕时触发 | - |
error | 图片加载失败时触发 | - |
- | - | - |
Slots
名称 | 含义 | 备注 |
---|---|---|
loading | 自定义加载中的提示内容 | - |
error | 自定义加载失败时的提示内容 | - |
- | - | - |