---
url: /components/image-wall.md
---
# ImageWall 图片墙

`EvImageWall` 网格图片墙：默认三列、统一 4:3 画幅，点击任意图片直接打开
[ImagePreview 图片预览](./image-preview) 灯箱；`preview` 关闭后只派发 select 事件。

## 基础用法

```vue
<EvImageWall
  :images="[
    { src: '/images/a.jpg', alt: '山脊线' },
    { src: '/images/b.jpg', alt: '雾中山林' },
  ]"
  :columns="3"
/>
```

## API

### Props

| 属性 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| images | 图片列表：url 字符串或 `{ src, alt }` | array | `[]` |
| columns | 列数 | number | `3` |
| gap | 间距（px） | number | `14` |
| radius | 圆角（px） | number | `12` |
| preview | 点击打开预览灯箱 | boolean | `true` |

### 事件

| 事件 | 说明 |
| --- | --- |
| select | 点击图片时触发，参数为 `(item, index)` |