开发
API

image

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

图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式。

代码示例

开发者工具中预览

属性说明

属性名类型默认值必填说明最低支持版本
srcstringfalse图片资源地址1.0.0
modestringscaleToFillfalse图片剪裁方式,详情见 mode 的合法值1.0.0
lazy-loadbooleanfalsefalse图片懒加载。只针对 scroll-view 或者会产生 scroll 事件下的 img 有效1.0.0
binderrorEventHandlefalse当错误发生时1.0.0
bindloadEventHandlefalse当图片加载完时1.0.0

mode 的合法值

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

扫码体验

请使用字节宿主APP扫码

Bug & Tip

  • Tip:img 组件默认的宽度是 300px、高度是 225px。
  • Tip:抖音安卓暂不支持 svg 格式。
  • Tip:不支持通过 css 设置图片 height 为 auto,如需实现高度自适应可指定 mode 为 widthFix。
  • Tip: ios 端只支持后缀为 webp 的 webp 图片。

常见问题

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

点击纠错
评价此篇文档