HTMLTrackElement : évènement cuechange
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2019.
L'évènement cuechange de l'interface HTMLTrackElement est déclenché lorsqu'un TextTrack a modifié les repères actuellement affichés. L'évènement est déclenché à la fois sur le TextTrack et sur le HTMLTrackElement dans lequel il est présenté, le cas échéant.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.
addEventListener("cuechange", (event) => { })
oncuechange = (event) => { }
Type d'évènement
Un objet Event générique sans propriété supplémentaire.
Exemples
Le TextTrack sous-jacent, indiqué par la propriété track, reçoit un évènement cuechange chaque fois que le repère actuellement présenté est modifié. Cela se produit même si la piste n'est pas associée à un élément média.
Si la piste est associée à un élément média, en utilisant l'élément HTML <track> comme enfant de l'élément HTML <audio> ou <video>, l'évènement cuechange est également envoyé au HTMLTrackElement.
let textTrackElem = document.getElementById("text-track");
textTrackElem.addEventListener("cuechange", (event) => {
let cues = event.target.track.activeCues;
});
Vous pouvez également utiliser le gestionnaire d'évènement oncuechange :
let textTrackElem = document.getElementById("text-track");
textTrackElem.oncuechange = (event) => {
let cues = event.target.track.activeCues;
};
Spécifications
| Specification |
|---|
| HTML # event-media-cuechange |
| HTML # handler-oncuechange |