TextTrack: evento cuechange
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
donde esta siendo mostrado, si lo hay.
Burbujas | No |
---|---|
Cancelable | No |
Interfaz | Event |
Propiedad del controlador de eventos | GlobalEventHandlers.oncuechange |
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
:
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
.
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
Specification |
---|
HTML Standard # event-media-cuechange |
HTML Standard # handler-texttrack-oncuechange |
Compatibilidad con navegadores
BCD tables only load in the browser