HTMLMediaElement: textTracks-Eigenschaft

Die schreibgeschützte textTracks Eigenschaft von HTMLMediaElement-Objekten gibt ein TextTrackList-Objekt zurück, das alle TextTrack Objekte auflistet, die die Textspuren des Medienelements darstellen, in derselben Reihenfolge wie in der Liste der Textspuren.

Sie können erkennen, wann Spuren zu einem <audio>- oder <video>-Element hinzugefügt oder entfernt werden, indem Sie die addtrack- und removetrack-Ereignisse verwenden. Diese Ereignisse werden jedoch nicht direkt an das Medienelement selbst gesendet. Stattdessen werden sie an das Tracklisten-Objekt des entsprechenden HTMLMediaElement gesendet, das zum Typ der hinzugefügten Spur passt.

Die zurückgegebene Liste ist live; das heißt, während Spuren zum Medienelement hinzugefügt oder daraus entfernt werden, ändert sich der Inhalt der Liste dynamisch. Sobald Sie eine Referenz auf die Liste haben, können Sie sie überwachen, um Veränderungen zu erkennen, wenn neue Textspuren hinzugefügt oder bestehende entfernt werden.

Siehe TextTrackList-Ereignisse, um mehr darüber zu erfahren, wie Sie Veränderungen in der Spurenliste eines Medienelements beobachten können.

Wert

Ein TextTrackList-Objekt, das die Liste der im Medienelement enthaltenen Textspuren darstellt. Auf die Liste der Spuren kann mithilfe von textTracks[n] zugegriffen werden, um die n-te Textspur aus der Spurenliste des Objekts zu erhalten, oder mithilfe der textTracks.getTrackById()-Methode.

Jede Spur wird durch ein TextTrack-Objekt repräsentiert, das Informationen über die Spur bereitstellt.

Beispiele

Wir beginnen mit einem <video>, das mehrere <track>- Kinder hat.

html
<video controls poster="/images/sample.gif">
  <source src="sample.mp4" type="video/mp4" />
  <source src="sample.ogv" type="video/ogv" />
  <track kind="captions" src="sampleCaptions.vtt" srclang="en" />
  <track kind="descriptions" src="sampleDescriptions.vtt" srclang="en" />
  <track kind="chapters" src="sampleChapters.vtt" srclang="en" />
  <track kind="subtitles" src="sampleSubtitles_de.vtt" srclang="de" />
  <track kind="subtitles" src="sampleSubtitles_en.vtt" srclang="en" />
  <track kind="subtitles" src="sampleSubtitles_ja.vtt" srclang="ja" />
  <track kind="subtitles" src="sampleSubtitles_oz.vtt" srclang="oz" />
  <track kind="metadata" src="keyStage1.vtt" srclang="en" label="Key Stage 1" />
  <track kind="metadata" src="keyStage2.vtt" srclang="en" label="Key Stage 2" />
  <track kind="metadata" src="keyStage3.vtt" srclang="en" label="Key Stage 3" />
</video>

HTMLMediaElement.textTracks gibt eine textTracksList zurück, durch die wir iterieren können. Hier drucken wir alle Eigenschaften jedes englischen Tracks in die Konsole.

js
const tracks = document.querySelector("video").textTracks;

for (const track of tracks) {
  if (track.language === "en") {
    console.dir(track);
  }
}

Spezifikationen

Specification
HTML
# dom-media-texttracks-dev

Browser-Kompatibilität

Siehe auch