[e] (0) explain <track label> more.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=10707 git-svn-id: http://svn.whatwg.org/webapps@5548 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Sep 29, 2010 · f27bbe8 · f27bbe8
1 parent f80b559
commit f27bbe8
Show file tree

Hide file tree

Showing 3 changed files with 51 additions and 3 deletions.
diff --git a/complete.html b/complete.html
@@ -24485,7 +24485,9 @@ <h4 id=the-track-element><span class=secno>4.8.9 </span>The <dfn><code>track</co
   </div>
 
   <p>The <dfn id=attr-track-label title=attr-track-label><code>label</code></dfn>
-  attribute gives a user-readable title for the track.</p>
+  attribute gives a user-readable title for the track. This title is
+  used by user agents when listing <a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>subtitle</a>, <a href=#attr-track-kind-captions title=attr-track-kind-captions>caption</a>, and <a href=#attr-track-kind-descriptions title=attr-track-kind-descriptions>audio description</a> tracks
+  in their user interface.</p>
 
   <p>The value of the <code title=attr-track-label><a href=#attr-track-label>label</a></code>
   attribute, if the attribute is present, must not be the empty
@@ -24530,6 +24532,19 @@ <h4 id=the-track-element><span class=secno>4.8.9 </span>The <dfn><code>track</co
 
   </div>
 
+  <div class=example>
+
+   <p>This video has subtitles in several languages:</p>
+
+   <pre>&lt;video src="brave.webm"&gt;
+ &lt;track kind=subtitles src=brave.en.srt srclang=en label="English"&gt;
+ &lt;track kind=captions src=brave.en.srt srclang=en label="English for the Hard of Hearing"&gt;
+ &lt;track kind=subtitles src=brave.fr.srt srclang=fr label="Fran&ccedil;ais"&gt;
+ &lt;track kind=subtitles src=brave.de.srt srclang=de label="Deutsch"&gt;
+&lt;/video&gt;</pre>
+
+  </div>
+
 </div>
 <!--TT-->
 

diff --git a/index b/index
@@ -24465,7 +24465,9 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
   </div>
 
   <p>The <dfn id=attr-track-label title=attr-track-label><code>label</code></dfn>
-  attribute gives a user-readable title for the track.</p>
+  attribute gives a user-readable title for the track. This title is
+  used by user agents when listing <a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>subtitle</a>, <a href=#attr-track-kind-captions title=attr-track-kind-captions>caption</a>, and <a href=#attr-track-kind-descriptions title=attr-track-kind-descriptions>audio description</a> tracks
+  in their user interface.</p>
 
   <p>The value of the <code title=attr-track-label><a href=#attr-track-label>label</a></code>
   attribute, if the attribute is present, must not be the empty
@@ -24510,6 +24512,19 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
 
   </div>
 
+  <div class=example>
+
+   <p>This video has subtitles in several languages:</p>
+
+   <pre>&lt;video src="brave.webm"&gt;
+ &lt;track kind=subtitles src=brave.en.srt srclang=en label="English"&gt;
+ &lt;track kind=captions src=brave.en.srt srclang=en label="English for the Hard of Hearing"&gt;
+ &lt;track kind=subtitles src=brave.fr.srt srclang=fr label="Fran&ccedil;ais"&gt;
+ &lt;track kind=subtitles src=brave.de.srt srclang=de label="Deutsch"&gt;
+&lt;/video&gt;</pre>
+
+  </div>
+
 </div>
 <!--TT-->
 

diff --git a/source b/source
@@ -26318,7 +26318,12 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
   </div>
 
   <p>The <dfn title="attr-track-label"><code>label</code></dfn>
-  attribute gives a user-readable title for the track.</p>
+  attribute gives a user-readable title for the track. This title is
+  used by user agents when listing <span
+  title="attr-track-kind-subtitles">subtitle</span>, <span
+  title="attr-track-kind-captions">caption</span>, and <span
+  title="attr-track-kind-descriptions">audio description</span> tracks
+  in their user interface.</p>
 
   <p>The value of the <code title="attr-track-label">label</code>
   attribute, if the attribute is present, must not be the empty
@@ -26371,6 +26376,19 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
 
   </div>
 
+  <div class="example">
+
+   <p>This video has subtitles in several languages:</p>
+
+   <pre>&lt;video src="brave.webm">
+ &lt;track kind=subtitles src=brave.en.srt srclang=en label="English">
+ &lt;track kind=captions src=brave.en.srt srclang=en label="English for the Hard of Hearing">
+ &lt;track kind=subtitles src=brave.fr.srt srclang=fr label="Fran&ccedil;ais">
+ &lt;track kind=subtitles src=brave.de.srt srclang=de label="Deutsch">
+&lt;/video></pre>
+
+  </div>
+
 </div>
 <!--START w3c-html--><!--TT-->