TextTrackList: addtrack 事件

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

當一個軌道被新增到 TextTrackList 時,會觸發 addtrack 事件。

語法

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

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

onaddtrack = (event) => { }

事件型別

一個 TrackEvent。繼承自 Event

Event TrackEvent

事件屬性

除了下面列出的屬性之外,父介面 Event 的屬性也可使用。

track 只讀

事件引用的 TextTrack 物件。

示例

使用 addEventListener()

js
const mediaElement = document.querySelector("video, audio");

mediaElement.textTracks.addEventListener("addtrack", (event) => {
  console.log(`Text track: ${event.track.label} added`);
});

使用 onaddtrack 事件處理程式屬性

js
const mediaElement = document.querySelector("video, audio");

mediaElement.textTracks.onaddtrack = (event) => {
  console.log(`Text track: ${event.track.label} added`);
};

規範

規範
HTML
# event-media-addtrack
HTML
# handler-tracklist-onaddtrack

瀏覽器相容性

另見