image

基础库 1.0.0 开始支持本组件。

图片。支持 JPG、PNG、SVG 格式。暂不支持 WEBP。

代码示例

开发者工具中预览

属性说明

属性名类型默认值必填说明最低支持版本
srcstringfalse图片资源地址1.0.0
modestringscaleToFillfalse图片剪裁方式,详情见后面的表格1.0.0
lazy-loadbooleanfalsefalse图片懒加载。只针对 page 与 scroll-view 下的 img 有效1.0.0
binderroreventHandlerfalse当错误发生时1.0.0
bindloadeventHandlerfalse当图片加载完时1.0.0

mode 取值范围:

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

扫码体验

请使用字节宿主APP扫码

Bug & Tip

  • Tip:img 组件默认的宽度是 300px、高度是 225px。
  • Tip:抖音安卓暂不支持 svg 格式。

常见问题

阿里 OSS 服务,安卓不显示图片,ios 可以显示图片

点击纠错
评价此篇文档