HTMLTrackElement:cuechange 事件

Baseline 已廣泛支援

此功能已非常成熟,並且在多種裝置和瀏覽器版本中均可正常工作。自 ⁨2019 年 7 月⁩ 起,所有瀏覽器均已支援此功能。

TextTrack 更改當前顯示的提示(cue)時,會觸發 cuechange 事件。如果提示正在呈現,該事件會同時在 TextTrackHTMLTrackElement 上觸發。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

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

oncuechange = (event) => { }

事件型別

一個通用的 Event,沒有額外的屬性。

示例

track 屬性指示的底層 TextTrack,在每次當前呈現的提示發生更改時都會收到 cuechange 事件。即使該軌道未與媒體元素關聯,也會發生這種情況。

如果該軌道 *確實* 與媒體元素相關聯,並且作為 <audio><video> 元素的子元素使用 <track> 元素,則 cuechange 事件也會發送到 HTMLTrackElement

js
let textTrackElem = document.getElementById("text-track");

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

或者,您也可以使用 oncuechange 事件處理器

js
let textTrackElem = document.getElementById("text-track");

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

規範

規範
HTML
# event-media-cuechange
HTML
# handler-oncuechange

瀏覽器相容性

另見