Baseline Widely available
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.
WertEin 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.
Wir beginnen mit einem <video>
, das mehrere <track>
- Kinder hat.
<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.
const tracks = document.querySelector("video").textTracks;
for (const track of tracks) {
if (track.language === "en") {
console.dir(track);
}
}
Spezifikationen Browser-Kompatibilität Siehe auch
HTMLMediaElement
: Schnittstelle zur Definition der HTMLMediaElement.textTracks
-Eigenschaft<audio>
, <video>
AudioTrack
, AudioTrackList
VideoTrack
, VideoTrackList
addtrack
, change
, removetrack
: AudioTrackList-Ereignisseaddtrack
, change
, removetrack
: VideoTrackList-EreignisseRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4