track标签仅挂载WebVTT章节文件,需JavaScript监听cuechange事件并控制currentTime实现导航;须设kind="chapters"、按规范写VTT时间戳与标题、动态生成UI绑定跳转。

track 标签本身不能直接实现视频目录导航,它只是把 WebVTT 文件“挂载”到 video 元素上;真正实现章节跳转需要结合 JavaScript 监听字幕轨道的 cuechange 事件,并主动控制视频播放时间。
1. 正确声明 track 元素并指向章节型 WebVTT 文件
章节(chapters)是 WebVTT 的一种特殊类型,必须将 kind 属性设为 chapters,且 srclang 可选但推荐填写(如 zh),label 建议设置便于识别:
2. WebVTT 文件需符合章节格式规范
章节文件不是普通字幕,每条 cue 必须:
– 以时间戳开始(格式:HH:MM:SS.MMM --> HH:MM:SS.MMM)
– 下一行是纯文本标题(不能含 HTML 或换行)
– 时间段之间不能重叠,且应覆盖整个视频时长(或至少覆盖可导航区间)
示例 chapters.vtt:
立即学习“前端免费学习笔记(深入)”;
WEBVTT00:00:00.000 --> 00:01:23.500
片头
00:01:23.500 --> 00:05:10.200
第一幕:启程
00:05:10.200 --> 00:09:45.800
第二幕:迷途
00:09:45.800 --> 00:12:30.000
尾声
3. 用 JavaScript 解析并绑定章节导航 UI
浏览器不会自动渲染章节轨道为目录菜单。你需要:
– 获取启用的 chapters 轨道(video.textTracks[0])
– 监听 cuechange 事件获取当前活跃章节(仅用于同步高亮)
– 遍历 track.cues 提取所有章节信息,动态生成按钮或列表
– 点击时调用 video.currentTime = cue.startTime
基础实现片段:
const video = document.querySelector('video');const track = video.textTracks[0]; // 确保是 chapters 类型
const navList = document.getElementById('chapter-nav');
if (track && track.kind === 'chapters') {
for (let i = 0; i const cue = track.cues[i];
const btn = document.createElement('button');
btn.textContent = cue.text;
btn.addEventListener('click', () => {
video.currentTime = cue.startTime;
video.play();
});
navList.appendChild(btn);
}
}
4. 注意兼容性与常见问题
– Chrome、Edge、Safari 支持良好;Firefox 对 chapters 轨道的 cues 访问需确保轨道已加载完成(监听 load 事件或延后执行)
– track.mode 必须设为 "hidden" 或 "showing" 才能触发 cuechange;默认值 "disabled" 会静默忽略
– 章节 cue 的时间范围必须严格递增,否则部分浏览器可能跳过后续条目
– 不要依赖 track.activeCues 在初始化时立即获取——需等视频播放或手动触发一次 timeupdate



















