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

浏览器兼容性

另见