The cuechange
event fires when a TextTrack
has changed the currently displaying cues. The event is fired on both the TextTrack
and the HTMLTrackElement
in which it's being presented, if any.
HTMLTrackElement: cuechange event
Syntax
Use the event name in methods like addEventListener()
, or set an event handler property.
addEventListener('cuechange', event => { }) oncuechange = event => { }
Event type
A generic Event
with no added properties.
Examples
The underlying TextTrack
, indicated by the track
property, receives a cuechange
event every time the currently-presented cue is changed. This happens even if the track isn't associated with a media element.
If the track is associated with a media element, using the <track>
element as a child of the <audio>
or <video>
element, the cuechange
event is also sent to the HTMLTrackElement
.
let textTrackElem = document.getElementById("texttrack"); textTrackElem.addEventListener("cuechange", event => { let cues = event.target.track.activeCues; });
Alternatively, you can use the oncuechange
event handler:
let textTrackElem = document.getElementById("texttrack"); textTrackElem.oncuechange = event => { let cues = event.target.track.activeCues; });
Specifications
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
cuechange_event |
32
23
The
oncuechange event handler property is not supported.
|
14
|
68
|
No
|
19
15
The
oncuechange event handler property is not supported.
12-15
|
10
6
The
oncuechange event handler property is not supported.
|
≤37
The
oncuechange event handler property is not supported.
4.4.3
|
32
25
The
oncuechange event handler property is not supported.
|
68
|
19
14
The
oncuechange event handler property is not supported.
12-14
|
10
6
The
oncuechange event handler property is not supported.
|
2.0
1.5
The
oncuechange event handler property is not supported.
|
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLTrackElement/cuechange_event