TextTrackCueList: getCueById()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die getCueById()-Methode der TextTrackCueList-Schnittstelle gibt die erste VTTCue in der Liste zurück, die durch das TextTrackCueList-Objekt dargestellt wird und deren Identifikator mit dem id-Wert übereinstimmt.
Syntax
js
getCueById(id)
Parameter
id-
Ein String, der ein Identifikator für die Cue ist.
Rückgabewert
Ein VTTCue-Objekt.
Beispiele
Die TextTrack.cues-Eigenschaft gibt eine TextTrackCueList zurück, die die aktuellen Cues für diesen bestimmten Track enthält. Der Aufruf von cues.getCueById("second") gibt die VTTCue mit der ID "second" zurück.
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;
};
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-texttrackcuelist-getcuebyid |