--- title: slug: Web/HTML/Element/track tags: - Element - HTML - HTML embedded content - HTML5 - Multimedia - Reference - Web translation_of: Web/HTML/Element/track ---

L'element HTML <track> s'utilitza com un fill dels elements de mitjans - {{HTMLElement("audio")}} i {{HTMLElement("video")}}. Se li permet especificar pistes de text temporitzat (o dades basades en el temps), per exemple per gestionar automàticament els subtítols. Les pistes estan formatades en format WebVTT (arxius .vtt) - Web Video Text Tracks.

El tipus de dades que track afegeix al mitjà s'estableix en l'atribut Kind, que pot prendre els valors de subtitles, captions, descriptions, chapters o metadata. L'element apunta a un arxiu d'origen que conté text temporitzat que l'explorador exposa quan l'usuari sol·licita dades addicionals.

Un element de mitjans no pot tenir més d'un track amb el mateix kind, srclang i label.

Context d'ùs

Categories de contingut Cap
Contingut permès Cap, es un {{Glossary("empty element")}}.
Omissió de l'etiqueta Ja que és un element buit, l'etiqueta d'inici ha d'estar present i l'etiqueta final no ha d'estar present.
Elements pares permesos Un element de mitjans, abans de qualsevol contingut dinàmic.
Normativa del document HTML5, secció 4.8.9

Atributs

Aquest element inclou els atributs globals.

{{htmlattrdef("default")}}
Aquest atribut indica que la pista ha d'estar habilitada llevat que les preferències de l'usuari indiquin que una altra pista és més apropiada. Això només es pot utilitzar en un element track per cada element de mitjans.
{{htmlattrdef("kind")}}
Com s'utilitza la pista (track) de text. Si s'omet kind, per defecte és subtitles. Si l'atribut no està present, s'utilitzen els subtitles. Si l'atribut conté un valor no vàlid, s'utilitzarà metadata. (Les versions de Chrome anterios a la 52 tracta un valor no vàlid com subtitles.) Es permeten les següents paraules clau:
{{htmlattrdef("label")}}
Un títol llegible per l'usuari de la pista de text que és utilitzada pel navegador quan s'enumeren les pistes de text disponibles.
{{htmlattrdef("src")}}
Direcció de la pista (arxiu .vtt). Ha de ser un URL vàlid. Aquest atribut s'ha de definir.
{{htmlattrdef("srclang")}}
Idioma de les dades de text de la pista. Ha de ser una etiqueta d'idioma BCP 47 vàlida. Si s'estableix l'atribut kind en els subtitles, llavors srclang ha de ser definit.

Interfície DOM

Aquest element implementa la interfície {{domxref("HTMLTrackElement")}}.

Exemples

<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">
   <!-- Fallback -->
   ...
</video>

Especificacions

Especificació Estat Comentari
{{SpecName("HTML5 W3C", "embedded-content-0.html#the-track-element", "<track>")}} {{Spec2("HTML5 W3C")}} Definció incial.

{{CompatibilityTable}}

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suport bàsic 23 {{CompatGeckoDesktop(24)}}[2] 10 12.10 6
atribut src ajustable {{CompatUnknown}} {{CompatGeckoDesktop(50)}}[3] {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
Valor kind no vàlid com metadata {{CompatNo}} {{CompatNo}} {{CompatNo}} {{CompatNo}} {{CompatNo}}
Característica Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suport bàsic 25[1] {{CompatGeckoMobile(24)}}[2] {{CompatNo}} {{CompatNo}} {{CompatNo}}
atribut src ajustable {{CompatUnknown}} {{CompatGeckoMobile(50)}}[3] {{CompatNo}} {{CompatNo}} {{CompatNo}}
Valor kind no vàlid com metadata {{CompatNo}} {{CompatNo}} {{CompatNo}} {{CompatNo}} {{CompatNo}}

[1]En Chrome per Android, l'element <track> encara no funciona per vídeo a pantalla completa .

[2] L'element <track>, la interfície {{domxref("HTMLTrackElement")}}, i les API associades es van dur a terme en Firefox 24 darrere de la preferència {{pref("media.webvtt.enabled")}}, està desactivat per defecte . Per habilitar el suport WebVTT, establir aquesta preferència en true. WebVTT està activat per defecte a partir del Firefox 31 i es pot desactivar establint la preferència a false.

[3] Fins a Firefox 50, l'atribut {{htmlattrxref ("src")}}  és configurable, però el canvi no aconsegueix manejar-ho adequadament. A partir de Firefox 50, les dades de pista existents s'eliminen correctament, les noves dades de pista es carreguen i es posen en execució, i així successivament.

Veure

{{HTMLRef}}