上一节:
下一节:

  小程序 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
上一节:
下一节: