TextTrackCueList

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

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

インスタンスプロパティ

TextTrackCueList.length 読取専用

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

インスタンスメソッド

TextTrackCueList.getCueById()

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

例

HTMLMediaElement.textTracks プロパティは、TextTrackList オブジェクトを返します。これは、メディアにリンクされたテキストトラックごとに 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