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 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
| Specification |
|---|
| HTML Standard # dom-media-addtexttrack-dev |
Browser-Kompatibilität
BCD tables only load in the browser