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 完全対応 37
無効
完全対応 37
無効
無効 From version 37: 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 完全対応 79
無効
完全対応 79
無効
無効 From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
未対応 12 — 79
Firefox 完全対応 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 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 未対応 なしChrome Android 完全対応 37
無効
完全対応 37
無効
無効 From version 37: 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 完全対応 24
無効
完全対応 24
無効
無効 From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7Samsung Internet Android 未対応 なし

凡例

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