---
url: /components/image.md
---
# Image 图片

图片容器：`fit` 填充模式、懒加载、加载失败占位、圆角；传入 `preview-src-list` 后点击可全屏预览（复用 EbImageViewer，支持多图切换 / 缩放 / Esc 关闭）。

## 基础用法与填充模式

## 点击预览（大图查看）

传入 `preview-src-list` 即可点击预览；多张图时预览器内可左右切换：

## 加载失败占位

## Image API

| 名称 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| src | String | — | 图片地址 |
| fit | String | `cover` | fill / contain / cover / none / scale-down |
| width / height | String / Number | — | 尺寸 |
| round | Boolean | `false` | 圆角 |
| lazy | Boolean | `false` | 懒加载（IntersectionObserver） |
| preview-src-list | Array | `[]` | 可预览的大图地址列表；传入后点击图片打开预览器 |
| initial-index | Number | `0` | 预览器初始定位 |
| hide-on-click-modal | Boolean | `false` | 点击遮罩关闭预览 |
| alt / referrerpolicy | String | — | 原生属性透传 |

事件：`load`、`error`、`switch(预览切换)`、`close(预览关闭)`；插槽：`error`、`placeholder`。