HTMLMediaElement: addTextTrack() 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 addTextTrack()-Methode des HTMLMediaElement-Interfaces erstellt ein neues TextTrack-Objekt und fügt es dem Medien-Element hinzu. Sie löst ein addtrack-Ereignis auf den textTracks dieses Medien-Elements aus. Diese Methode kann nicht auf einem TextTrackList-Interface verwendet werden, nur auf einem HTMLMediaElement.
Syntax
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)
Parameter
kind-
Ein
string, der dieTextTrack.kind-Eigenschaft repräsentiert (subtitles,captions,descriptions,chaptersodermetadata). label-
Ein
string, der dieTextTrack.label-Eigenschaft repräsentiert. language-
Ein
string, der dieTextTrack.language-Eigenschaft repräsentiert.
Rückgabewert
Das neu erstellte TextTrack-Objekt.
Ausnahmen
Keine.
Beispiele
Dieses Beispiel fügt ein neues TextTrack hinzu, wobei kind auf "subtitles" gesetzt ist, und fügt diesem einen neuen 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
| Spezifikation |
|---|
| HTML # dom-media-addtexttrack-dev |