TextTrack: cuechange イベント
cuechange
イベントは、 TextTrack
が現在表示しているキューが変更されたときに発生します。このイベントは、もし表示されているものがあれば、 TextTrack
および HTMLTrackElement
(en-US) の両方に発生します。
バブリング | なし |
---|---|
キャンセル | 不可 |
インターフェイス | Event |
イベントハンドラープロパティ | GlobalEventHandlers.oncuechange (en-US) |
例
TextTrack 上で
cuechange
イベントのリスナーを TextTrack
に設定するには、 addEventListener()
メソッドを使用します。
track.addEventListener('cuechange', function () {
let cues = track.activeCues; // 現在のキューの配列
});
あるいは、 oncuechange
イベントハンドラ-プロパティを設定しても構いません。
track.oncuechange = function () {
let cues = track.activeCues; // 現在のキューの配列
}
track 要素上で
基本となる TextTrack
は、 track
プロパティで識別されますが、現在表示されているキューが変更されるたびに cuechange
イベントを受け取ります。これは、トラックがメディア要素に結び付けられていなくても発生します。
トラックがメディア要素に結び付けられている場合、 <track>
要素を <audio>
または <video>
要素の子として使用すると、 cuechange
イベントは HTMLTrackElement
(en-US) にも送信されます。
let textTrackElem = document.getElementById("texttrack");
textTrackElem.addEventListener("cuechange", (event) => {
let cues = event.target.track.activeCues;
});
また、oncuechange
イベントハンドラーを使用することもできます。
let textTrackElem = document.getElementById("texttrack");
textTrackElem.oncuechange = (event) => {
let cues = event.target.track.activeCues;
});
仕様書
仕様書 | 状態 |
---|---|
HTML Living Standard cuechange の定義 |
現行の標準 |
ブラウザーの互換性
BCD tables only load in the browser