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 die TextTrack.kind-Eigenschaft repräsentiert (subtitles, captions, descriptions, chapters oder metadata).
label: Ein string, der die TextTrack.label-Eigenschaft repräsentiert.
language: Ein string, der die TextTrack.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 # dom-media-addtexttrack-dev

Browser-Kompatibilität

BCD tables only load in the browser