track元素需JavaScript手动匹配系统语言启用字幕,srclang须严格符合BCP 47规范,WebVTT文件格式零容错,且track必须为video直接子元素并置于source之后。

track元素不会“自动加载”,必须用JavaScript主动匹配
浏览器解析 时只做声明,不触发语言感知逻辑;default 属性仅控制是否默认启用,跟系统语言无关。真正实现“按系统语言启用对应字幕”,得等
- 必须监听
video的load或loadedmetadata事件后再操作,否则video.textTracks可能为空或状态为0 - 优先用
navigator.languages[0](用户首选语言列表),比navigator.language更准;fallback 到.split('-')[0]截主码(如zh-Hans→zh) - 匹配时先试完整标签(
zh-Hans),再试主码(zh),没找到就设en轨道为showing - 设一个轨道为
showing前,记得把其他同 kind 的轨道设为disabled,否则可能多轨叠加显示
srclang值必须严格符合BCP 47,不能自定义
srclang 不是随便写的标识符,它是浏览器匹配系统语言的唯一依据。写错就等于该轨道“不存在”——菜单里不出现、JS 也查不到。
- 正确写法:
srclang="zh"、srclang="zh-Hans"、srclang="zh-Latn"(拼音)、srclang="en-US" - 错误写法:
srclang="chinese"、srclang="zh_CN"(下划线)、srclang="pinyin"、srclang="cn" - 中文繁体建议用
srclang="zh-Hant",而非zh-TW(虽部分浏览器兼容,但非标准) - 拼音轨道必须用
zh-Latn,这是 W3C 明确推荐的 BCP 47 标签,辅助技术可识别
WebVTT文件格式错一位,整个轨道静默失效
浏览器对 .vtt 文件几乎零容错:首行不是顶格 WEBVTT、时间戳毫秒位不足三位、文件带 BOM、MIME 类型不对……都会导致轨道加载失败,且控制台通常不报错。
- 首行必须是纯文本
WEBVTT(全大写、无空格、无 BOM、无注释) - 时间戳格式严格为
HH:MM:SS.mmm --> HH:MM:SS.mmm,毫秒必须三位(00:00:01.230✅,00:00:01.23❌) - 保存为 UTF-8 无 BOM(VS Code 默认是,记事本默认带 BOM,会出问题)
- 服务端需返回
Content-Type: text/vtt;本地开发别用file://协议,起个python3 -m http.server服务
结构位置错,track标签等于没写
必须是 的**直接子元素**,且必须放在所有 之后、 之前。放错位置,浏览器直接忽略,连请求都不会发。
- ✅ 正确顺序:
- ❌ 错误示例:
在前、包在里、写在外、中间插了 HTML 注释- 动态用
appendChild()插入无效——已解析完成,不会再扫描新- 多个
之间不要有空行或注释,Safari 可能中断后续解析实际生效的关键点往往藏在最不起眼的地方:WebVTT 首行少个字母、
srclang多个下划线、被套进一层——这些都足以让整套多语言字幕逻辑彻底静默失效,而且你很难从控制台发现原因。 - 动态用
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











