TextTrackCueList

TextTrackCueList は配列風オブジェクトで、動的に更新される TextTrackCue オブジェクトのリストを表します。

このインターフェイスにはコンストラクターはありません。このオブジェクトのインスタンスを TextTrack.cues で取得し、これが TextTrack オブジェクト内のすべてのキューを返します。

インスタンスプロパティ

TextTrackCueList.length 読取専用

unsigned long で、リスト内のキューの数です。

インスタンスメソッド

TextTrackCueList.getCueById()

渡された識別子を持つ最初の TextTrackCue オブジェクトを返します。

例

HTMLMediaElement.textTracks プロパティは、TextTrackList (en-US) オブジェクトを返します。これは、メディアにリンクされたテキストトラックごとに 1 つずつ、すべての TextTrack オブジェクトを列挙します。次に TextTrack.cues プロパティは、その具体的なトラックのキューを格納した TextTrackCueList を返します。

js
const video = document.getElementById("video");
video.onplay = () => {
  console.log(video.textTracks[0].cues);
};

仕様書

Specification
HTML Standard
# texttrackcuelist

ブラウザーの互換性

BCD tables only load in the browser