label attribute | label property

Gets or sets the label attribute to create a user readable title for a text track.

This property is read/write.

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



<element label="sLabeltext" ... >


object.label = sLabeltext
sLabeltext = object.label


Property values

Type: string

A string that can be used to identify or title a timed text track.

Standards information


A label can be any identifying string. This string is displayed in the HTML5 video player. This example shows thelabels for "Spanish", "German", or "English" in the player:

    <video id="video1" controls autoplay loop>
      <source src="" type="video/mp4" >
      <track id="enTrack" src="entrack.vtt" label="English" kind="subtitles" srclang="en" default> 
      <track id="esTrack" src="estrack.vtt" label="Spanish" kind="subtitles" srclang="es">
      <track id="deTrack" src="detrack.vtt" label="German" kind="subtitles" srclang="de">
      HTML5 video not supported

This property is not implemented for AudioTrack.

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.


This example gets a TextTrackList from a video element, and displays the label assigned to each track.

  <h1>Show tracks example</h1>
  <video id="video1" controls  >
    <source src="">
    <track id="entrack" label="English subtitles" kind="captions" src="entrack.vtt" srclang="en" default>
    <track id="sptrack" label="Spanish subtitles" kind="captions" src="estrack.vtt" srclang="es">
    <track id="detrack" label="German subtitles" kind="captions" src="detrack.vtt" srclang="de">
  <br />
  <button id="gettracks" >View text tracks</button>
  <div id="display"></div>

    document.getElementById("gettracks").addEventListener("click", function () {
      var display = document.getElementById("display");
      display.innerHTML = "";
      var mytracks = document.getElementById("video1").textTracks;  //  get the textTrackList
      for (var i = 0; i < mytracks.length; i++) {
        display.innerHTML += (mytracks[i].label + "<br/>");  //append track label to inner text of <div>
    }, false);

See also

track element
track object
Make your videos accessible with Timed Text Tracks



© 2014 Microsoft