TextTrack: cuechange 事件

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

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

语法

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

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

oncuechange = (event) => { }

一个通用的 Event，没有额外的属性。

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

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

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

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

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

此页面由 MDN 贡献者最后修改于 ⁨2025 年 5 月 2 日⁩。