HTMLMediaElement: textTracks-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die schreibgeschützte textTracks-Eigenschaft von HTMLMediaElement-Objekten gibt ein TextTrackList-Objekt zurück, das alle TextTrack-Objekte auflistet, die die Textspuren des Media-Elements darstellen, in der gleichen Reihenfolge wie in der Liste der Textspuren.
Sie können erkennen, wann Spuren zu einem <audio>- oder <video>-Element hinzugefügt oder daraus entfernt werden, indem Sie die addtrack- und removetrack-Ereignisse verwenden. Diese Ereignisse werden jedoch nicht direkt an das Media-Element selbst gesendet. Stattdessen werden sie an das Spurenlistenobjekt des HTMLMediaElement gesendet, das dem Typ der Spur entspricht, die zum Element hinzugefügt wurde.
Die zurückgegebene Liste ist live; das heißt, während Spuren zum Media-Element hinzugefügt oder daraus entfernt werden, ändert sich der Inhalt der Liste dynamisch. Sobald Sie eine Referenz zur Liste haben, können Sie sie auf Änderungen überwachen, um zu erkennen, wann neue Textspuren hinzugefügt werden oder vorhandene entfernt werden.
Sehen Sie sich TextTrackList-Ereignisse an, um mehr darüber zu erfahren, wie Sie Änderungen an der Spurenliste eines Media-Elements überwachen können.
Wert
Ein TextTrackList-Objekt, das die Liste der in das Media-Element aufgenommenen Textspuren darstellt. Die Liste der Spuren kann mit textTracks[n] zugegriffen werden, um die n-te Textspur aus der Objektsliste der Textspuren zu erhalten, oder durch die Verwendung der textTracks.getTrackById()-Methode.
Jede Spur wird durch ein TextTrack-Objekt dargestellt, das Informationen über die Spur bereitstellt.
Beispiele
Wir beginnen mit einem
<video>, das
mehrere <track>
Kinder hat.
<video controls>
<source src="/shared-assets/videos/sintel-short.webm" type="video/webm" />
<source src="/shared-assets/videos/sintel-short.mp4" type="video/mp4" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-en.vtt"
srclang="en"
label="English" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-de.vtt"
srclang="de"
label="Deutsch" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-es.vtt"
srclang="es"
label="Español" />
</video>
HTMLMediaElement.textTracks gibt eine TextTrackList zurück, durch die wir iterieren können. Hier stellen wir sicher, dass alle drei Spuren gleichzeitig angezeigt werden.
const tracks = document.querySelector("video").textTracks;
for (const track of tracks) {
track.mode = "showing";
}
Spezifikationen
| Specification |
|---|
| HTML # dom-media-texttracks-dev |
Browser-Kompatibilität
Loading…
Siehe auch
HTMLMediaElement: Schnittstelle zur Definition derHTMLMediaElement.textTracks-Eigenschaft<audio>,<video>AudioTrack,AudioTrackListVideoTrack,VideoTrackListaddtrack,change,removetrack: AudioTrackList-Ereignisseaddtrack,change,removetrack: VideoTrackList-Ereignisse