image

图片。

属性名类型默认值说明
srcString图片资源地址，支持云文件ID（2.2.3起）
modeString'scaleToFill'图片裁剪、缩放的模式
lazy-loadBooleanfalse图片懒加载。只针对page与scroll-view下的image有效
binderrorHandleEvent当错误发生时，发布到 AppService 的事件名，事件对象event.detail = {errMsg: 'something wrong'}
bindloadHandleEvent当图片载入完毕时，发布到 AppService 的事件名，事件对象event.detail = {height:'图片高度px', width:'图片宽度px'}
aria-labelString无障碍访问，（属性）元素的额外描述

注1：image组件默认宽度300px、高度225px**注2：image组件中二维码/小程序码图片不支持长按识别。仅在qq.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" qq:for="{{array}}" qq:for-item="item">
  8.       <view class="section__title">{{item.text}}</view>
  9.       <view class="section__ctn">
  10.         <image
  11.           style="width: 200px; height: 200px; background-color: #eeeeee;"
  12.           mode="{{item.mode}}"
  13.           src="{{src}}"
  14.         ></image>
  15.       </view>
  16.     </view>
  17.   </view>
  18. </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(e) {
  43.     console.log('image3发生error事件，携带值为', e.detail.errMsg)
  44.   }
  45. })