TextTrack: addCue()-Methode

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.

Die addCue()-Methode der TextTrack-Schnittstelle fügt eine neue Cue zur Liste der Cues hinzu.

Syntax

js
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

InvalidStateError DOMException

Wird ausgelöst, wenn die Regeln für diese TextTrackList nicht mit denen übereinstimmen, die für die eingehende TextTrackCue geeignet sind.

Beispiele

Im folgenden Beispiel werden zwei Cues zu einem Video-Texttrack mit addCue() hinzugefügt.

js
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

Specification
HTML Standard
# dom-texttrack-addcue-dev

Browser-Kompatibilität

BCD tables only load in the browser