AudioTrackList.onchange

AudioTrackList の onchange プロパティは、change イベントが発生したときに呼び出されるイベントハンドラで、AudioTrackList 内の1つ以上の AudioTrack が有効または無効になっていることを示します。

イベントは Event オブジェクトの形でイベントハンドラに渡されます。 イベントは追加情報を提供しません。 メディアのトラックの新しい状態を判断するには、それらの AudioTrack.enabled フラグを調べる必要があります。

構文

AudioTrackList.onchange = eventHandler;

値

onchange は、メディア要素でトラックが有効または無効になったときに必ず呼び出される関数を設定します。

例

このスニペットは、リスト内の各トラックを調べる change イベントのハンドラを確立し、トラックの現在の状態を示すユーザーインターフェイスコントロールの状態を更新する関数を呼び出します。

var trackList = document.querySelector("video").audioTracks;

trackList.onchange = function(event) {
  trackList.forEach(function(track) {
    updateTrackEnabledButton(track.id, track.enabled);
  });
};

この例の updateTrackEnabledButton() は、トラックの id（おそらくアプリはトラック ID をコントロール要素の ID として使用します）でユーザーインターフェイスコントロールを見つけて、トラックの enabled フラグを使用してコントロールが現在どの状態にあるべきかを決定する関数です。

仕様

ブラウザーの互換性