---
url: /components/video.md
---
# Video 视频

`EvVideo` 在固定画幅内优雅地承载视频：默认渲染原生 `video` 控件（支持封面图），也可用默认插槽
嵌入视频平台的 iframe 分享代码。画幅四档可选，避免上传视频导致的页面跳动。

## 基础用法

```vue
<EvVideo src="/demo.mp4" poster="/cover.jpg" caption="30 秒了解新编辑器" />
```

## 画幅比例

```vue
<EvVideo aspect="16:9" />
<EvVideo aspect="9:16" />
```

::: tip 嵌入平台视频
使用默认插槽放置 iframe，画幅容器依然生效：`<EvVideo><iframe src="…" /></EvVideo>`
:::

## API

### Props

| 属性 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| src | 视频地址（渲染原生 video） | string | — |
| poster | 封面图 | string | — |
| aspect | 画幅比例 | `'16:9' \| '4:3' \| '1:1' \| '9:16'` | `'16:9'` |
| caption | 下方说明文案 | string | — |

### 插槽

| 插槽 | 说明 |
| --- | --- |
| default | 覆写媒体内容（可放 iframe） |
| caption | 说明文案覆写 |

### 事件

| 事件 | 说明 |
| --- | --- |
| play / pause | 原生 video 播放/暂停时派发 |