跳到主要内容

Image 图片 ​

uni-appH5微信小程序App

跨端图片容器,支持填充模式、尺寸、圆角和加载失败插槽。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Image 图片 · uni-app H5 实时运行 新窗口打开

Props ​

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

Events ​

名称载荷说明
clickvoid-
loadvoid-
errorvoid-

Slots ​

名称说明
placeholder加载占位
error错误占位

示例 ​

圆角与填充 ​

vue
<Image :src="imgA" radius height="140px" />

占位与错误插槽 ​

vue
<Image src="" height="120px" radius>
  <template #placeholder><Text variant="caption">加载中…</Text></template>
  <template #error><Text variant="caption">图片不存在</Text></template>
</Image>

自定义尺寸 ​

vue
<view class="row">
  <Image :src="imgA" width="120px" height="80px" radius />
  <Image :src="imgB" width="120px" height="80px" radius fit="contain" />
</view>

懒加载与点击预览 ​

vue
<view class="row">
  <Image :src="imgA" width="150" height="84" radius="8" lazy />
  <Image :src="imgB" width="150" height="84" radius="8" preview />
</view>