微信小程序媒体组件（二）image

记录一下image的使用，比较简单。

1.先看一下属性。

属性名类型默认值说明最低版本srcString 图片资源地址 modeString'scaleToFill'图片裁剪、缩放的模式 lazy-loadBooleanfalse图片懒加载。只针对page与scroll-view下的image有效1.5.0binderrorHandleEvent 当错误发生时，发布到 AppService 的事件名，事件对象event.detail = {errMsg: 'something wrong'} bindloadHandleEvent 当图片载入完毕时，发布到 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不缩放图片，只显示图片的右下边区域2.wxml代码↓

<view>  <text>image</text>  <view>    <view wx:for="{{array}}" wx:for-item="item">      <view class="imageText">{{item.text}}</view>      <view class="imageContent">        <image class="imageStyle" mode="{{item.mode}}" src="{{src}}" binderror='imageError'></image>      </view>    </view>  </view></view>

①array中mode定义了图片的裁剪、缩放模式，text定义了图片的注解，src图片源，均在js文件中进行定义。

data: {    src: '../../resources/image/bing.jpg',    array: [{      mode: 'scaleToFill',      text: 'scaleToFill：不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素'    }, {      mode: 'aspectFit',      text: 'aspectFit：保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。'    }, {      mode: 'aspectFill',      text: 'aspectFill:保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。'    }, {      mode: 'widthFix',      text: 'widthFix:宽度不变，高度自动变化，保持原图宽高比不变'    }, {      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：不缩放图片，只显示图片的右下边区域'    }]  },

②binderror监听图片错误，在js中实现，查看错误信息

imageError: function (e) {    console.log('============================================')    console.log('image发生error事件，携带值为', e.detail.errMsg)    console.log('============================================')  }

如，设定一个无法访问的src，控制台输出如下信息↓

3.效果图

（1）缩放模式

      

①scalToFill模式：完全适应image的width及height（在该例中，分别为280px和150px）

②asprctFit模式：按比例缩小，完整的将图片显示出来，多余的部分由背景色#ddd补充

③aspectFill模式：按比例缩小，保证至少一个方向完整显示（红色框约为被裁掉的部分）

④widthFix模式：宽度不变（该例中280px），高度自动变化，保证图片完整显示。

（2）裁剪模式，看两个例子：

完整的对应位置如下图所示↓

5.最后附上wxss的代码

.imageStyle {  width: 280px;  height: 150px;  background: #ddd;}.imageText {  margin-top: 20px;}.imageContent {  width: 100%;  height: 100%;  display: flex;  justify-content: center;}

其中imageContent保证了图片的性质

justify-content：水平居中

align-items：竖直居中