image

基础库 1.0.0 开始支持，低版本需做兼容处理。 

图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式，2.3.0 起支持云文件ID。

1.图片有默认大小， 默认宽高为 320 240 

2.mode决定图片内容如何和图片标签宽高做适配

    ① scaleToFill 默认值 不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素

场景：页面轮播使用

场景：一般少用

    ④ widthFix  指定宽度后，高度auto 

    ⑤ heightFix  指定高度后，宽度auto 

     裁剪模式类似  background-position

3 小程序当中的图片 直接就支持懒加载 lazy-load

lazy-load 会自己判断， 当图片出现在视口上下三屏的高度之内的时候 自己开始加载图片

属性

类型

默认值

必填

说明

最低版本

src

string

否

图片资源地址

1.0.0

mode

string

scaleToFill

否

图片裁剪、缩放的模式

1.0.0

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

mode 的合法值

值

说明

最低版本

scaleToFill

缩放模式，不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素

aspectFit

缩放模式，保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。

aspectFill

缩放模式，保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。

widthFix

缩放模式，宽度不变，高度自动变化，保持原图宽高比不变

heightFix

缩放模式，高度不变，宽度自动变化，保持原图宽高比不变

2.10.3

top

裁剪模式，不缩放图片，只显示图片的顶部区域

bottom

裁剪模式，不缩放图片，只显示图片的底部区域

center

裁剪模式，不缩放图片，只显示图片的中间区域

left

裁剪模式，不缩放图片，只显示图片的左边区域

right

裁剪模式，不缩放图片，只显示图片的右边区域

top left

裁剪模式，不缩放图片，只显示图片的左上边区域

top right

裁剪模式，不缩放图片，只显示图片的右上边区域

bottom left

裁剪模式，不缩放图片，只显示图片的左下边区域

bottom right

裁剪模式，不缩放图片，只显示图片的右下边区域