track元素必须硬编码在video标签内且随HTML解析时加载,动态插入(包括template克隆、JS创建、innerHTML拼接)均无效;多语言切换需预埋全部track并用JS设置mode属性。

track 元素不能在 HTML 模板(<template></template>)中“动态渲染”——它压根不支持被克隆、填充或插入后生效。这不是你代码写得不对,而是浏览器规范直接禁止这种用法。
track 必须是 <video></video> 的直接子元素且随 HTML 一起解析
track 不是普通 DOM 元素,它的生命周期绑定在 <video></video> 初始化阶段:
- 浏览器只在解析 HTML 时、
<video></video>开始标签之后、所有<source></source>闭合之后这个严格窗口期内扫描并加载track; - 一旦
<video></video>进入loadedmetadata或更晚状态,再通过 JS 插入的track(哪怕用appendChild、insertAdjacentHTML或克隆template.content)都会被完全忽略; -
video.textTracks.length仍为 0,控制台无报错,静默失败。
常见错误操作:
- 把
<track></track>写进<template id="vtt-tmpl"></template>,然后在 JS 里tmpl.content.cloneNode(true)→ 插入后无效 - 动态生成
document.createElement('track')并设好src/srclang→video.textTracks里看不到 - 用
innerHTML += '<track ...>'</track>拼接进已存在的<video></video>→ 解析器早已跳过该阶段
正确做法只有一种:所有 track 必须硬编码在 HTML 中,位于 <source></source> 之后、 之前。
立即学习“前端免费学习笔记(深入)”;
多语言 track 的“动态切换”只能靠 JS 控制 mode,不是重渲染
你没法“动态生成”新 track,但可以预埋全部语言,再用 JS 切换显示:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
HTML 中一次性写全:
<video controls> <source src="movie.mp4" type="video/mp4"> <track kind="subtitles" srclang="zh" label="中文" src="zh.vtt" id="track-zh"> <track kind="subtitles" srclang="en" label="English" src="en.vtt" id="track-en"> <track kind="subtitles" srclang="ja" label="日本語" src="ja.vtt" id="track-ja"> </video>
-
JS 切换逻辑(注意:必须等
textTracks可用):const video = document.querySelector('video'); video.addEventListener('loadedmetadata', () => { const tracks = Array.from(video.textTracks); // 关闭全部 tracks.forEach(t => t.mode = 'disabled'); // 启用目标(例如中文) const zhTrack = video.textTracks.getTrackById('track-zh'); if (zhTrack) zhTrack.mode = 'showing'; });
关键点:
- 不能等
DOMContentLoaded就操作,必须等loadedmetadata或更晚(如canplay) -
textTracks是实时只读集合,不能push或add -
mode只能设为"disabled"、"hidden"、"showing",设其他值会被忽略
如果字幕内容需运行时生成(比如 API 返回的翻译),怎么办?
不能绕过 track 规范,但可降级为自定义字幕层:
- 用
fetch加载 VTT 文本,手动解析成 cue 对象数组(时间戳 + 文本) - 监听
video.timeupdate,比对当前时间,匹配并更新一个<div id="custom-subtitle"> 的 <code>textContent - 样式完全可控:
#custom-subtitle { position: absolute; bottom: 20px; text-align: center; } - 缺点:失去原生字幕菜单、无障碍支持(
aria-live需手动加)、::cueCSS 不生效
这方案和 track 是两条路:一个走标准,一个走控制权。选哪个,取决于你是否必须出现在右键字幕菜单里。
真正容易被忽略的点:track 的 src 路径必须是真实 URL,不能是 Blob URL;VTT 文件必须 UTF-8 无 BOM;服务端要返回 Content-Type: text/vtt;本地开发必须起 HTTP 服务——这些任一缺失,都表现为“写了但没字幕”,且毫无提示。


















