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 の定義
勧告  

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
onchangeChrome 完全対応 45
無効
完全対応 45
無効
無効 From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 12Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 32
無効
完全対応 32
無効
無効 From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 完全対応 45Chrome Android 完全対応 45
無効
完全対応 45
無効
無効 From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 32
無効
完全対応 32
無効
無効 From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7.1Samsung Internet Android ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。