HTMLTrackElement: cuechange イベント

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2019年7月.

cuechange イベントは TextTrack が現在表示しているキューを変更した際に発生します。このイベントは TextTrack と、それが表示されている HTMLTrackElement があれば、その両方で発生します。

構文

このイベント名を addEventListener() などのメソッドで使用したり、イベントハンドラープロパティを設定したりしてください。

js
addEventListener("cuechange", (event) => {});

oncuechange = (event) => {};

イベント型

一般的な Event で、追加のプロパティはありません。

例

track プロパティで示される基礎となる TextTrack は、現在表示されているキューが変更される度に cuechange イベントを受信します。これは、そのトラックがメディア要素に関連付けられていない場合でも発生します。

そのトラックがメディア要素に関連付けられている場合、 <track> を <audio> または <video> 要素の子として使用すると、 cuechange イベントは HTMLTrackElement にも送信されます。

js
let textTrackElem = document.getElementById("texttrack");

textTrackElem.addEventListener("cuechange", (event) => {
  let cues = event.target.track.activeCues;
});

あるいは、 oncuechange イベントハンドラーを使用することもできます。

js
let textTrackElem = document.getElementById("texttrack");

textTrackElem.oncuechange = (event) => {
  let cues = event.target.track.activeCues;
};

仕様書

Specification

HTML
# event-media-cuechange

HTML
# handler-oncuechange

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2023年7月20日 by MDN contributors.

View this page on GitHub • Report a problem with this content

WebVTT API
HTMLTrackElement
インスタンスプロパティ
イベント
1. cuechange
継承
WebVTT に関連するページ
ガイド
1. ウェブ動画テキストトラック形式 (WebVTT)

HTMLTrackElement: cuechange イベント

In this article

構文

イベント型

例

仕様書

ブラウザーの互換性

関連情報

Help improve MDN