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

CKTIS / HTML

kind — tipo de pista de texto

El atributo kind del elemento track indica la finalidad de una pista de texto. Si se omite, el valor es subtitles; si es no válido o está vacío, es metadata.

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

Sintaxis

<track kind="subtitles" src="track.vtt" srclang="en">
<track kind="captions" src="track.vtt">
<track kind="descriptions" src="track.vtt">
<track kind="chapters" src="track.vtt">
<track kind="metadata" src="track.vtt">

kind es un atributo enumerado del elemento track, que se usa dentro de audio o video. Indica la finalidad de una pista de texto temporizada externa, no su idioma ni el formato del archivo.

subtitles proporciona una transcripción o traducción de los diálogos; captions también incluye los sonidos y la música relevantes. descriptions ofrece descripciones textuales de los elementos visuales destinadas a la síntesis de voz. chapters proporciona marcas de capítulo para navegar por el contenido multimedia; el navegador puede presentarlas como una lista interactiva. metadata identifica una pista destinada a scripts que el navegador no muestra.

Si se omite kind, el valor es subtitles; un valor no válido, incluido kind="", corresponde a metadata. Este valor alternativo no convierte en válido un valor incorrecto. src es obligatorio; para subtitles, también se requiere srclang con una etiqueta de idioma BCP 47 válida.

El ejemplo compara el valor sin procesar de getAttribute('kind') con el tipo efectivo de la pista de texto en track.track.kind. Establecer kind por sí solo no activa la visualización de subtítulos.

Ejemplos

const track = document.createElement('track');
console.log(track.track.kind);
track.setAttribute('kind', 'captions');
console.log(track.track.kind);
track.setAttribute('kind', 'invalid');
console.log(track.getAttribute('kind'));
console.log(track.track.kind);
track.setAttribute('kind', '');
console.log(track.track.kind);

Resultado

subtitles
captions
invalid
metadata
metadata

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