video 标签的 poster 属性用于设置视频封面图,支持所有现代浏览器,需提供有效图片 URL,推荐 JPG/PNG 格式并匹配视频宽高比,常见失效原因包括路径错误、404、跨域未配置 CORS 及 autoplay 导致一闪而过。
poster 属性就是干这个的HTML5 的 元素原生支持封面图,不用 JS、不依赖第三方库。关键就是 poster 属性,它会在视频加载完成前、未播放时、或播放失败时显示指定图片。
poster 值必须是有效的图片 URL(本地路径或绝对地址),推荐使用 JPG 或 PNG,尺寸建议与视频宽高比一致,避免拉伸或留白poster,浏览器会默认显示视频第一帧(但不可靠——有些格式不提取首帧,或首帧是黑屏)autoplay 且立即开始播放,poster 可能一闪而过,用户几乎看不到;若想确保封面停留更久,可配合 preload="metadata" 或移除 autoplay
poster 不显示,90% 是这几个问题:
poster="img/cover.jpg" 中路径相对于 HTML 文件位置,不是 CSS 或 JS 的上下文;用绝对路径更稳妥,比如 poster="/assets/video-poster.png"
Img,看 poster 请求是否返回 404 或 CORS 错误autoplay + mute 放行,导致 poster 被跳过;可临时移除 autoplay 测试Access-Control-Allow-Origin: *,否则部分浏览器(如 Firefox)会静默失败poster 属性从 IE9+、所有现代浏览器都支持,无需 polyfill。但要注意两个边缘情况:
poster
,它仍能正常显示封面poster,此时可在 内部加一个 占位,并用 CSS 控制显隐,但实际项目中基本可忽略
- 不需要额外写 JS 来“手动设置封面”——除非你要实现点击播放按钮才加载视频(懒加载场景),那才是用 JS 控制
poster 和 src 的时机
海报图尺寸和性能建议
封面图不是越大越好。它本质是一张普通 ,会参与页面首次渲染:
- 推荐尺寸:与目标容器一致,例如视频区域是 640×360,就裁切并导出 640×360 的 JPG,质量 70–80 即可
- 避免用未压缩的 PNG 或高清大图:2MB 的 poster 会让首屏加载明显变慢,且用户还没点播放就下载了无用资源
- 可以内联 base64(仅限极小图):
poster="data:image/jpeg;base64,/9j/4AAQ...",但超过 2KB 就不建议,影响 HTML 体积和缓存效率
- 如果封面需要动态生成(如带文字标题),优先走服务端渲染 URL,而不是前端 canvas 绘制后转 data URL —— 后者性能差、无法缓存
真正容易被忽略的是:很多人把 poster 当成“美化手段”,却没检查它在弱网或 404 下是否降级合理。务必在 DevTools 里禁用网络或手动删掉图片文件,确认 fallback 文字或空白状态是否可接受。