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

HTMLTrackElement:cuechange 事件

· 52CE 我爱测

`cuechange`** 事件在 TextTrack 更改当前显示提示(cue)时触发。此事件在 `TextTrack` 和显示它的 HTMLTrackElement(如果有的话)上触发。

WebVTT

cuechange 事件在 TextTrack 更改当前显示提示(cue)时触发。此事件在 TextTrack 和显示它的 HTMLTrackElement(如果有的话)上触发。

语法

在像 EventTarget.addEventListener 这样的方法中使用此事件名,或设置事件处理器属性。

addEventListener("cuechange", (event) => {});

oncuechange = (event) => {};

事件类型

没有添加属性的通用 Event。

示例

每当当前呈现的 cue 更改时,由 HTMLTrackElement.track 属性指示的底层 TextTrack 会接收 cuechange 事件。即使轨道并未与媒体元素关联,也会发生。

如果轨道和媒体元素是关联的,使用 track 元素作为 audio 或 video 的子元素,cuechange 事件也发送给 HTMLTrackElement。

let textTrackElem = document.getElementById("texttrack");

textTrackElem.addEventListener("cuechange", (event) => {
  let cues = event.target.track.activeCues;
});

或者,你可以使用 oncuechange 事件处理器。

let textTrackElem = document.getElementById("texttrack");

textTrackElem.oncuechange = (event) => {
  let cues = event.target.track.activeCues;
};

规范

浏览器兼容性

参见

  • WebVTT
  • TextTrack 上的同一事件:TextTrack.cuechange_event

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

资料来源与适用范围

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

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

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