注册

微信小程序媒体组件image,微信小程序image组件库

2017-12-22
导读:微信小程序image 图片。 属性名 类型 默认值 说明 src String 图片资源地址 mode String 'scaleToFill' 图片裁剪、缩放的模式 binderror HandleEvent 当错误发生时,发布到AppService的事件名,事件对象...

微信小程序image


图片。

属性名 类型 默认值 说明
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)
  }
})

原图

 

scaleToFill

不保持纵横比缩放图片,使图片完全适应

 

aspectFit

保持纵横比缩放图片,使图片的长边能完全显示出来

 

aspectFill

保持纵横比缩放图片,只保证图片的短边能完全显示出来

 

top

不缩放图片,只显示图片的顶部区域

 

bottom

不缩放图片,只显示图片的底部区域

 

center

不缩放图片,只显示图片的中间区域

 

left

不缩放图片,只显示图片的左边区域

 

right

不缩放图片,只显示图片的右边边区域

 

top left

不缩放图片,只显示图片的左上边区域

 

top right

不缩放图片,只显示图片的右上边区域

 

bottom left

不缩放图片,只显示图片的左下边区域

 

bottom right

不缩放图片,只显示图片的右下边区域

 

更多微信小程序开发教程,可以关注hi小程序。
重磅推荐:小程序开店目录

第一部分:小商店是什么

第二部分:如何开通一个小商店

第三部分:如何登录小商店

第四部分:开店任务常见问题

第五部分:小商店可以卖什么

第六部分:HiShop小程序特色功能

第七部分:小程序直播

第八部分:小程序收货/物流

第九部分:小程序怎么结算

第十部分:小程序客服

第十一部分:电商创业

第十二部分:小程序游戏开发