image

图片。

属性名类型默认值说明
srcString图片资源地址
modeString'scaleToFill'图片裁剪、缩放的模式
lazy-loadBooleanfalse图片懒加载。只针对 page 与 scroll-view 下的 image 有效
binderrorHandleEvent当错误发生时，发布到 AppService 的事件名，事件对象 event.detail = {errMsg: 'something wrong'}
bindloadHandleEvent当图片载入完毕时，发布到 AppService 的事件名，事件对象 event.detail = {height:'图片高度px', width:'图片宽度px'}

注：image 组件默认宽度 300px、高度 225px

注：image组件中二维码/小程序码图片不支持长按识别。仅在 jd.previewImage 中支持长按识别。

mode 有效值：

mode 有 13 种模式，其中 4 种是缩放模式，9 种是裁剪模式。

模式值说明
缩放scaleToFill不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素
缩放aspectFit保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。
缩放aspectFill保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。
缩放widthFix宽度不变，高度自动变化，保持原图宽高比不变
裁剪top不缩放图片，只显示图片的顶部区域
裁剪bottom不缩放图片，只显示图片的底部区域
裁剪center不缩放图片，只显示图片的中间区域
裁剪left不缩放图片，只显示图片的左边区域
裁剪right不缩放图片，只显示图片的右边区域
裁剪top left不缩放图片，只显示图片的左上边区域
裁剪top right不缩放图片，只显示图片的右上边区域
裁剪bottom left不缩放图片，只显示图片的左下边区域
裁剪bottom right不缩放图片，只显示图片的右下边区域

示例代码

  1. <view class="page">
  2.   <view class="page__hd">
  3.     <text class="page__title">image</text>
  4.     <text class="page__desc">图片</text>
  5.   </view>
  6.   <view class="page__bd">
  7.     <view class="section section_gap" jd:for="{{array}}" jd:for-item="item">
  8.       <view class="section__title">{{item.text}}</view>
  9.       <view class="section__ctn">
  10.         <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="{{item.mode}}" src="{{src}}"></image>
  11.       </view>
  12.     </view>
  13.   </view>
  14. </view>
  1. Page({
  2.   data: {
  3.     array: [{
  4.       mode: 'scaleToFill',
  5.       text: 'scaleToFill：不保持纵横比缩放图片，使图片完全适应'
  6.     }, { 
  7.       mode: 'aspectFit',
  8.       text: 'aspectFit：保持纵横比缩放图片，使图片的长边能完全显示出来'
  9.     }, { 
  10.       mode: 'aspectFill',
  11.       text: 'aspectFill：保持纵横比缩放图片，只保证图片的短边能完全显示出来'
  12.     }, { 
  13.       mode: 'top',
  14.       text: 'top：不缩放图片，只显示图片的顶部区域' 
  15.     }, {      
  16.       mode: 'bottom',
  17.       text: 'bottom：不缩放图片，只显示图片的底部区域'
  18.     }, { 
  19.       mode: 'center',
  20.       text: 'center：不缩放图片，只显示图片的中间区域'
  21.     }, { 
  22.       mode: 'left',
  23.       text: 'left：不缩放图片，只显示图片的左边区域'
  24.     }, { 
  25.       mode: 'right',
  26.       text: 'right：不缩放图片，只显示图片的右边边区域'
  27.     }, { 
  28.       mode: 'top left',
  29.       text: 'top left：不缩放图片，只显示图片的左上边区域' 
  30.     }, { 
  31.       mode: 'top right',
  32.       text: 'top right：不缩放图片，只显示图片的右上边区域'
  33.     }, { 
  34.       mode: 'bottom left',
  35.       text: 'bottom left：不缩放图片，只显示图片的左下边区域'
  36.     }, { 
  37.       mode: 'bottom right',
  38.       text: 'bottom right：不缩放图片，只显示图片的右下边区域'
  39.     }],
  40.     src: '../../resources/cat.jpg'
  41.   },
  42.   imageError: function(e) {
  43.     console.log('image3发生error事件，携带值为', e.detail.errMsg)
  44.   }
  45. })

原图