--- title: ': El elemento para pistas de texto incrustado' slug: Web/HTML/Element/track tags: - Accessibility - Contenido HTML insertado - Elemento - HTML - HTML5 - Multimedia - Pistas de texto - Reference - Web - a11y - anotaciones - track translation_of: Web/HTML/Element/track original_slug: Web/HTML/Elemento/track ---
{{HTMLRef}}

El elmento HTML <track> es usado como hijo de los elementos multimedia, {{HTMLElement("audio")}} y {{HTMLElement("video")}}. Este te deja especificar pistas de texto temporizadas (o datos basados en el tiempo), por ejemplo para manejar automáticamente los subtítulos. Las pistas de texto usan el formato WebVTT (archivos .vtt) o de pistas de texto para la web.

{{EmbedInteractiveExample("pages/tabbed/track.html", "tabbed-standard")}}
Categorías del contenido Ninguna
Contenido permitido Ninguno, es un {{Glossary("empty element")}}.
Omision de etiquetas Como es un elemento vacío, la etiqueta de inicio debe estar presente y la etiqueta de cierre no debe estar presente.
Padres permitidos Un elemento multimedia, {{HTMLElement("audio")}} o {{HTMLElement("video")}}.
Rol ARIA implícito No hay rol correspondiente.
Roles ARIA permitidos No hay roles permitidos.
Intefaz DOM {{domxref("HTMLTrackElement")}}

Atributos

Este elemento incluye los atributos globales.

{{htmlattrdef("default")}}
Este atributo indica que esta pista de texto debe estar activada salvo que las preferencias del usuario indiquen que otra pista de texto es más apropiada. Este atributo solo puede ser usado en un elemento track por cada elemento multimedia.
{{htmlattrdef("kind")}}
Este atributo indica como esta pensada para usarse la pista de texto. Si lo omites el valor por defecto es subtitles. If the attribute contiene un valor invalido usará el valor metadata (Las versiones de Chrome anteriores a la 52 tratan un valor inválido como subtitles). Las siguientes palabras clave están permitidas:
{{htmlattrdef("label")}}
Da un título a la pista de texto que puedan entender los usuarios y que es usado por el navegador cuando esta mostrando la lista de pistas de texto disponibles.
{{htmlattrdef("src")}}
Señala la dirección de la pista de texto (archivo .vtt). Debe ser una URL valida. Este atributo debe ser especificado y su URL debe tener el mismo origen que el documento, salvo que el elemento {{HTMLElement("audio")}} o {{HTMLElement("video")}} que sea padre del elemento track tenga un atributo crossorigin.
{{htmlattrdef("srclang")}}
Señala el idioma de los datos de la pista de texto. Debe ser una etiqueta de idioma BCP 47 valida. Si al atributo kind se le da el valor de subtitles, entonces srclang debe ser definido.

Notas de uso

Tipos de datos para pistas de texto

El tipo de dato que el elemento track añade al elemento multimedia es fijado en el atributo kind, que puede tener los valores de subtitles, captions, descriptions, chapters or metadata. El elemento apunta a un archivo fuente que contiene texto temporizado que el navegador muestra cuando el usuario solicita datos adicionales.

Un elemento media no puede tener mas de un elemento track con el mismo valor en los atributos kind, srclang, y label a la vez.

Detectando cambios en las anotaciones

{{page("/es/docs/Web/API/TextTrack/cuechange_event", "En el elemento track")}}

Ejemplos

<video controls poster="/imagenes/ejemplo.gif">
   <source src="ejemplo.mp4" type="video/mp4">
   <source src="ejemplo.ogv" type="video/ogv">
   <track kind="captions" src="captionsDeEjemplo.vtt" srclang="en">
   <track kind="descriptions" src="descripciónDeEjemplo.vtt" srclang="en">
   <track kind="chapters" src="capítulosDeEjemplo.vtt" srclang="en">
   <track kind="subtitles" src="subtítulosDeEjemplo_de.vtt" srclang="de">
   <track kind="subtitles" src="subtítulosDeEjemplo_en.vtt" srclang="en">
   <track kind="subtitles" src="subtítulosDeEjemplo_ja.vtt" srclang="ja">
   <track kind="subtitles" src="subtítulosDeEjemplo_oz.vtt" srclang="oz">
   <track kind="metadata" src="etapaClave1.vtt" srclang="en"
     label="Etapa clave 1">
   <track kind="metadata" src="etapaClave2.vtt" srclang="en"
     label="Etapa clave 2">
   <track kind="metadata" src="etapaClave3.vtt" srclang="en"
     label="Etapa clave 3">
   <!-- Fallback -->
   ...
</video>

Especificaciones

Especificación Estado Comentarios
{{SpecName('HTML WHATWG','embedded-content.html#the-track-element','track element')}} {{Spec2('HTML WHATWG')}}
{{SpecName("HTML5 W3C", "semantics-embedded-content.html#the-track-element", "track element")}} {{Spec2("HTML5 W3C")}} Definición inicial.

Compatibilidad con los navegadores

{{Compat("html.elements.track")}}

Ver también