小程序 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、高度240pximage 组件中二维码/小程序码图片不支持长按识别。仅在 wx.previewImage 中支持长按识别 -
示例
原图mode="scaleToFill"
编译结果mode="aspectFit"
编译结果mode="aspectFill"
编译结果mode="top"
编译结果mode="bottom"
编译结果mode="center"
编译结果mode="left"
编译结果mode="right"
编译结果mode="top left"
编译结果mode="top right"
编译结果mode="bottom left"
编译结果mode="bottom right"
编译结果