track元素不支持自定义属性传参,浏览器仅识别kind、src、srclang、label和default标准属性;data-*属性会被忽略,需将参数存于video/audio父元素或JS变量中,通过label/srclang关联配置。

track 元素本身不支持自定义属性传参
track 是 HTML5 的语义化字幕/描述轨道元素,浏览器只认 kind、src、srclang、label 和 default 这几个标准属性。你加 data-xxx 或其他自定义属性(比如 data-user-id="123")虽然不会报错,但浏览器解析时直接忽略,JavaScript 也无法通过 track 实例原生访问到这些值——因为 track 元素在 DOM 中对应的接口是 HTMLTrackElement,它没有反射自定义属性的机制。
用 data- 属性 + 手动绑定才是可行方案
真正能落地的做法,是把参数存在 或 父容器上,再通过 JS 关联到对应 track:
- 给
添加data-track-config='{"en":"v1","zh":"v2"}',然后在脚本里解析 JSON 并匹配srclang - 或遍历
video.textTracks,用track.label作为键,在外部 Map 中查配置:const trackConfig = new Map([ ['English CC', { mode: 'forced', apiVersion: 'v2' }], ['中文字幕', { mode: 'hidden', apiVersion: 'v3' }] ]); - 不要依赖
track.dataset——它永远是空对象,哪怕你在 HTML 里写了data-api-key="abc"
动态创建 track 时,参数必须走 JS 构造逻辑
如果 track 是运行时用 document.createElement('track') 创建的,自定义参数只能存在 JS 变量或闭包里,不能塞进元素本身:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 正确做法:用
track.customData = { userId: 456, timestamp: Date.now() }直接挂载属性(仅限 JS 运行时) - 错误做法:试图用
track.setAttribute('data-user-id', '456')再期望后续能读回来——读不到 - 注意:
track.mode改变时(如从disabled切到showing),你的customData依然存在,但别指望它被序列化或跨 iframe 传递
想让后端知道用户选了哪条 track?靠事件 + 显式上报
浏览器不会自动把 track 切换行为连带参数发给服务端。你得监听 texttrackchange 或轮询 video.textTracks,再手动触发上报:
- 监听
video.addEventListener('texttrackchange', () => { ... })不可靠,实际应监听video.textTracks.onaddtrack和track.oncuechange组合判断 - 推荐在
track.mode === 'showing'且track.cues.length > 0时,取track.label或track.srclang,拼上你预先存好的配置 Map 发请求 - 别试图从
track.srcURL 里解析参数(比如/sub/v2?lang=zh&user=789)——CDN 缓存、CORS、Referer 限制都会让它失效
实际最稳的路径就一条:参数存在 JS 作用域里,track 只负责声明“我是谁”(label / srclang),其余全靠代码桥接。HTML 层面的 track 天然就是个瘦壳子,硬往里塞东西只会掉坑里。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










