TextTrack: Methode removeCue()
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 removeCue() Methode der TextTrack-Schnittstelle entfernt eine Untertitelung aus der Liste der Untertitelungen.
Syntax
removeCue(cue)
Parameter
cue-
Ein
TextTrackCue.
Rückgabewert
Undefiniert.
Ausnahmen
NotFoundErrorDOMException-
Wird ausgelöst, wenn die angegebene Untertitelung nicht in der Liste der Untertitelungen gefunden wird.
Hinweis:
Die TextTrackCue-Schnittstelle ist eine abstrakte Klasse, die als Elternteil für andere Untertitelungsschnittstellen wie VTTCue verwendet wird. Daher wird beim Entfernen einer Untertitelung einer der Untertitelungstypen übergeben, der von TextTrackCue erbt.
Beispiele
Im folgenden Beispiel wird einer Video-Textspur eine Untertitelung mit addCue() hinzugefügt und dann mit removeCue entfernt.
let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";
let cue = new VTTCue(0, 0.9, "Hildy!");
track.addCue(cue);
track.removeCue(cue);
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-texttrack-removecue-dev |