本文介绍图片(image)组件。
属性名 | 类型 | 默认值 | 描述 | 最低版本 |
---|---|---|---|---|
src | String | - | 图片地址 | - |
String | scaleToFill | 图片模式 | - | |
class | String | 外部样式 | - | - |
style | String | 内联样式 | - | - |
lazy-load | Boolean | false | 是否启用懒加载模式。懒加载适用于不能通过CSS控制 image 展示或隐藏的场景。 | |
onLoad | EventHandle | - | 图片载入完毕时触发。事件对象: | - |
onError | EventHandle | - | 当图片加载错误时触发。事件对象: | - |
onTap | EventHandle | - | 点击图片时触发。 | - |
catchTap | EventHandle | - | 点击图片时触发,并阻止事件冒泡。 | - |
image 组件默认宽度 300 px、高度 225 px。
mode
mode 有 13 种模式,其中 4 种是缩放模式,9 种是裁剪模式。
缩放模式
属性名 | 描述 |
---|---|
scaleToFill | 不保持纵横比缩放,使图片的宽高完全拉伸至填满 image 元素。 |
aspectFit | 保持纵横比缩放,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。 |
aspectFill | 保持纵横比缩放,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。 |
widthFix | 宽度不变,高度自动变化,保持原图宽高比不变。 |
裁剪模式
属性名 | 描述 |
---|---|
top | 不缩放图片,只显示顶部区域。 |
bottom | 不缩放图片,只显示底部区域。 |
center | 不缩放图片,只显示中间区域。 |
left | 不缩放图片,只显示左边区域。 |
right | 不缩放图片,只显示右边区域。 |
top left | 不缩放图片,只显示左上边区域。 |
top right | 不缩放图片,只显示右上边区域。 |
bottom left | 不缩放图片,只显示左下边区域。 |
bottom right | 不缩放图片,只显示右下边区域。 |
图片高度不能设置为 auto,如果需要图片高度为 auto,直接设置 mode 为 widthFix
。
图示
原图
![original](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234188924/original.png)
scaleToFill
不保持纵横比缩放,使图片完全适应。
![scaleToFill](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234209424/scaleToFill.png)
aspectFit
保持纵横比缩放,使图片的长边能完全显示出来。
aspectFill
保持纵横比缩放,只保证图片的短边能完全显示出来。
![aspectFill](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234242394/aspectFill.png)
widthFix
宽度不变,高度自动变化,保持原图宽高比不变。
![widthFix](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234261556/widthFix.png)
top
不缩放图片,只显示顶部区域。
![top](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234276785/top.png)
bottom
不缩放图片,只显示底部区域。
![bottom](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234292389/bottom.png)
center
不缩放图片,只显示中间区域。
![center](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234308035/center.png)
left
不缩放图片,只显示左边区域。
![left](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234325593/left.png)
right
不缩放图片,只显示右边区域。
![right](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234338947/right.png)
top left
不缩放图片,只显示左上边区域。
![top left](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234364286/top%20left.png)
top right
不缩放图片,只显示右上边区域。
![top right](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234381448/top%20right.png)
bottom left
不缩放图片,只显示左下边区域。
![bottom left](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234399033/bottom%20left.png)
bottom right
不缩放图片,只显示右下边区域。
![bottom right](http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/67511/AntCloud_zh/1557234413880/bottom%20right.png)
代码示例
<view class="section" a:for="{{array}}" a:for-item="item">
<view class="title">{{item.text}}</view>
<image style="background-color: #eeeeee; width: 300px; height:300px;" mode="{{item.mode}}" src="{{src}}" onError="imageError" onLoad="imageLoad" />
</view>
Page({
data: {
array: [{
mode: 'scaleToFill',
text: 'scaleToFill:不保持纵横比缩放,使图片完全适应'
}, {
mode: 'aspectFit',
text: 'aspectFit:保持纵横比缩放,使图片的长边能完全显示出来'
}, {
mode: 'aspectFill',
text: 'aspectFill:保持纵横比缩放,只保证图片的短边能完全显示出来'
}, {
mode: 'top',
text: 'top:不缩放图片,只显示顶部区域'
}, {
mode: 'bottom',
text: 'bottom:不缩放图片,只显示底部区域'
}, {
mode: 'center',
text: 'center:不缩放图片,只显示中间区域'
}, {
mode: 'left',
text: 'left:不缩放图片,只显示左边区域'
}, {
mode: 'right',
text: 'right:不缩放图片,只显示右边边区域'
}, {
mode: 'top left',
text: 'top left:不缩放图片,只显示左上边区域'
}, {
mode: 'top right',
text: 'top right:不缩放图片,只显示右上边区域'
}, {
mode: 'bottom left',
text: 'bottom left:不缩放图片,只显示左下边区域'
}, {
mode: 'bottom right',
text: 'bottom right:不缩放图片,只显示右下边区域'
}],
src: './2.png'
},
imageError: function (e) {
console.log('image3 发生错误', e.detail.errMsg)
},
imageLoad: function (e) {
console.log('image 加载成功', e);
}
})