Image 图片
uni-appH5微信小程序App
跨端图片容器,支持填充模式、尺寸、圆角和加载失败插槽。
何时使用
需要控制填充、占位、懒加载或点击预览的图片展示场景。
何时不使用
纯装饰小图标用 Icon;头像用 Avatar。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
src | string | "" | 图片地址 |
alt | string | "" | 替代文本 |
fit | string:'fill' | 'contain' | 'cover' | 'none' | 'scale-down' | "cover" | 填充模式,同原生 object-fit |
width | string | number | "100%" | 宽度,数字按 px 处理 |
height | string | number | "160px" | 高度,数字按 px 处理 |
radius | boolean | false | 圆角(radius-md) |
lazy | boolean | false | IntersectionObserver 懒加载;环境不支持时降级为立即加载 |
preview | boolean | false | 点击调起全屏预览(ImagePreview) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
click | void | - |
load | void | - |
error | void | - |
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>