当前位置: 首页 > 文档资料 > FeArt 中文文档 >

Image 图标

优质
小牛编辑
126浏览
2023-12-01

使用指南

组件介绍

增强版的 img 标签,提供多种图片填充模式,支持图片懒加载、加载中提示、加载失败提示

引入方式

import { Image } from 'feart';

components: {
  'fe-image': Image,
},

代码演示

默认 Image

基础用法与原生 img 标签一致,可以设置 srcwidthheightalt 等原生属性

<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属性可以设置图片变圆,注意当图片宽高不相等且fitcontainscale-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图片填充模式Stringfill-
width宽度,默认单位为 pxString , Number--
height高度,默认单位为 pxString , Number--
radius圆角大小,默认单位为 pxString , Number0-
round是否显示为圆形Booleanfalse-
show-error是否展示图片加载失败提示Booleantrue-
show-loading是否展示图片加载中提示Booleantrue-
-----

图片填充模式

名称含义备注
none保持图片原有尺寸-
fill拉伸图片,使图片填满元素-
scale-downnonecontain 中较小的一个-
contain保持宽高缩放图片,使图片的长边能完全显示出来-
cover保持宽高缩放图片,使图片的短边能完全显示出来,裁剪长边-
---

Events

参数说明回调参数
click点击图片时触发event: Event
load图片加载完毕时触发-
error图片加载失败时触发-
---

Slots

名称含义备注
loading自定义加载中的提示内容-
error自定义加载失败时的提示内容-
---