原生字幕样式无法响应prefers-color-scheme,仅::cue伪元素可控但限制多:需内联style且位于video前、不支持嵌套选择器、不响应JS主题切换;Firefox支持差,跨浏览器需JS自定义渲染降级。

video 的 <track></track> 默认不响应 prefers-color-scheme
浏览器原生字幕(<track kind="subtitles"></track>)的样式由系统或 UA 样式控制,@media (prefers-color-scheme: dark) 对它完全无效——CSS 媒体查询无法穿透到字幕渲染层。你看到的白色文字+黑边是硬编码 fallback,不是可继承的 CSS 属性。
::cue 是唯一可控入口,但必须内联且位置敏感
要改字幕样式,只能用 ::cue 伪元素,但它有三个硬性限制:
- 必须写在
<style></style>标签里,且该标签得出现在<video></video>元素之前(哪怕只差一行,Safari 就可能忽略) - 不能放在外链 CSS 中,
link加载异步,::cue规则会失效 - 不支持嵌套选择器,
html[data-theme="dark"] ::cue这种写法无效,必须用独立规则块
正确写法示例:
<style>
::cue {
color: #fff;
text-shadow: 0 0 2px #000;
}
@media (prefers-color-scheme: dark) {
::cue {
color: #e0e0e0;
text-shadow: 0 0 4px #000;
}
}
</style>
<video>
<source src="video.mp4">
<track kind="subtitles" srclang="zh" label="中文" src="sub.vtt">
</video>
手动切换主题时,::cue 不会自动更新
如果你用 document.documentElement.dataset.theme 切换深色/浅色模式,::cue 样式不会响应这个变化——它只认 @media 和 UA 状态。这意味着:
立即学习“前端免费学习笔记(深入)”;
- 用户点按钮切暗色,字幕还是亮色样式(除非刷新)
- 想真正联动,得用 JS 动态重写
<style></style>内容,或提前定义两套::cue并靠 class 控制显隐(但 Safari 不支持.dark ::cue) - 更稳妥的做法:放弃纯 CSS,改用 WebVTT + 自定义字幕渲染(Canvas 或 div 模拟),完全接管样式逻辑
WebVTT 文件本身无法读取系统主题
.vtt 是纯文本格式,不执行 JS,也不解析媒体查询。里面的 <b></b>、<font color="red"></font> 等内联样式是静态的,和页面主题无关。若需动态着色,必须在加载后用 JS 解析 VTT 内容,再注入带主题 class 的 DOM 节点——这已超出 <track></track> 的能力边界。
最易被忽略的一点:::cue 在 Firefox 中支持度极低(仅基础 color),而 Chrome/Edge 的 text-shadow 渲染在 OLED 屏上可能发虚。真要保体验,得准备降级方案:检测到不支持时,直接隐藏原生字幕,用 JS 渲染替代。



















