Get to know MDN better
此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
HTMLTrackElement 接口表示 DOM 中的 HTML <track> 元素。此元素可以作为 <audio> 或 <video> 的子元素，以指定包含隐藏式字幕或标题等信息的文本轨道使用。
EventTarget Node Element HTMLElement HTMLTrackElement从其父接口 HTMLElement 继承属性。
HTMLTrackElement.kind反映 kind HTML 属性的字符串，指示如何使用文本轨道。可能的值有：subtitles、captions、descriptions、chapters 或 metadata。
HTMLTrackElement.src反映 src HTML 属性的字符串，指示文本轨道数据的地址。
HTMLTrackElement.srclang反映 srclang HTML 属性的字符串，指示文本轨道数据的语言。
HTMLTrackElement.label反映 label HTML 属性的字符串，指示轨道的用户可读的标题。
HTMLTrackElement.default反映 default 属性的布尔值，如果用户的偏好没有指示另一个轨道更合适，则指示要启用该轨道。
HTMLTrackElement.readyState 只读返回 unsigned short 显示轨道的准备状态：
| NONE | 0 | 表示尚未获得文本轨道的提示（cue）。 |
| LOADING | 1 | 表示正在加载文本轨道，到目前为止还没有遇到致命错误。解析器可能湘轨道中添加更多 cue。 |
| LOADED | 2 | 表示已加载文本轨道，没有出现致命错误。 |
| ERROR | 3 | 表示文本轨道已启用，但当用户代理尝试获取它时，以某种方式失败了。部分或全部 cue 可能丢失，且无法获得。 |
返回 TextTrack 是轨道元素的文本轨道数据。
无特定方法；从其父接口 HTMLElement 继承方法。
从其父接口 HTMLElement 继承事件。
使用 addEventListener() 或为此接口的 oneventname 属性分配一个事件监听器来监听这些事件：
cuechange当底层的 TextTrack 更改了当前呈现的 cue 时发送事件。此事件始终发送到 TextTrack，但如果与轨道关联，则也会发送到 HTMLTrackElement。你可以使用 oncuechange 事件为此事件建立处理器。
如果轨道的 mode 最初处于 disabled 状态，则描述文本轨道实际 cue 的 WebVTT 或 TTML 数据不加载。如果你需要在设置 <track> 之后对轨道执行任何处理，你应该确保轨道的 mode 是 hidden（如果你不想让它呈现给用户）或 showing（初始时显示轨道）。你可以以后根据需要更改模式。
| HTML # htmltrackelement |
启用 JavaScript 以查看此浏览器兼容性表。