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 日⁩。