开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
视图容器
基础内容
表单组件
导航
媒体组件
画布
地图
开放组件
无障碍访问
页面属性配置节点
扩展组件
广告
开发 > 组件 > 媒体组件 > image 图片
贡献者 2
收藏
订阅更新
我的文档
设置
简介
图片。支持 jpg、png、svg、webp、gif 等格式。
使用限制
使用 webview 嵌套 h5 时,若遇到图片资源不显示问题,可查看 配置 h5 白名单流程 获取 h5 页面中所有的域名地址(含图片静态资源的地址),全部加入域名白名单中。
扫码体验

使用
在线示例

属性说明
属性
类型
描述
src
string
图片地址。
mode
string
图片模式。 默认值: scaletofill
class
string
外部样式。
style
string
内联样式。
lazy-load
boolean
支持图片懒加载,不支持通过 css 来控制 image 展示隐藏的场景。 默认值: false 版本要求: 基础库 1.9.0
及以上
default-source
string
默认图片地址,若设置默认图片地址,会先显示默认图片,等 src 对应的图片加载成功后,再渲染对应的图片。 版本要求: 基础库 1.19.0
及以上
onload
eventhandle
图片载入完毕时触发,事件对象 event.detail = {height: '图片高度px', width: '图片宽度px'}

onerror
eventhandle
当图片加载错误时触发,事件对象 event.detail = {errmsg: 'something wrong'

ontap
eventhandle
点击图片时触发。
catchtap
eventhandle
点击图片时触发,阻止事件冒泡。
注意:image 组件默认宽度 300px、高度 225px。
mode
mode 有 14 种模式,其中 5 种是缩放模式,9 种是裁剪模式。
缩放模式
属性
描述
scaletofill
不保持纵横比缩放,使图片的宽高完全拉伸至填满 image 元素。
aspectfit
保持纵横比缩放,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。
aspectfill
保持纵横比缩放,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。
widthfix
宽度不变,高度自动变化,保持原图宽高比不变。
heightfix
高度不变,宽度自动变化,保持原图宽高比不变。 版本要求:基础库 2.7.0
及以上
裁剪模式
属性
描述
top
不缩放图片,只显示顶部区域。
bottom
不缩放图片,只显示底部区域。
center
不缩放图片,只显示中间区域。
left
不缩放图片,只显示左边区域。
right
不缩放图片,只显示右边区域。
top left
不缩放图片,只显示左上边区域。
top right
不缩放图片,只显示右上边区域。
bottom left
不缩放图片,只显示左下边区域。
bottom right
不缩放图片,只显示右下边区域。
说明:图片高度不能设置为 auto,如果需要图片高度为 auto,直接设置 mode 为 widthfix。
bug & tip
在 android 系统中,如果给 image 设置缩放模式为 mode="widthfix" 的同时添加了 display: flex 样式,需要额外设置以下两种中的一种样式:
同时指定 flex-direction: column。
当 flex-direction: row (默认值) 时,同时指定交叉轴对齐方式 align-items ,并确保 align-items 不从 normal、stretch、inherit、initial、unset 中取值。
常见问题
image 标签支持读取流文件吗?
小程序中显示二进制数据流的图片,需要先将二进制数据转成 base64 字符串,然后把 base64 字符串放在 image 中的 src 中实现显示。
为什么真机调用 image 组件,显示的图片被压缩?
建议把 mode 值设为 widthfix。
相关文档
my.chooseimage
my.compressimage
my.getimageinfo
my.previewimage
my.saveimage
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录