基础库 1.0.0 开始支持,低版本需做兼容处理。
图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式,2.3.0 起支持云文件ID。
| 属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
| src | string | | 否 | 图片资源地址 | 1.0.0 |
| mode | string | scaleToFill | 否 | 图片裁剪、缩放的模式 | 1.0.0 |
| 合法值 | 说明 | 最低版本 | scaleToFill | 缩放模式,不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素 | | aspectFit | 缩放模式,保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。 | | aspectFill | 缩放模式,保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。 | | widthFix | 缩放模式,宽度不变,高度自动变化,保持原图宽高比不变 | | heightFix | 缩放模式,高度不变,宽度自动变化,保持原图宽高比不变 | 2.10.3 | top | 裁剪模式,不缩放图片,只显示图片的顶部区域 | | bottom | 裁剪模式,不缩放图片,只显示图片的底部区域 | | center | 裁剪模式,不缩放图片,只显示图片的中间区域 | | left | 裁剪模式,不缩放图片,只显示图片的左边区域 | | right | 裁剪模式,不缩放图片,只显示图片的右边区域 | | top left | 裁剪模式,不缩放图片,只显示图片的左上边区域 | | top right | 裁剪模式,不缩放图片,只显示图片的右上边区域 | | bottom left | 裁剪模式,不缩放图片,只显示图片的左下边区域 | | bottom right | 裁剪模式,不缩放图片,只显示图片的右下边区域 | |
|
| webp | boolean | false | 否 | 默认不解析 webP 格式,只支持网络资源 | 2.9.0 |
| lazy-load | boolean | false | 否 | 图片懒加载,在即将进入一定范围(上下三屏)时才开始加载 | 1.5.0 |
| show-menu-by-longpress | boolean | false | 否 | 长按图片显示发送给朋友、收藏、保存图片、搜一搜、打开名片/前往群聊/打开小程序(若图片中包含对应二维码或小程序码)的菜单。 | 2.7.0 |
| binderror | eventhandle | | 否 | 当错误发生时触发,event.detail = {errMsg} | 1.0.0 |
| bindload | eventhandle | | 否 | 当图片载入完毕时触发,event.detail = {height, width} | 1.0.0 |
类型 | 说明 | 最低版本 |
小程序码 | | |
微信个人码 | | 2.18.0 |
企业微信个人码 | | 2.18.0 |
普通群码 | 指仅包含微信用户的群 | 2.18.0 |
互通群码 | 指既有微信用户也有企业微信用户的群 | 2.18.0 |
公众号二维码 | | 2.18.0 |