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