track 的 src 属性必须用 URL 编码(如 %26),不可用 HTML 实体(如 &);label 等属性值需按 HTML 规则转义引号和 &;VTT 文件内容无需 HTML 转义,但须 UTF-8 无 BOM 编码。

track 元素的 src 属性不支持 HTML 实体,别往里面写
HTML 的 <track></track> 元素本身不解析 HTML 实体,它的 src 属性是纯 URL 字符串,浏览器会原样发送请求。如果你把 captions_en.vtt?lang=zh&v=1 写成 captions_en.vtt?lang=zh&v=1,实际发出的请求里 & 后面的内容会被截断或误解析——&v=1 变成无效查询参数,字幕加载失败。
正确做法是:URL 中的 & 必须用标准 URL 编码,即 %26;空格用 %20;中文等 UTF-8 字符按字节编码(如“测试” → %E6%B5%8B%E8%AF%95)。
-
src值永远走 URL 编码,不是 HTML 实体编码 - 不要在
src里混用&和%26,选一种并保持一致 - 服务端生成 VTT 文件路径时,确保 query string 已经被
encodeURIComponent()处理过
track 的 label、kind、srclang 属性值中含单/双引号怎么办?
这些属性属于 HTML 属性值上下文,必须遵守 HTML 属性转义规则:" 在双引号包裹的属性中要写成 ",' 在单引号包裹的属性中要写成 '。但更稳妥的做法是统一用双引号包裹属性,并对内部双引号转义。
例如:<track kind="subtitles" label="User's " custom track srclang="en" src="sub.vtt"></track>
立即学习“前端免费学习笔记(深入)”;
- 属性值优先用双引号包裹(HTML5 允许单引号,但双引号兼容性更好)
-
label里出现"时,必须转为";出现&时,必须先转为&(因为 & 是实体起始符) -
srclang="zh-CN"这类带连字符的值无需转义,连字符不是特殊字符
VTT 文件内容里的 HTML 特殊字符要不要转义?
VTT(WebVTT)是纯文本格式,不是 HTML。文件里写 <b>Hello</b> 不会被浏览器当 HTML 渲染,而是原样显示为字符串。所以 VTT 内容中的 、<code>>、& **不需要** HTML 转义——直接写 <b>Hello</b> 即可。
但注意两个例外:
- VTT 文件本身必须保存为 UTF-8 编码,且不能带 BOM;否则中文、emoji 显示为乱码
- 如果 VTT 中要插入真正的 HTML 标签(比如用
<c.red></c.red>着色),那是 WebVTT 的语法,不是 HTML,不走 HTML 解析流程,也无需这种转义 - 若通过 JavaScript 动态生成 VTT 内容再 Blob 下载,拼接字符串时仍需避免未转义的
&破坏后续实体(比如©被截断),此时应只对注入到 HTML 文档的部分做 HTML 转义,而非 VTT 内容本身
JavaScript 动态创建 track 元素时,属性赋值容易漏掉哪步?
用 document.createElement('track') + setAttribute() 设置属性时,setAttribute() 会自动处理引号转义,但 **不会** 处理 &、、<code>>。这意味着你传入 label: 'A & B',最终 DOM 中的属性值仍是 A & B,而浏览器解析 HTML 时会尝试把 & B 当作实体,报错或截断。
正确方式是:对所有可能含 &、、<code>> 的属性值,先做 HTML 转义,再调用 setAttribute()。
- 推荐复用浏览器原生逻辑:
const div = document.createElement('div'); div.textContent = rawValue; return div.innerHTML; - 不要用正则链式替换,顺序错(比如先换
再换 <code>&)会导致变成 <code>< -
src属性例外:它不参与 HTML 解析,只走 URL 请求,所以应走encodeURIComponent(),而非 HTML 转义
最易被忽略的是混用上下文:VTT 文件内容、track 元素属性、JS 字符串拼接、URL 查询参数,各自有一套编码规则。一个 & 字符,在不同位置要分别处理为 &(HTML 属性)、%26(URL)、或保持原样(VTT 内容)。没分清位置就统一替换,八成出错。



















