属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
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有12种模式,其中3种是缩放模式,9种是裁剪模式。
模式 | 说明 |
---|---|
scaleToFill | 不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素 |
aspectFit | 保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。 |
aspectFill | 保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。 |
裁剪模式
模式 | 说明 |
---|---|
top | 不缩放图片,只显示图片的顶部区域 |
bottom | 不缩放图片,只显示图片的底部区域 |
center | 不缩放图片,只显示图片的中间区域 |
left | 不缩放图片,只显示图片的左边区域 |
right | 不缩放图片,只显示图片的右边区域 |
top left | 不缩放图片,只显示图片的左上边区域 |
top right | 不缩放图片,只显示图片的右上边区域 |
bottom left | 不缩放图片,只显示图片的左下边区域 |
bottom right | 不缩放图片,只显示图片的右下边区域 |
这里就拷贝文档的代码好了。。image也很重要。。但是文档列出来和演示的也很齐全。
/* ---page/test/test.wxml----*/ < view >
< view >
< text >image</ text >
< text >图片</ text >
</ view >
< view >
< view wx:for = "{{array}}" wx:for-item = "item" >
< view >{{item.text}}</ view >
< view >
< image style = "width: 200px; height: 200px; background-color: #eeeeee;" mode = "{{item.mode}}" src = "{{src}}" ></ image >
</ view >
</ view >
</ view >
</ view >
/* ---page/test/test.wxml----*/ |
/* ---page/test/test.js----*/ 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:不缩放图片,只显示图片的右下边区域'
}],
},
imageError: function (e) {
console.log( 'image3发生error事件,携带值为' , e.detail.errMsg)
}
}) /* ---page/test/test.js----*/ |