default属性无法可靠启用字幕,仅当同时满足srclang合法、kind="subtitles"、唯一default、src加载成功、用户首次访问且未操作字幕控件、视频已触发loadedmetadata事件时才可能生效。

default 属性为什么加了也不显示字幕
加了 default 却没自动显示字幕,不是你写错了,而是浏览器根本没按你想的执行。它不是“默认打开”,而是一个极弱的初始提示信号,只在同时满足以下全部条件时才可能生效:
-
srclang是合法 BCP 47 值(如zh-CN,不能是zh-cn、chinese或空) -
kind="subtitles"(不是captions、descriptions等) - 同一
<video></video>中只有一个<track></track>带default -
src返回 HTTP 200 + 正确 MIME 类型text/vtt(404、CORS、MIME 错误都会让轨道加载失败) - 用户首次访问该页面,且从未点过播放器上的字幕开关(包括关闭、切换、静音等)
- 视频已触发
loadedmetadata事件(否则video.textTracks还为空)
任何一条不满足,default 就静默失效——这不是 bug,是规范行为。
如何用 JS 可靠启用指定语言字幕
绕过 default 的不确定性,监听 loadedmetadata 后手动匹配并设 mode = "showing":
video.addEventListener('loadedmetadata', () => {
const userLang = navigator.languages?.[0] || navigator.language || 'zh-CN';
const baseLang = userLang.split('-')[0];
const targetTrack = Array.from(video.textTracks).find(track =>
track.kind === 'subtitles' &&
(track.srclang === userLang || track.srclang === baseLang)
);
if (targetTrack) {
targetTrack.mode = 'showing';
Array.from(video.textTracks)
.filter(t => t !== targetTrack && t.kind === 'subtitles')
.forEach(t => t.mode = 'disabled');
}
});
关键点:
立即学习“前端免费学习笔记(深入)”;
- 必须等
loadedmetadata,不能在DOMContentLoaded或onload里操作 -
srclang要和navigator.languages格式对齐(如系统返回zh-CN,就别指望zh能匹配) - 启用前不用检查
readyState,但若track.readyState (即未加载完成),<code>mode = "showing"会无效
label 和 srclang 怎么配合才让用户选得到
label 决定字幕菜单里显示什么名字,srclang 决定浏览器能否自动识别语言。两者必须协同,否则菜单可能消失或无法区分:
-
label必须填写且唯一,不能都叫"中文";推荐写成"中文(简体,官方字幕)"、"English (CC for Deaf/HoH)" -
srclang必须是 BCP 47 合法值(zh-CN、en-US、ja),大小写敏感,不能用下划线或全大写 - 多条同语言字幕(比如人工译和 AI 译)要靠
label区分,srclang可以相同 - Safari 对
label缺失极其敏感——不填或为空,字幕菜单直接不渲染
为什么 html lang 和 track srclang 都得写对
影响整页语义(SEO、读屏、翻译按钮),<track srclang="zh-CN"></track> 影响字幕匹配逻辑,两者错位会导致链路断裂:
- 页面
,但字幕srclang="zh"→ JS 按navigator.language匹配不到,用户还得手动点开菜单选 -
或lang="chinese"→ 屏幕阅读器可能跳过中文 TTS 引擎,把“行”读成 /hæŋ/ - 服务端渲染页面中,
lang必须在首屏 HTML 里写死,JS 后期改document.documentElement.lang完全无效
最易被忽略的是:多语言站点切换时,很多人只改了内容,却忘了同步更新 和所有 <track srclang></track> 的值——这两处一旦脱节,自动匹配就彻底失效。



















