track元素是实现视频无障碍访问的关键,必须正确设置kind、srclang、src等属性,并确保VTT文件格式规范、同源或CORS配置正确,否则字幕无法加载或显示。

track 元素不是可有可无的装饰,它是让视频真正“可被所有人使用”的关键一环。没加 track,字幕、章节、描述就只能靠 JS 模拟或干脆放弃;加了但用错,用户看到的可能是乱码、空字幕、或根本加载不出来。
为什么track必须带kind和srclang
浏览器只认这两个属性组合来决定是否启用某条轨道。缺一不可,且值必须合法:
-
kind只能是subtitles(带翻译/听障辅助)、captions(含音效描述的字幕,适合听障)、descriptions(语音描述,供视障)、chapters(章节导航)、metadata(JS 读取的隐藏数据) -
srclang必须是标准语言代码,如zh、en、ja;写成zh-CN多数浏览器也接受,但chinese或cn会直接忽略该轨道 - 漏掉
srclang的subtitles轨道,Chrome/Firefox 默认不显示——它不知道这是给谁看的
track 的 src 地址必须同源或配 CORS
字幕文件(通常是 .vtt)如果放在 CDN 或不同域名下,浏览器会因跨域限制静默失败,控制台可能只报 Failed to load resource,不提 CORS 二字:
- 检查 Network 面板里
.vtt请求的 Response Headers 是否含Access-Control-Allow-Origin: *(或具体域名) - 本地开发时用
file://协议打开 HTML,所有track加载必然失败——必须走http://或https://服务 -
src路径错误时,浏览器不会报错,只是轨道列表里不出现它;建议用 DevTools 的 Elements 面板展开video元素,看track是否有readyState === 2(loaded)
default 属性只对 subtitles 和 captions 有效
加了 default 不等于“默认开启”,它只表示:当用户未手动切换字幕语言,且系统语言匹配时,这条轨道才自动启用:
立即学习“前端免费学习笔记(深入)”;
-
<track kind="subtitles" srclang="zh" src="cn.vtt" default></track>—— 若用户浏览器语言设为zh或zh-CN,则自动显示 -
<track kind="chapters" src="chapters.vtt"></track>加default没意义,章节轨道从不自动激活 - 多个
default轨道?浏览器只选第一个合法的,其余忽略 - 移动端 Safari 对
default支持不稳定,建议 JS 初始化时显式调用track.mode = "showing"
VTT 文件格式稍错就整个失效
.vtt 看似是纯文本,但头部声明、时间戳格式、换行符都敏感:
- 第一行必须是
WEBVTT(全大写,无空格),后面空一行再写字幕块 - 时间戳格式严格为
00:00:01.000 --> 00:00:04.000,毫秒位必须三位,不能少也不能多 - Windows 编辑器保存的 CRLF 换行在某些 Linux 服务器上会触发解析失败,统一用 LF
- 中文字符没问题,但 BOM(UTF-8 with BOM)会导致 Chrome 解析失败,保存时选 “UTF-8 no BOM”
最常被忽略的其实是 track 的加载时机:它不阻塞页面渲染,但也不会等视频 loadedmetadata 事件才就绪;想确保字幕可用,得监听 track 自身的 load 事件,而不是只等 video 的 canplay。



















