[html5] r7149 - [giow] (0) Make TextTrack.label not expose the UA-specific label if one is being [...]
whatwg at whatwg.org
whatwg at whatwg.org
Wed Jun 27 14:23:22 PDT 2012
Author: ianh
Date: 2012-06-27 14:23:20 -0700 (Wed, 27 Jun 2012)
New Revision: 7149
Modified:
complete.html
index
source
Log:
[giow] (0) Make TextTrack.label not expose the UA-specific label if one is being used.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=15951
Affected topics: HTML, Video Text Tracks
Modified: complete.html
===================================================================
--- complete.html 2012-06-26 22:12:31 UTC (rev 7148)
+++ complete.html 2012-06-27 21:23:20 UTC (rev 7149)
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 26 June 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 27 June 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -28209,9 +28209,7 @@
<p>If the element has a <code title=attr-track-label><a href=#attr-track-label>label</a></code>
attribute whose value is not the empty string, then the element's
<dfn id=track-label>track label</dfn> is the value of the attribute. Otherwise, the
- element's <a href=#track-label>track label</a> is a user-agent defined string
- (e.g. the string "untitled" in the user's locale, or a value
- automatically generated from the other attributes).</p>
+ element's <a href=#track-label>track label</a> is an empty string.</p>
</div>
@@ -32686,15 +32684,18 @@
<dd>
<p>This is a human-readable string intended to identify the track
- for the user. In certain cases, the label might be generated
- automatically.</p>
+ for the user.</p>
<p>The <a href=#text-track-label title="text track label">label of a track</a> can
change dynamically, in the case of a <a href=#text-track>text track</a>
- corresponding to a <code><a href=#the-track-element>track</a></code> element or in the case of an
- automatically-generated label whose value depends on variable
- factors such as the user's preferred user interface language.</p>
+ corresponding to a <code><a href=#the-track-element>track</a></code> element.</p>
+ <p>When a <a href=#text-track-label>text track label</a> is the empty string, the
+ user agent should automatically generate an appropriate label from
+ the text track's other properties (e.g. the kind of text track and
+ the text track's language) for use in its user interface. This
+ automatically-generated label is not exposed in the API.</p>
+
</dd>
<dt><dfn id=text-track-language title="text track language">A language</dfn>
@@ -33134,11 +33135,13 @@
object. The <a href=#text-track>text track</a> is a
<a href=#media-resource-specific-text-track>media-resource-specific text track</a>.</li>
- <li><p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-kind title="text track
- kind">kind</a>, <a href=#text-track-label title="text track label">label</a>,
- and <a href=#text-track-language title="text track language">language</a> based on the
- semantics of the relevant data, as defined by the relevant
- specification.</li>
+ <li><p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-kind title="text
+ track kind">kind</a>, <a href=#text-track-label title="text track
+ label">label</a>, and <a href=#text-track-language title="text track
+ language">language</a> based on the semantics of the relevant
+ data, as defined by the relevant specification. If there is no
+ label in that data, then the <a href=#text-track-label title="text track
+ label">label</a> must be set to the empty string.</li>
<li><p>Populate the new <a href=#text-track>text track</a>'s <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a> with the cues
parsed so far, folllowing the <a href=#guidelines-for-exposing-cues-in-various-formats-as-text-track-cues>guidelines for exposing
@@ -33646,7 +33649,10 @@
<dt><var title="">textTrack</var> . <code title=dom-TextTrack-label><a href=#dom-texttrack-label>label</a></code></dt>
<dd>
- <p>Returns the <a href=#text-track-label>text track label</a>.</p>
+ <p>Returns the <a href=#text-track-label>text track label</a>, if there is one, or
+ the empty string otherwise (indicating that a custom label
+ probably needs to be generated from the other attributes of the
+ object if the object is exposed to the user).</p>
</dd>
<dt><var title="">textTrack</var> . <code title=dom-TextTrack-language><a href=#dom-texttrack-language>language</a></code></dt>
Modified: index
===================================================================
--- index 2012-06-26 22:12:31 UTC (rev 7148)
+++ index 2012-06-27 21:23:20 UTC (rev 7149)
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 26 June 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 27 June 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -28209,9 +28209,7 @@
<p>If the element has a <code title=attr-track-label><a href=#attr-track-label>label</a></code>
attribute whose value is not the empty string, then the element's
<dfn id=track-label>track label</dfn> is the value of the attribute. Otherwise, the
- element's <a href=#track-label>track label</a> is a user-agent defined string
- (e.g. the string "untitled" in the user's locale, or a value
- automatically generated from the other attributes).</p>
+ element's <a href=#track-label>track label</a> is an empty string.</p>
</div>
@@ -32686,15 +32684,18 @@
<dd>
<p>This is a human-readable string intended to identify the track
- for the user. In certain cases, the label might be generated
- automatically.</p>
+ for the user.</p>
<p>The <a href=#text-track-label title="text track label">label of a track</a> can
change dynamically, in the case of a <a href=#text-track>text track</a>
- corresponding to a <code><a href=#the-track-element>track</a></code> element or in the case of an
- automatically-generated label whose value depends on variable
- factors such as the user's preferred user interface language.</p>
+ corresponding to a <code><a href=#the-track-element>track</a></code> element.</p>
+ <p>When a <a href=#text-track-label>text track label</a> is the empty string, the
+ user agent should automatically generate an appropriate label from
+ the text track's other properties (e.g. the kind of text track and
+ the text track's language) for use in its user interface. This
+ automatically-generated label is not exposed in the API.</p>
+
</dd>
<dt><dfn id=text-track-language title="text track language">A language</dfn>
@@ -33134,11 +33135,13 @@
object. The <a href=#text-track>text track</a> is a
<a href=#media-resource-specific-text-track>media-resource-specific text track</a>.</li>
- <li><p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-kind title="text track
- kind">kind</a>, <a href=#text-track-label title="text track label">label</a>,
- and <a href=#text-track-language title="text track language">language</a> based on the
- semantics of the relevant data, as defined by the relevant
- specification.</li>
+ <li><p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-kind title="text
+ track kind">kind</a>, <a href=#text-track-label title="text track
+ label">label</a>, and <a href=#text-track-language title="text track
+ language">language</a> based on the semantics of the relevant
+ data, as defined by the relevant specification. If there is no
+ label in that data, then the <a href=#text-track-label title="text track
+ label">label</a> must be set to the empty string.</li>
<li><p>Populate the new <a href=#text-track>text track</a>'s <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a> with the cues
parsed so far, folllowing the <a href=#guidelines-for-exposing-cues-in-various-formats-as-text-track-cues>guidelines for exposing
@@ -33646,7 +33649,10 @@
<dt><var title="">textTrack</var> . <code title=dom-TextTrack-label><a href=#dom-texttrack-label>label</a></code></dt>
<dd>
- <p>Returns the <a href=#text-track-label>text track label</a>.</p>
+ <p>Returns the <a href=#text-track-label>text track label</a>, if there is one, or
+ the empty string otherwise (indicating that a custom label
+ probably needs to be generated from the other attributes of the
+ object if the object is exposed to the user).</p>
</dd>
<dt><var title="">textTrack</var> . <code title=dom-TextTrack-language><a href=#dom-texttrack-language>language</a></code></dt>
Modified: source
===================================================================
--- source 2012-06-26 22:12:31 UTC (rev 7148)
+++ source 2012-06-27 21:23:20 UTC (rev 7149)
@@ -30472,9 +30472,7 @@
<p>If the element has a <code title="attr-track-label">label</code>
attribute whose value is not the empty string, then the element's
<dfn>track label</dfn> is the value of the attribute. Otherwise, the
- element's <span>track label</span> is a user-agent defined string
- (e.g. the string "untitled" in the user's locale, or a value
- automatically generated from the other attributes).</p>
+ element's <span>track label</span> is an empty string.</p>
</div>
@@ -35763,15 +35761,18 @@
<dd>
<p>This is a human-readable string intended to identify the track
- for the user. In certain cases, the label might be generated
- automatically.</p>
+ for the user.</p>
<p>The <span title="text track label">label of a track</span> can
change dynamically, in the case of a <span>text track</span>
- corresponding to a <code>track</code> element or in the case of an
- automatically-generated label whose value depends on variable
- factors such as the user's preferred user interface language.</p>
+ corresponding to a <code>track</code> element.</p>
+ <p>When a <span>text track label</span> is the empty string, the
+ user agent should automatically generate an appropriate label from
+ the text track's other properties (e.g. the kind of text track and
+ the text track's language) for use in its user interface. This
+ automatically-generated label is not exposed in the API.</p>
+
</dd>
<dt><dfn title="text track language">A language</dfn>
@@ -36255,11 +36256,13 @@
object. The <span>text track</span> is a
<span>media-resource-specific text track</span>.</p></li>
- <li><p>Set the new <span>text track</span>'s <span title="text track
- kind">kind</span>, <span title="text track label">label</span>,
- and <span title="text track language">language</span> based on the
- semantics of the relevant data, as defined by the relevant
- specification.</p></li>
+ <li><p>Set the new <span>text track</span>'s <span title="text
+ track kind">kind</span>, <span title="text track
+ label">label</span>, and <span title="text track
+ language">language</span> based on the semantics of the relevant
+ data, as defined by the relevant specification. If there is no
+ label in that data, then the <span title="text track
+ label">label</span> must be set to the empty string.</p></li>
<li><p>Populate the new <span>text track</span>'s <span
title="text track list of cues">list of cues</span> with the cues
@@ -36844,7 +36847,10 @@
<dt><var title="">textTrack</var> . <code title="dom-TextTrack-label">label</code></dt>
<dd>
- <p>Returns the <span>text track label</span>.</p>
+ <p>Returns the <span>text track label</span>, if there is one, or
+ the empty string otherwise (indicating that a custom label
+ probably needs to be generated from the other attributes of the
+ object if the object is exposed to the user).</p>
</dd>
<dt><var title="">textTrack</var> . <code title="dom-TextTrack-language">language</code></dt>
More information about the Commit-Watchers
mailing list