小程序模板网

微信小程序媒体组件(二)image

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

1.先看一下属性。

 

属性名 类型 默认值 说明 最低版本
src String   图片资源地址  
mode String 'scaleToFill' 图片裁剪、缩放的模式  
lazy-load Boolean false 图片懒加载。只针对page与scroll-view下的image有效 1.5.0
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 不缩放图片,只显示图片的右下边区域

2.wxml代码↓

<view>  
  <text>imagetext>  
  <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:竖直居中



易优小程序(企业版)+灵活api+前后代码开源 码云仓库:starfork
本文地址:https://www.eyoucms.com/wxmini/doc/course/24171.html 复制链接 如需定制请联系易优客服咨询:800182392 点击咨询
QQ在线咨询