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

View in English Always switch to English

HTMLTrackElement:cuechange 事件

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨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;
};

规范

Specification
HTML
# event-media-cuechange
HTML
# handler-oncuechange

浏览器兼容性

参见