• image

    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. })