poster属性是video标签的原生HTML属性,用于指定视频加载完成前或用户点击播放前显示的占位图;它仅在视频未开始加载或尚未解码首帧时生效,一旦首帧就绪即被替换,不响应交互且无法控制首帧内容。

video 标签的 poster 属性只在视频未播放时生效
poster 不是“封面图”,而是“加载占位图”:它只在视频尚未加载完成、用户没点播放、且浏览器还没开始解码帧时显示。一旦视频加载到第一帧(哪怕只是静音黑屏),poster 就立刻消失——哪怕你还没点播放按钮,也无论是否设置了 autoplay。
常见误用场景:
• 用 poster 想实现“点击播放前始终显示某张图”,结果一进页面就闪一下就没了;
• 把 poster 当成视频缩略图缓存机制,以为能控制首帧画面。
- 必须确保图片 URL 可访问,404 会导致空白或 fallback 行为(各浏览器不一致)
- 图片尺寸不会自动适配
video宽高,建议与width/height或 CSSobject-fit配合使用 - 移动端 Safari 对 poster 加载较慢时可能直接跳过,显示黑底
设置 poster 的正确写法和常见错误路径
直接写相对路径或绝对 URL 即可,但要注意上下文路径解析规则:
- 如果 HTML 在
/pages/video.html,而图片在/assets/cover.jpg,应写poster="/assets/cover.jpg"(以/开头才保证根路径) - 避免写
poster="cover.jpg"这种裸名,容易因当前 URL 路径层级导致 404 - 不要用 data URL(如
poster="data:image/png;base64,..."),部分 Android 浏览器会忽略 - Webpack/Vite 等构建工具中,若图片放在
src/assets/,需通过import或new URL(..., import.meta.url)获取正确运行时路径,不能硬编码原始路径
poster 和 video 首帧不一致时怎么办
poster 和视频实际第一帧经常对不上——比如你截了一张高清剧照当 poster,但视频开头是黑场或 logo 动画。这不是 bug,是设计使然。浏览器不会为了匹配 poster 去跳转或解码特定帧。
- 真正可控的“首帧封面”方案:用
preload="metadata"+canplay事件监听,手动暂停并 drawImage 到 canvas,再替换 poster 区域(需 JS 配合) - 更轻量做法:导出视频第一帧为 PNG,确保它和 poster 图像内容一致,用 FFmpeg 提前处理:
ffmpeg -i input.mp4 -ss 00:00:00.000 -vframes 1 cover.png - 不要依赖
poster实现交互式封面(如带按钮的封面图),它无法响应 click,应叠加 DOM 层
兼容性和性能影响必须注意的点
poster 属性本身兼容所有现代浏览器,但加载行为差异大:
- iOS Safari 15+ 会在
preload="none"下完全不请求 poster 图片,直到用户交互触发加载 - Chrome 会预加载 poster(即使
preload="none"),但若网络慢,可能先闪黑再出图 - 海报图建议压缩到 50KB 以内,宽高比与 video 一致,否则拉伸/裁剪逻辑由
object-fit决定,而非 poster 自身 - 不要用 poster 替代 loading spinner:它不具备状态反馈能力,需要额外 JS 控制显隐
最常被忽略的是:poster 图像加载失败时,video 元素默认不报错也不提示,只会静默留白——务必在开发期检查 Network 面板里 poster 请求是否 200。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











