更新记录
1.0.0(2023-05-03)
下载此版本
完成
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
app-vue app-nvue |
√ |
√ |
√ |
√ |
√ |
√ |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
√ |
√ |
√ |
√ |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
Image 图片
参数
参数 |
说明 |
类型 |
可选值 |
默认值 |
src |
资源地址 |
string |
|
|
mode |
裁剪、缩放的模式 |
string |
|
|
size |
尺寸 |
string / number |
|
100% |
round |
是否圆角 |
boolean |
|
false |
margin |
外间距 |
array / string / number |
|
|
preview-list |
预览列表 |
array |
|
|
lazyLoad |
是否 lazy 加载 |
boolean |
|
false |
fadeShow |
是否渐变 |
boolean |
|
false |
webp |
是否是 webp |
boolean |
|
false |
showMenuByLongpress |
通过长按显示 Menu |
boolean |
|
false |
插槽
插槽 |
说明 |
error |
图片加载失败 |
placeholder |
图片地址为空 |
示例
裁剪模式
- scaleToFill 不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素
- aspectFit 保持纵横比缩放图片,使图片的长边能完全显示出来
- aspectFill 保持纵横比缩放图片,只保证图片的短边能完全显示出来
- widthFix 宽度不变,高度自动变化,保持原图宽高比不变
- heightFix 高度不变,宽度自动变化,保持原图宽高比不变
<ayi-image src="/static/bg.jpg" :size="140" mode="scaleToFill"></ayi-image>
<ayi-image src="/static/bg.jpg" :size="140" mode="aspectFit"></ayi-image>
<ayi-image src="/static/bg.jpg" :size="140" mode="aspectFill"></ayi-image>
<ayi-image src="/static/bg.jpg" :size="140" mode="widthFix"></ayi-image>
不同样式
<ayi-image src="/static/avatar.png" :size="140" round></ayi-image>
<ayi-image src="/static/avatar.png" :size="[140, 280]" mode="aspectFill" :margin="[0, 0, 0, 20]"></ayi-image>
点击预览
配置 previewList, 会自动匹配当前的 src 为第一张显示
<ayi-image src="/static/bg.jpg" :size="140" :preview-list="previewList"></ayi-image>
插槽
插槽:地址为空
<ayi-image src="" :size="150"></ayi-image>
<ayi-image src="" :size="150" :margin="[0, 0, 0, 20]">
<template #placeholder>
<ayi-text color="red" :size="30" value="自定义"></ayi-text>
</template>
</ayi-image>
插槽:加载错误
<ayi-image src="https://xxxx.png" :size="150"></ayi-image>
<ayi-image src="https://xxxx.png" :size="150" :margin="[0, 0, 0, 20]">
<template #error>
<ayi-text color="red" :size="30" value="自定义"></ayi-text>
</template>
</ayi-image>