AudioTrackList: change 事件

可用性有限

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

當音訊軌道被啟用或停用時，會觸發 change 事件，例如透過更改軌道的 enabled 屬性。

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

語法

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

addEventListener("change", (event) => { })

onchange = (event) => { }

事件型別

一個通用的 Event。

示例

使用 addEventListener()

const videoElement = document.querySelector("video");
videoElement.audioTracks.addEventListener("change", (event) => {
  console.log(`'${event.type}' event fired`);
});

// changing the value of `enabled` will trigger the `change` event
const toggleTrackButton = document.querySelector(".toggle-track");
toggleTrackButton.addEventListener("click", () => {
  const track = videoElement.audioTracks[0];
  track.enabled = !track.enabled;
});

使用 onchange 事件處理程式屬性

const videoElement = document.querySelector("video");
videoElement.audioTracks.onchange = (event) => {
  console.log(`'${event.type}' event fired`);
};

// changing the value of `enabled` will trigger the `change` event
const toggleTrackButton = document.querySelector(".toggle-track");
toggleTrackButton.addEventListener("click", () => {
  const track = videoElement.audioTracks[0];
  track.enabled = !track.enabled;
});

規範

規範
HTML # event-media-change
HTML # handler-tracklist-onchange

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改時間為 2025 年 9 月 25 日，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤