组件功能
用于播放视频的组件,支持自定义封面图、宽高比及播放器尺寸。
基础用法
通过 src 指定视频资源,poster 设置封面图,aspectRatio 控制宽高比。
Template 示例:
<Video src="https://www.w3schools.com/html/mov_bbb.mp4" poster="https://www.w3schools.com/html/pic_trulli.jpg" aspectRatio="16:9" />
效果展示如下:

属性说明
| 属性名 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| src ★ | string |
视频资源 URL | - |
| poster | string |
视频封面图片 URL | - |
| aspectRatio | "16:9" | "9:16" | "4:3" | "3:4" |
播放器宽高比 | "16:9" |
| size | "sm" | "md" | "lg" |
播放器尺寸 | - |
注意:
★ 标记为必填属性。
尺寸说明
| 尺寸 | 宽度 | 适用场景 |
|---|---|---|
| sm | 260px | 侧边栏、小卡片 |
| md | 320px | 常规内容区 |
| lg | 480px | 主要内容区 |
| 默认 | 100% | 自适应容器宽度 (最小 260px,最大 100%) |
宽高比说明
-
16:9:标准宽屏比例(推荐)。
-
9:16:竖屏比例(适合移动端)。
-
4:3:传统电视比例。
-
3:4:竖屏传统比例。
播放器功能
视频播放器默认提供以下功能:
-
播放/暂停控制。
-
音量控制。
-
全屏播放。
-
进度条拖拽。
-
播放速度调整。