CKTIS / HTML
track — tijdgebonden tekstsporen
Het element track koppelt een extern, op de tijdlijn afgestemd tekstspoor aan audio of video, zoals dialoogondertitels, ondertitels met informatie over geluiden of metadata. Op zichzelf maakt het geen afzonderlijk zichtbaar element aan.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<video controls src="movie.webm">
<track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>track is een direct kind van audio of video. Het staat na eventuele source-elementen en vóór terugvalinhoud. Het is een leeg element: het heeft geen inhoud en geen eindtag. Het verplichte src verwijst naar de spoorgegevens, meestal in WebVTT-formaat.
kind maakt onderscheid tussen subtitles (dialoog), captions (dialoog en relevante geluiden), descriptions (visuele beschrijvingen bedoeld voor spraaksynthese), chapters (hoofdstukmetadata) en metadata (gegevens voor scripts). Als kind ontbreekt, geldt subtitles; een ongeldige waarde betekent metadata.
srclang is een BCP 47-taaltag en is verplicht voor subtitles. label is een naam voor gebruikers en mag niet leeg zijn als deze is opgegeven. Het booleaanse attribuut default stelt voor het spoor in te schakelen, maar gebruikersvoorkeuren kunnen voorgaan. Voor één media-element mag hoogstens één spoor uit de gecombineerde groep subtitles en captions default hebben.
In de DOM geeft element.track toegang tot een TextTrack-object, niet tot een HTML-element. Het voorbeeld leest de eigenschappen ervan uit zonder media af te spelen; het test niet of cues worden geladen of ondertitels worden weergegeven.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Track inspection</title>
<video>
<track id="captions" kind="captions" srclang="en" label="English" src="data:text/vtt,WEBVTT%0A%0A00%3A00%3A00.000%20--%3E%2000%3A00%3A02.000%0AHello.%0A">
</video>
<pre id="result"></pre>
<script>
const element = document.getElementById('captions');
document.getElementById('result').textContent = [
element.tagName,
element.track.kind,
element.track.language,
element.track.label
].join(' | ');
</script>
</html>Resultaat
TRACK | captions | en | English
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.