cues property

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

This property is read-only.

HTML5 A vocabulary and associated APIs for HTML and XHTMLInternet Explorer 10



cuelist = object.cues


Property values

Type: TextTrackCueList

A TextTrackCueList object that represents a list of cues.

Standards information


The following example gets the TextTrackCueList from a video element and displays all the text cues using the cues property.

Note  To create timed text files in both Web Video Text Track (WebVTT) and Timed Text Markup Language (TTML) formats, see HTML5 Video Caption Maker on the Windows Internet Explorer test drive site.


<!DOCTYPE html >
<html >
    <title>Get track example</title>
    <h1>Get track example</h1>
    <video id="video1" controls  >
      <source src="">
      <track id="entrack" label="English subtitles" kind="captions" src="entrack.vtt" srclang="en" default>
    <button id="mybutton">Show tracks</button>
    <div style="display:block; overflow:auto; height:200px; width:650px;" id="display"></div>
      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);

See also

Make your videos accessible with Timed Text Tracks