小程序 Image

老王 • • 小程序 • 249 阅读

图片参数

属性 类型 默认值 必填 说明
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>
//scaleToFill：不保持纵横比缩放图片，使图片完全适应
<image mode="scaleToFill" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="aspectFit"

<view>
//aspectFit：保持纵横比缩放图片，使图片的长边能完全显示出来
<image mode="aspectFit" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="aspectFill"

<view>
//aspectFill：保持纵横比缩放图片，只保证图片的短边能完全显示出来
<image mode="aspectFill" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="top"

<view>
//top：不缩放图片，只显示图片的顶部区域
<image mode="top" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="bottom"

<view>
//bottom：不缩放图片，只显示图片的底部区域
<image mode="bottom" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="center"

<view>
//center：不缩放图片，只显示图片的中间区域
<image mode="center" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="left"

<view>
//left：不缩放图片，只显示图片的左边区域
<image mode="left" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="right"

<view>
//right：不缩放图片，只显示图片的右边边区域
<image mode="right" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="top left"

<view>
//top left：不缩放图片，只显示图片的左上边区域
<image mode="top left" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="top right"

<view>
//top right：不缩放图片，只显示图片的右上边区域
<image mode="top right" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="bottom left"

<view>
//bottom left：不缩放图片，只显示图片的左下边区域
<image mode="bottom left" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill

mode="bottom right"

<view>
//bottom right：不缩放图片，只显示图片的右下边区域
<image mode="bottom right" src="https://www.jc2182.com/xiaochengxu/%E5%9B%BE%E7%89%87%E7%9A%84%E5%9C%B0%E5%9D%80"></image>
</view>
编译结果
scaleToFill
以上是小程序 Image的全部内容。
THE END
分享
二维码
< <上一篇
下一篇>>