大网数据广告活动
Web 标准与前端开发

HTMLTrackElement

· 52CE 我爱测

`HTMLTrackElement`** 接口表示 DOM 中的 HTML track 元素。此元素可以作为 audio 或 video 的子元素,以指定包含隐藏式字幕或标题等信息的文本轨道使用。

HTML DOM

HTMLTrackElement 接口表示 DOM 中的 HTML track 元素。此元素可以作为 audio 或 video 的子元素,以指定包含隐藏式字幕或标题等信息的文本轨道使用。

实例属性

从其父接口 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 可能丢失,且无法获得。
  • HTMLTrackElement.track

    • : 返回 TextTrack 是轨道元素的文本轨道数据。

实例方法

无特定方法;从其父接口 HTMLElement 继承方法。

事件

从其父接口 HTMLElement 继承事件。

使用 EventTarget/addEventListener 或为此接口的 oneventname 属性分配一个事件监听器来监听这些事件:

  • HTMLTrackElement.cuechange_event
    • : 当底层的 TextTrack 更改了当前呈现的 cue 时发送事件。此事件始终发送到 TextTrack,但如果与轨道关联,则也会发送到 HTMLTrackElement。你可以使用 oncuechange 事件为此事件建立处理器。

使用说明

加载轨道的文本资源

如果轨道的 TextTrack.mode 最初处于 disabled 状态,则描述文本轨道实际 cue 的 WebVTT 或 TTML 数据不加载。如果你需要在设置 <track> 之后对轨道执行任何处理,你应该确保轨道的 mode 是 hidden(如果你不想让它呈现给用户)或 showing(初始时显示轨道)。你可以以后根据需要更改模式。

规范

浏览器兼容性

参见

  • 实现此接口的 HTML 元素:track。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。