AudioTrackList.onchange

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

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

: addEventListener() を使用して、change イベントのハンドラを追加することもできます。

構文

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 フラグを使用してコントロールが現在どの状態にあるべきかを決定する関数です。

仕様

仕様 状態 コメント
HTML Living Standard
AudioTrackList.onchange の定義
現行の標準  
HTML5
AudioTrackList.onchange の定義
勧告  

ブラウザーの互換性

BCD tables only load in the browser