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.

In diesem Artikel

Syntax

js
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.

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

Spezifikation

HTML
# dom-media-addtexttrack-dev

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

HTML DOM API
HTMLMediaElement
Instanzeigenschaften
Instanzmethoden
Events
Vererbung
Verwandte Seiten für HTML DOM
Anleitungen
1. Verwenden von Microtasks in JavaScript mit queueMicrotask()
2. Im Detail: Microtasks und die JavaScript-Laufzeitumgebung