activeCues

Summary

Returns the text track cues from the text track list of cues that are currently active (i.e. that start before the current playback position and end after it), as a TextTrackCueList object.

Property of apis/audio-video/TextTrack apis/audio-video/TextTrack

Syntax

Note: This property is read-only.

var result = TextTrack.activeCues;

Return Value

Returns an object of type DOM NodeDOM Node

Examples

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>activeCues example</title>

    <script type="text/javascript">
        // don't add this listener until all DOM content is loaded
        document.addEventListener("DOMContentLoaded", function () {
            var track = document.getElementById("track1");
            track.addEventListener("cuechange", function () {
                var myTrack = this.track;
                var myCues = myTrack.activeCues;      // array of current cues.
                //  display the start and end time, and cue text
                if (myCues.length > 0) {
                    var disp = document.getElementById("display");
                    disp.innerHTML = myCues[0].startTime + " --> " + myCues[0].endTime + "  " + myCues[0].getCueAsHTML().textContent;
                }
            }, false);
        }, false);
    </script>
</head>
<body>
    <video id="video1" controls>
        <source src="video.mp4">
        <track id="track1" label="English subtitles" kind="captions" src="entrack.vtt" srclang="en" default>
        HTML5 video is not supported
    </video>
    <div id="display"></div>
</body>
<</html>

Related specifications

W3C HTML5 Specification: W3C Editor’s Draft

Attributions

Microsoft Developer Network: Windows Internet Explorer API reference Article