TextTrackCueList: getCueById() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
getCueById() は TextTrackCueList インターフェイスのメソッドで、TextTrackCueList オブジェクトが表すリストの中で、識別子が id の値と一致する最初の VTTCue を返します。
構文
js
getCueById(id)
引数
id-
キューの識別子の文字列です。
返値
VTTCue オブジェクトです。
例
TextTrack.cues プロパティは、その具体的なトラックの現在のキューを格納した TextTrackCueList を返します。cues.getCueById("second") を呼び出すと、VTTCue のうち ID が "second" のものを返します。
WEBVTT first 00:00:00.000 --> 00:00:00.999 line:80% Hildy! second 00:00:01.000 --> 00:00:01.499 line:80% How are you?
js
const video = document.getElementById("video");
video.onplay = () => {
console.log(video.textTracks[0].cues.getCueById("second")); // a VTTCue object;
};
仕様書
| 仕様書 |
|---|
| HTML # dom-texttrackcuelist-getcuebyid |