HTMLMediaElement: addTextTrack()-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 addTextTrack()
-Methode der HTMLMediaElement
-Schnittstelle erstellt ein neues TextTrack
-Objekt und fügt es dem Media-Element hinzu. Sie löst ein addtrack
-Ereignis auf den textTracks
dieses Media-Elements aus. Diese Methode kann nicht auf einer TextTrackList
-Schnittstelle verwendet werden, sondern nur auf einem HTMLMediaElement
.
Syntax
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)
Parameter
kind
-
Ein String, der die
TextTrack.kind
-Eigenschaft darstellt (subtitles
,captions
,descriptions
,chapters
odermetadata
). label
-
Ein String, der die
TextTrack.label
-Eigenschaft darstellt. language
-
Ein String, der die
TextTrack.language
-Eigenschaft darstellt.
Rückgabewert
Das neu erstellte TextTrack
-Objekt.
Ausnahmen
Keine.
Beispiele
Dieses Beispiel fügt ein neues TextTrack
mit der kind
-Eigenschaft auf "subtitles"
gesetzt hinzu und fügt diesem eine neue VTTCue
hinzu.
const video = document.querySelector("video");
const newTrack = video.addTextTrack("subtitles");
newTrack.addCue(new VTTCue(3, 6, "Hello world!"));
console.log(newTrack.cues[0].text);
// "Hello world!"
Spezifikationen
Specification |
---|
HTML Standard # dom-media-addtexttrack-dev |
Browser-Kompatibilität
BCD tables only load in the browser