抖音开放平台Logo
开发者文档
小程序
“/”唤起搜索
控制台
  • 组件概述
  • 基础内容
  • 视图容器
  • 表单
  • 导航
  • 媒体
  • image 图片
  • video 视频
  • live-player 实时视频播放器
  • live-preview 直播预览流组件
  • camera 相机
  • rtc-room组件
  • 画布
  • 地图
  • 开放能力
  • 行业开放
  • 原生组件
  • 拓展组件
  • 小程序智能体

    • image 图片
    收藏
    我的收藏

    基础库 1.0.0 开始支持本组件。
    图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式。

    属性说明

    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    src
    string
    无
    否
    图片资源地址。
    1.0.0
    mode
    string
    scaleToFill
    否
    图片剪裁方式，详情见 mode 的合法值。
    1.0.0
    webp
    boolean
    false
    否
    是否解析 webp 格式
    2.90.0
    lazy-load
    boolean
    false
    否
    图片懒加载，在即将进入一定范围（上下左右三屏）时才开始加载。
    1.0.0
    binderror
    EventHandle
    无
    否
    当错误发生时触发。
    1.0.0
    bindload
    EventHandle
    无
    否
    当图片载入完毕时触发。
    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

    扫码体验

    代码示例

    开发者工具中预览

    Bug & Tip

      •Tip：img 组件默认的宽度是 300px、高度是 225px;
      •Tip：不支持通过 css 设置图片 height 为 auto，如需实现高度自适应可指定 mode 为 widthFix;
      •Tip：webp 属性为 false 时，iOS 13及以下版本只能解析有.webp 后缀的 webp 图片；其他版本或设置 webp 为 true 后支持任意后缀的 webp 图片。
    ​