此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

HTMLTrackElement:cuechange 事件

基线 广泛可用

自 2019年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

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

语法

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

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

oncuechange = (event) => {};

事件类型

没有添加属性的通用 Event

示例

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

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

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

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

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

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

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

规范

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

浏览器兼容性

参见