图片。
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
src | string | 图片资源地址 | |
mode | string | 'scaletofill' | 图片裁剪、缩放的模式 |
binderror | handleevent | 当错误发生时,发布到appservice的事件名,事件对象event.detail = { errmsg: 'something wrong' } | |
bindload | handleevent | 当图片载入完毕时,发布到appservice的事件名,事件对象event.detail = {height:'图片高度px', width:'图片宽度px' } |
注:image组件默认宽度300px、高度225px
mode 有效值:
mode有13种模式,其中4种是缩放模式,9种是裁剪模式。
模式 | 值 | 说明 |
---|---|---|
缩放 | scaletofill | 不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素 |
缩放 | aspectfit | 保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。 |
缩放 | aspectfill | 保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。 |
缩放 | widthfix | 宽度不变,高度自动变化,保持原图宽高比不变 |
裁剪 | top | 不缩放图片,只显示图片的顶部区域 |
裁剪 | bottom | 不缩放图片,只显示图片的底部区域 |
裁剪 | center | 不缩放图片,只显示图片的中间区域 |
裁剪 | left | 不缩放图片,只显示图片的左边区域 |
裁剪 | right | 不缩放图片,只显示图片的右边区域 |
裁剪 | top left | 不缩放图片,只显示图片的左上边区域 |
裁剪 | top right | 不缩放图片,只显示图片的右上边区域 |
裁剪 | bottom left | 不缩放图片,只显示图片的左下边区域 |
裁剪 | bottom right | 不缩放图片,只显示图片的右下边区域 |
示例:
<view class="page">
<view class="page__hd">
<text class="page__title">image</text>
<text class="page__desc">图片</text>
</view>
<view class="page__bd">
<view class="section section_gap" wx:for="{{array}}" wx:for-item="item">
<view class="section__title">{{item.text}}</view>
<view class="section__ctn">
<image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="{{item.mode}}" src="{{src}}"></image>
</view>
</view>
</view>
</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: '../../resources/cat.jpg'
},
imageerror: function(e) {
console.log('image3发生error事件,携带值为', e.detail.errmsg)
}
})
原图
aspectfit
保持纵横比缩放图片,使图片的长边能完全显示出来
top
不缩放图片,只显示图片的顶部区域
center
不缩放图片,只显示图片的中间区域
right
不缩放图片,只显示图片的右边边区域