cues

Summary

Returns the text track list of cues, as a TextTrackCueList object.

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

Syntax

Note: This property is read-only.

var result = TextTrack.cues;

Return Value

Returns an object of type DOM NodeDOM Node

Examples

<!DOCTYPE HTML>
<html>
<head>
    <title>Get track example</title>
</head>
<body>
    <h1>Get track example</h1>
    <video id="video1" controls>
        <source src="http://ie.microsoft.com/testdrive/Videos/BehindIE9ModernWebStandards/Video.mp4">
        <track id="entrack" label="English subtitles" kind="captions" src="entrack.vtt" srclang="en" default>
    </video>
    <p>
        <button id="mybutton">Show tracks</button>
    </p>
    <div style="display:block; overflow:auto; height:200px; width:650px;" id="display"></div>

    <script>
      document.getElementById("mybutton").addEventListener("click", function () {
        var myTrack = document.getElementById("entrack").track; // get text track from track element
        var myCues = myTrack.cues;   // get list of cues
        for (var i = 0; i < myCues.length; i++) {
        // append track label
        document.getElementById("display").innerHTML += (myCues[i].getCueAsHTML().textContent + "<br/>");
        }
     }, false);
    </script>
</body>
</html>

Related specifications

W3C HTML5 Specification: W3C Editor’s Draft

Attributions

Microsoft Developer Network: Windows Internet Explorer API reference Article