image

图片。

属性名类型默认值说明最低版本
srcString 图片资源地址,支持云文件ID(2.2.3起) 
modeString'scaleToFill'图片裁剪、缩放的模式 
lazy-loadBooleanfalse图片懒加载。只针对page与scroll-view下的image有效1.5.0
binderrorHandleEvent 当错误发生时,发布到 AppService 的事件名,事件对象event.detail = {errMsg: 'something wrong'} 
bindloadHandleEvent 当图片载入完毕时,发布到 AppService 的事件名,事件对象event.detail = {height:'图片高度px', width:'图片宽度px'} 
aria-labelString 无障碍访问,(属性)元素的额外描述2.5.0

注1:image组件默认宽度300px、高度225px 注2:image组件中二维码/小程序码图片不支持长按识别。仅在wx.previewImage中支持长按识别。

mode 有效值:

mode 有 13 种模式,其中 4 种是缩放模式,9 种是裁剪模式。

模式说明
缩放scaleToFill不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素
缩放aspectFit保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。
缩放aspectFill保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。
缩放widthFix宽度不变,高度自动变化,保持原图宽高比不变
裁剪top不缩放图片,只显示图片的顶部区域
裁剪bottom不缩放图片,只显示图片的底部区域
裁剪center不缩放图片,只显示图片的中间区域
裁剪left不缩放图片,只显示图片的左边区域
裁剪right不缩放图片,只显示图片的右边区域
裁剪top left不缩放图片,只显示图片的左上边区域
裁剪top right不缩放图片,只显示图片的右上边区域
裁剪bottom left不缩放图片,只显示图片的左下边区域
裁剪bottom right不缩放图片,只显示图片的右下边区域

示例:

在开发者工具中预览效果

原图

image

scaleToFill

不保持纵横比缩放图片,使图片完全适应

image

aspectFit

保持纵横比缩放图片,使图片的长边能完全显示出来

image

aspectFill

保持纵横比缩放图片,只保证图片的短边能完全显示出来

image

top

不缩放图片,只显示图片的顶部区域

image

bottom

不缩放图片,只显示图片的底部区域

image

center

不缩放图片,只显示图片的中间区域

image

left

不缩放图片,只显示图片的左边区域

image

right

不缩放图片,只显示图片的右边边区域

image

top left

不缩放图片,只显示图片的左上边区域

image

top right

不缩放图片,只显示图片的右上边区域

image

bottom left

不缩放图片,只显示图片的左下边区域

image

bottom right

不缩放图片,只显示图片的右下边区域

image

原文