TextTrack: evento cuechange

El evento cuechange se activa cuando un TextTrack ha cambiado las anotaciones que se estan mostrando. El evento es activado tanto en TextTrack y en el HTMLTrackElement (en-US) donde esta siendo mostrado, si lo hay.

Burbujas No
Cancelable No
Interfaz Event
Propiedad del controlador de eventos GlobalEventHandlers.oncuechange (en-US)

Ejemplos

En el TextTrack

Tu puedes preparar una escucha para el evento cuechange en un TextTrack usando el método addEventListener():

track.addEventListener('cuechange', function () {
  let cues = track.activeCues;  // array de las anotaciones actuales
});

O puedes solo preparar la propiedad del controlador de eventos oncuechange (en-US):

track.oncuechange = function () {
  let cues = track.activeCues; // array of current cues
}

En el elemento track

El subyacente TextTrack, indicado por la propiedad track, recive un evento  cuechange cada vez que la anotación que esta siendo actualmente presentada cambia. Est sucede incluso si la pista de texto no está asociada cun un elemento multimedia.

Si la pista de texto está asociada con el elemento multimedia, usando el elemento <track> como hijo del elemento <audio> o del elemento <video>, el evento cuechange es también enviado al HTMLTrackElement (en-US).

let textTrackElem = document.getElementById("texttrack");

textTrackElem.addEventListener("cuechange", (event) => {
  let cues = event.target.track.activeCues;
});

Además, puedes utilizar el controlador de eventos oncuechange:

let textTrackElem = document.getElementById("texttrack");

textTrackElem.oncuechange = (event) => {
  let cues = event.target.track.activeCues;
});

Especificaciones

Especificación Estado
HTML Living Standard
La definición de 'cuechange' en esta especificación.
Living Standard

Compatibilidad de los navegadores

BCD tables only load in the browser

Ver también