AudioTrackList.onchange
AudioTrackList
の onchange
プロパティは、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