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

js
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)

Parameter

kind

Ein String, der die TextTrack.kind-Eigenschaft darstellt (subtitles, captions, descriptions, chapters oder metadata).

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.

js
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

Siehe auch