Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

track — pistas de texto sincronizadas

El elemento track añade a audio o vídeo una pista de texto externa sincronizada en el tiempo, como subtítulos de diálogo, subtítulos que incluyen información sobre sonidos o metadatos. Por sí solo, no crea un elemento visible independiente.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<video controls src="movie.webm">
  <track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>

track es un elemento hijo directo de audio o video. Se coloca después de los posibles elementos source y antes del contenido alternativo. Es un elemento vacío: no tiene contenido ni etiqueta de cierre. El atributo obligatorio src apunta a los datos de la pista, normalmente en formato WebVTT.

kind distingue subtitles (diálogo), captions (diálogo y sonidos relevantes), descriptions (descripciones visuales destinadas a la síntesis de voz), chapters (metadatos de capítulos) y metadata (datos para scripts). Si se omite kind, el valor es subtitles; un valor no válido significa metadata.

srclang es una etiqueta de idioma BCP 47, obligatoria para subtitles. label es un nombre destinado a los usuarios y no debe estar vacío cuando se incluye. El atributo booleano default sugiere activar la pista, aunque las preferencias del usuario pueden prevalecer. Para un mismo elemento multimedia, como máximo una pista del grupo combinado subtitles y captions puede tener default.

En el DOM, element.track expone un objeto TextTrack, no un elemento HTML. El ejemplo lee sus propiedades sin reproducir el contenido multimedia; no comprueba la carga de cues ni la visualización de subtítulos.

Ejemplos

<!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>

Resultado

TRACK | captions | en | English

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes