AudioTrackList: removetrack 事件

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

當一個音軌從 AudioTrackList 中移除時,會觸發 removetrack 事件。

語法

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

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

onremovetrack = (event) => { }

事件型別

一個 TrackEvent。繼承自 Event

Event TrackEvent

事件屬性

TrackEvent 基於 Event,因此 Event 的屬性在 TrackEvent 物件上也是可用的。

track 只讀

事件引用的 DOM 軌道物件。如果不是 null,則始終是以下媒體軌道型別之一的物件:AudioTrackVideoTrackTextTrack)。

描述

觸發

每當一個音軌從由 AudioTrackList 物件表示的媒體元素的音軌中移除時,都會呼叫 removetrack 事件。

此事件不可取消,也不會冒泡。

用例

您可以使用此事件來響應新的音軌變得不可用。例如,您可能希望更新 UI 元素,禁止使用者選擇已移除的音軌。

示例

使用 addEventListener()

js
const videoElement = document.querySelector("video");

videoElement.audioTracks.addEventListener("removetrack", (event) => {
  console.log(`Audio track: ${event.track.label} removed`);
});

使用 onremovetrack 事件處理程式屬性

js
const videoElement = document.querySelector("video");

videoElement.audioTracks.onremovetrack = (event) => {
  console.log(`Audio track: ${event.track.label} removed`);
};

規範

規範
HTML
# event-media-removetrack
HTML
# handler-tracklist-onremovetrack

瀏覽器相容性

另見