小程序 Image



  • 图片参数

    属性 类型 默认值 必填 说明
    src string 图片资源地址
    mode string scaleToFill 图片裁剪、缩放的模式
    webp boolean false 默认不解析 webP 格式,只支持网络资源
    lazy-load boolean false 图片懒加载,在即将进入一定范围(上下三屏)时才开始加载
    show-menu-by-longpress boolean false 开启长按图片显示识别小程序码菜单
    binderror eventhandle 当错误发生时触发,event.detail = {errMsg}
    bindload eventhandle 当图片载入完毕时触发,event.detail = {height, width}
  • mode 的合法值

    说明
    scaleToFill 缩放模式,不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素
    aspectFit 缩放模式,保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。
    aspectFill 缩放模式,保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。
    widthFix 缩放模式,宽度不变,高度自动变化,保持原图宽高比不变
    heightFix 缩放模式,高度不变,宽度自动变化,保持原图宽高比不变
    top 裁剪模式,不缩放图片,只显示图片的顶部区域
    bottom 裁剪模式,不缩放图片,只显示图片的底部区域
    center 裁剪模式,不缩放图片,只显示图片的中间区域
    left 裁剪模式,不缩放图片,只显示图片的左边区域
    right 裁剪模式,不缩放图片,只显示图片的右边区域
    top left 裁剪模式,不缩放图片,只显示图片的左上边区域
    top right 裁剪模式,不缩放图片,只显示图片的右上边区域
    bottom left 裁剪模式,不缩放图片,只显示图片的左下边区域
    bottom right 裁剪模式,不缩放图片,只显示图片的右下边区域
    image 组件默认宽度300px、高度240px
    image 组件中二维码/小程序码图片不支持长按识别。仅在 wx.previewImage 中支持长按识别
  • 示例

    原图
    图片

    mode="scaleToFill"

    <view class="section__ctn">
      //scaleToFill:不保持纵横比缩放图片,使图片完全适应
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="scaleToFill" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="aspectFit"

    <view class="section__ctn">
      //aspectFit:保持纵横比缩放图片,使图片的长边能完全显示出来
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="aspectFit" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="aspectFill"

    <view class="section__ctn">
      //aspectFill:保持纵横比缩放图片,只保证图片的短边能完全显示出来
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="aspectFill" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="top"

    <view class="section__ctn">
        //top:不缩放图片,只显示图片的顶部区域
        <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="top" src="图片的地址"></image>
      </view>
      
    
    编译结果
    scaleToFill

    mode="bottom"

    <view class="section__ctn">
      //bottom:不缩放图片,只显示图片的底部区域
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="bottom" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="center"

    <view class="section__ctn">
      //center:不缩放图片,只显示图片的中间区域
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="center" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="left"

    <view class="section__ctn">
      //left:不缩放图片,只显示图片的左边区域
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="left" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="right"

    <view class="section__ctn">
      //right:不缩放图片,只显示图片的右边边区域
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="right" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="top left"

    <view class="section__ctn">
      //top left:不缩放图片,只显示图片的左上边区域
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="top left" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="top right"

    <view class="section__ctn">
      //top right:不缩放图片,只显示图片的右上边区域
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="top right" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="bottom left"

    <view class="section__ctn">
      //bottom left:不缩放图片,只显示图片的左下边区域
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="bottom left" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill

    mode="bottom right"

    <view class="section__ctn">
      //bottom right:不缩放图片,只显示图片的右下边区域
      <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="bottom right" src="图片的地址"></image>
    </view>
    
    
    编译结果
    scaleToFill