跳到主要内容

Image 图片 ​

WebH5

图片。支持 object-fit 填充、固定尺寸、圆角、懒加载、加载中/失败占位,以及点击全屏预览(内置 ImagePreview)。

何时使用 ​

需要控制填充、占位、懒加载或点击预览的图片展示场景。

何时不使用 ​

纯装饰小图标用 Icon;头像用 Avatar。

Props ​

名称类型默认值说明
srcstring"''"图片地址
altstring"''"替代文本
fitstring:'fill' | 'contain' | 'cover' | 'none' | 'scale-down'"cover"填充模式,同原生 object-fit
widthstring | number"-"宽度,数字按 px 处理
heightstring | number"-"高度,数字按 px 处理
radiusbooleanfalse圆角(radius-md)
lazybooleanfalseIntersectionObserver 懒加载;环境不支持时降级为立即加载
previewbooleanfalse点击调起全屏预览(ImagePreview)

Slots ​

名称说明
error加载失败占位,默认破裂图片 SVG
placeholder加载中占位,默认 bg-soft 底色块

示例 ​

基础(圆角) ​

示例加载中…

填充模式(cover / contain / fill) ​

示例加载中…

点击全屏预览 ​

示例加载中…

加载失败占位 ​

示例加载中…

不同尺寸组合 ​

示例加载中…

懒加载 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Image 文档(含手机预览)。