TextTrack:cuechange 事件

基线 广泛可用

此功能已得到很好的确立,并且可以在许多设备和浏览器版本上运行。它自以下时间起在浏览器中可用: 2015 年 7 月.

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

语法

在诸如 addEventListener() 的方法中使用事件名称,或设置事件处理程序属性。

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

oncuechange = (event) => {};

事件类型

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

示例

您可以使用 addEventListener() 方法在 TextTrack 上为 cuechange 事件设置侦听器

js
track.addEventListener("cuechange", () => {
  const cues = track.activeCues; // array of current cues
  // …
});

或者您可以设置 oncuechange 事件处理程序属性

js
track.oncuechange = (event) => {
  let cues = track.activeCues; // array of current cues
};

规范

规范
HTML 标准
# event-media-cuechange
HTML 标准
# handler-texttrack-oncuechange

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅