HTMLTrackElement: cuechange 事件

基线 广泛可用

此功能已得到很好的建立，并且可以在许多设备和浏览器版本中运行。自 2015 年 7 月.

报告反馈

语法

当 TextTrack 更改当前显示的提示时，cuechange 事件将会触发。如果存在，此事件会在 TextTrack 和呈现它的 HTMLTrackElement 上触发。

在像 addEventListener() 这样的方法中使用事件名称，或设置事件处理程序属性。
addEventListener("cuechange", (event) => {});

oncuechange = (event) => {};

事件类型

js

示例

一个通用的 Event，没有添加任何属性。

由 track 属性指示的底层 TextTrack 每次当前呈现的提示发生更改时都会接收到 cuechange 事件。即使跟踪与媒体元素无关，也会发生这种情况。

在像 addEventListener() 这样的方法中使用事件名称，或设置事件处理程序属性。
let textTrackElem = document.getElementById("texttrack");

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

如果跟踪与媒体元素相关联，使用 <track> 元素作为 <audio> 或 <video> 元素的子元素，cuechange 事件也会发送到 HTMLTrackElement。

在像 addEventListener() 这样的方法中使用事件名称，或设置事件处理程序属性。
let textTrackElem = document.getElementById("texttrack");

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

规范

或者，您可以使用 oncuechange 事件处理程序
规范
# HTML 标准
规范
# event-media-cuechange

浏览器兼容性

handler-oncuechange

另请参阅