元素不能跨复用,每个视频必须有独立的标签;即使src相同,也需分别声明,浏览器通过HTTP缓存复用字幕文件。

<track></track> 元素不能跨 <video></video> 复用 —— 每个 <video></video> 必须拥有自己独立的 <track></track> 标签,哪怕字幕文件完全相同。
这是 HTML 规范强制要求的:浏览器将 <track></track> 与它所属的父 <video></video> 绑定为一对一关系;DOM 中不存在“共享 track 实例”的概念。试图用 JS 把同一个 <track></track> 元素 append 到多个 video 下,只会把它从原位置移走,不会复制。
为什么不能直接复用 DOM 的 <track></track> 节点
浏览器内部把每个 <track></track> 关联到特定 TextTrack 对象,而该对象生命周期绑定于其宿主 <video></video>。即使你 cloneNode(true),新节点仍需被插入到目标 <video></video> 内部才能激活,且必须在 <video></video> 加载前或加载中完成(否则部分浏览器会忽略)。
共用同一份 WebVTT 字幕文件的正确写法
多个视频可以指向同一个 .vtt 文件路径,但每个都要声明自己的 <track></track> 标签:
<video id="lesson1" controls> <source src="lesson1.mp4"> <track kind="subtitles" srclang="zh" label="中文翻译" src="common.vtt" default> </video> <video id="lesson2" controls> <source src="lesson2.mp4"> <track kind="subtitles" srclang="zh" label="中文翻译" src="common.vtt"> </video>
-
src值可完全一致,浏览器会缓存并复用请求(HTTP 缓存生效) - 每个
<track></track>的srclang、label、kind应根据实际语义设置,不要为了“省事”全写一样 —— 否则用户在多语言切换时无法区分 - 若某视频需要默认启用字幕,仅在对应
<track></track>上加default,不要多个都加
用 JavaScript 动态挂载相同字幕轨道
适合自定义 UI、无原生 controls 的场景。关键点是:对每个 <video></video> 单独创建 <track></track> 并 append,而非复用节点:
function addSharedTrack(videoEl, vttUrl, options = {}) {
const track = document.createElement('track');
track.kind = options.kind || 'subtitles';
track.srclang = options.srclang || 'zh';
track.label = options.label || '中文';
track.src = vttUrl;
if (options.default) track.default = true;
videoEl.appendChild(track);
}
addSharedTrack(document.getElementById('lesson1'), '/sub/common.vtt', { default: true });
addSharedTrack(document.getElementById('lesson2'), '/sub/common.vtt');
- 每次调用都新建
<track></track>,确保各视频拥有独立轨道实例 - 注意时机:必须在
videoEl已插入 DOM 且未load()完成前执行(推荐在videoEl创建后、src设置后立即添加) - 如果视频已开始播放,动态添加的
<track></track>可能不会立刻显示字幕,需手动触发textTracks[0].mode = 'showing'
容易被忽略的兼容性细节
WebVTT 文件本身虽可复用,但以下两点常导致“看起来没生效”:
立即学习“前端免费学习笔记(深入)”;
-
srclang值必须符合 BCP 47 标准(如zh、zh-Hans、zh-Latn),写成chinese或pinyin会导致轨道不被识别为有效字幕源 - 服务器需返回正确的 MIME 类型:
text/vtt;若返回text/plain,Chrome 和 Safari 会静默忽略该轨道 - 跨域字幕文件必须带 CORS header(
Access-Control-Allow-Origin: *),否则 fetch 失败且控制台只报 CORS 错误,不提示 track 加载失败



















