TextTrack: addCue()-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 addCue()-Methode der TextTrack-Schnittstelle fügt eine neue Cue zur Liste der Cues hinzu.
Syntax
addCue(cue)
Parameter
cue-
Ein
TextTrackCue.
Hinweis:
Die Schnittstelle TextTrackCue ist eine abstrakte Klasse, die als Elternklasse für andere Cue-Schnittstellen wie VTTCue dient. Daher verwenden Sie beim Hinzufügen einer Cue einen der Cue-Typen, die von TextTrackCue erben.
Rückgabewert
Undefiniert.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn die Regeln für diese
TextTrackListnicht mit denen übereinstimmen, die für die eingehendeTextTrackCuegeeignet sind.
Beispiele
Im folgenden Beispiel werden zwei Cues zu einem Video-Texttrack mit addCue() hinzugefügt.
let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";
track.addCue(new VTTCue(0, 0.9, "Hildy!"));
track.addCue(new VTTCue(1, 1.4, "How are you?"));
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-texttrack-addcue-dev |