[html5] r7330 - [giow] (1) Change TextTrackCue.line to expose the raw value rather than the comp [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Sep 11 16:33:38 PDT 2012


Author: ianh
Date: 2012-09-11 16:33:36 -0700 (Tue, 11 Sep 2012)
New Revision: 7330

Modified:
   complete.html
   index
   source
Log:
[giow] (1) Change TextTrackCue.line to expose the raw value rather than the computed value. There's no way to get the computed value now.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=16915
Affected topics: Video Text Tracks

Modified: complete.html
===================================================================
--- complete.html	2012-09-11 23:23:12 UTC (rev 7329)
+++ complete.html	2012-09-11 23:33:36 UTC (rev 7330)
@@ -35051,7 +35051,7 @@
 
   </div>
 
-  <hr><pre class=idl>
+  <hr><pre class=idl>enum <dfn id=autokeyword>AutoKeyword</dfn> { "auto" };
 [<a href=#dom-texttrackcue title=dom-TextTrackCue>Constructor</a>(double startTime, double endTime, DOMString text)]
 interface <dfn id=texttrackcue>TextTrackCue</dfn> : <a href=#eventtarget>EventTarget</a> {
   readonly attribute <a href=#texttrack>TextTrack</a>? <a href=#dom-texttrackcue-track title=dom-TextTrackCue-track>track</a>;
@@ -35062,7 +35062,7 @@
            attribute boolean <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a>;
            attribute DOMString <a href=#dom-texttrackcue-vertical title=dom-TextTrackCue-vertical>vertical</a>;
            attribute boolean <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a>;
-           attribute long <a href=#dom-texttrackcue-line title=dom-TextTrackCue-line>line</a>;
+           attribute (long or <a href=#autokeyword>AutoKeyword</a>) <a href=#dom-texttrackcue-line title=dom-TextTrackCue-line>line</a>;
            attribute long <a href=#dom-texttrackcue-position title=dom-TextTrackCue-position>position</a>;
            attribute long <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a>;
            attribute DOMString <a href=#dom-texttrackcue-align title=dom-TextTrackCue-align>align</a>;
@@ -35133,8 +35133,9 @@
    <dt><var title="">cue</var> . <a href=#dom-texttrackcue-line title=dom-TextTrackCue-line>line</a> [ = <var title="">value</var> ]</dt>
    <dd>
     <p>Returns the <a href=#text-track-cue-line-position>text track cue line position</a>. In the
-    case of the value being <a href=#text-track-cue-automatic-line-position title="text track cue automatic
-    line position">auto</a>, the appropriate default is returned.</p>
+    case of the value being <a href=#text-track-cue-automatic-line-position title="text track cue automatic line
+    position">auto</a>, the string "<code title="">auto</code>" is
+    returned.</p>
     <p>Can be set.</p>
    </dd>
 
@@ -35290,30 +35291,31 @@
   otherwise.</p>
 
   <p>The <dfn id=dom-texttrackcue-line title=dom-TextTrackCue-line><code>line</code></dfn>
-  attribute, on getting, must return the <a href=#text-track-cue-computed-line-position>text track cue computed
-  line position</a> of the <a href=#text-track-cue>text track cue</a> that the
-  <code><a href=#texttrackcue>TextTrackCue</a></code> object represents. On setting, set the
-  <a href=#text-track-cue-line-position>text track cue line position</a> to the new value.</p>
+  attribute, on getting, must return the <a href=#text-track-cue-line-position>text track cue line
+  position</a> of the <a href=#text-track-cue>text track cue</a> that the
+  <code><a href=#texttrackcue>TextTrackCue</a></code> object represents. The special value <a href=#text-track-cue-automatic-line-position title="text track cue automatic line position">auto</a> must be
+  represented as the string "<code title="">auto</code>". On setting,
+  the <a href=#text-track-cue-line-position>text track cue line position</a> must be set to the new
+  value; if the new value is the string "<code title="">auto</code>",
+  then it must be interpreted as the special value <a href=#text-track-cue-automatic-line-position title="text
+  track cue automatic line position">auto</a>.</p>
 
-  <p class=note>There is no way to explicitly set the <a href=#text-track-cue-line-position>text
-  track cue line position</a> to the special default <a href=#text-track-cue-automatic-line-position title="text track cue automatic line position">auto</a>
-  value.</p>
-
   <p>The <dfn id=dom-texttrackcue-position title=dom-TextTrackCue-position><code>position</code></dfn>
   attribute, on getting, must return the <a href=#text-track-cue-text-position>text track cue text
   position</a> of the <a href=#text-track-cue>text track cue</a> that the
   <code><a href=#texttrackcue>TextTrackCue</a></code> object represents. On setting, if the new
-  value is negative or greater than 100, then throw an
-  <code><a href=#indexsizeerror>IndexSizeError</a></code> exception. Otherwise, set the <a href=#text-track-cue-text-position>text
-  track cue text position</a> to the new value.</p>
+  value is negative or greater than 100, then an
+  <code><a href=#indexsizeerror>IndexSizeError</a></code> exception must be thrown. Otherwise, the
+  <a href=#text-track-cue-text-position>text track cue text position</a> must be set to the new
+  value.</p>
 
   <p>The <dfn id=dom-texttrackcue-size title=dom-TextTrackCue-size><code>size</code></dfn>
   attribute, on getting, must return the <a href=#text-track-cue-size>text track cue
   size</a> of the <a href=#text-track-cue>text track cue</a> that the
   <code><a href=#texttrackcue>TextTrackCue</a></code> object represents. On setting, if the new
-  value is negative or greater than 100, then throw an
-  <code><a href=#indexsizeerror>IndexSizeError</a></code> exception. Otherwise, set the <a href=#text-track-cue-size>text
-  track cue size</a> to the new value.</p>
+  value is negative or greater than 100, then an
+  <code><a href=#indexsizeerror>IndexSizeError</a></code> exception must be thrown. Otherwise, the
+  <a href=#text-track-cue-size>text track cue size</a> must be set to the new value.</p>
 
   <p>The <dfn id=dom-texttrackcue-align title=dom-TextTrackCue-align><code>align</code></dfn>
   attribute, on getting, must return the string from the second cell
@@ -35340,12 +35342,10 @@
   <p>The <dfn id=dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML><code>getCueAsHTML()</code></dfn>
   method must convert the <a href=#text-track-cue-text>text track cue text</a> to a
   <code><a href=#documentfragment>DocumentFragment</a></code> for the <a href=#media-element>media element</a>'s
-  <code><a href=#document>Document</a></code>, using the appropriate rules for doing
-  so.
-  For example, for <a href=#webvtt>WebVTT</a>, those rules are the
-  <a href=#webvtt-cue-text-parsing-rules>WebVTT cue text parsing rules</a> and the <a href=#webvtt-cue-text-dom-construction-rules>WebVTT cue
-  text DOM construction rules</a>. <a href=#refsWEBVTT>[WEBVTT]</a>
-  </p>
+  <code><a href=#document>Document</a></code>, using the appropriate rules for doing so. For
+  example, for <a href=#webvtt>WebVTT</a>, those rules are the <a href=#webvtt-cue-text-parsing-rules>WebVTT
+  cue text parsing rules</a> and the <a href=#webvtt-cue-text-dom-construction-rules>WebVTT cue text DOM
+  construction rules</a>. <a href=#refsWEBVTT>[WEBVTT]</a></p>
 
   </div>
 

Modified: index
===================================================================
--- index	2012-09-11 23:23:12 UTC (rev 7329)
+++ index	2012-09-11 23:33:36 UTC (rev 7330)
@@ -35051,7 +35051,7 @@
 
   </div>
 
-  <hr><pre class=idl>
+  <hr><pre class=idl>enum <dfn id=autokeyword>AutoKeyword</dfn> { "auto" };
 [<a href=#dom-texttrackcue title=dom-TextTrackCue>Constructor</a>(double startTime, double endTime, DOMString text)]
 interface <dfn id=texttrackcue>TextTrackCue</dfn> : <a href=#eventtarget>EventTarget</a> {
   readonly attribute <a href=#texttrack>TextTrack</a>? <a href=#dom-texttrackcue-track title=dom-TextTrackCue-track>track</a>;
@@ -35062,7 +35062,7 @@
            attribute boolean <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a>;
            attribute DOMString <a href=#dom-texttrackcue-vertical title=dom-TextTrackCue-vertical>vertical</a>;
            attribute boolean <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a>;
-           attribute long <a href=#dom-texttrackcue-line title=dom-TextTrackCue-line>line</a>;
+           attribute (long or <a href=#autokeyword>AutoKeyword</a>) <a href=#dom-texttrackcue-line title=dom-TextTrackCue-line>line</a>;
            attribute long <a href=#dom-texttrackcue-position title=dom-TextTrackCue-position>position</a>;
            attribute long <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a>;
            attribute DOMString <a href=#dom-texttrackcue-align title=dom-TextTrackCue-align>align</a>;
@@ -35133,8 +35133,9 @@
    <dt><var title="">cue</var> . <a href=#dom-texttrackcue-line title=dom-TextTrackCue-line>line</a> [ = <var title="">value</var> ]</dt>
    <dd>
     <p>Returns the <a href=#text-track-cue-line-position>text track cue line position</a>. In the
-    case of the value being <a href=#text-track-cue-automatic-line-position title="text track cue automatic
-    line position">auto</a>, the appropriate default is returned.</p>
+    case of the value being <a href=#text-track-cue-automatic-line-position title="text track cue automatic line
+    position">auto</a>, the string "<code title="">auto</code>" is
+    returned.</p>
     <p>Can be set.</p>
    </dd>
 
@@ -35290,30 +35291,31 @@
   otherwise.</p>
 
   <p>The <dfn id=dom-texttrackcue-line title=dom-TextTrackCue-line><code>line</code></dfn>
-  attribute, on getting, must return the <a href=#text-track-cue-computed-line-position>text track cue computed
-  line position</a> of the <a href=#text-track-cue>text track cue</a> that the
-  <code><a href=#texttrackcue>TextTrackCue</a></code> object represents. On setting, set the
-  <a href=#text-track-cue-line-position>text track cue line position</a> to the new value.</p>
+  attribute, on getting, must return the <a href=#text-track-cue-line-position>text track cue line
+  position</a> of the <a href=#text-track-cue>text track cue</a> that the
+  <code><a href=#texttrackcue>TextTrackCue</a></code> object represents. The special value <a href=#text-track-cue-automatic-line-position title="text track cue automatic line position">auto</a> must be
+  represented as the string "<code title="">auto</code>". On setting,
+  the <a href=#text-track-cue-line-position>text track cue line position</a> must be set to the new
+  value; if the new value is the string "<code title="">auto</code>",
+  then it must be interpreted as the special value <a href=#text-track-cue-automatic-line-position title="text
+  track cue automatic line position">auto</a>.</p>
 
-  <p class=note>There is no way to explicitly set the <a href=#text-track-cue-line-position>text
-  track cue line position</a> to the special default <a href=#text-track-cue-automatic-line-position title="text track cue automatic line position">auto</a>
-  value.</p>
-
   <p>The <dfn id=dom-texttrackcue-position title=dom-TextTrackCue-position><code>position</code></dfn>
   attribute, on getting, must return the <a href=#text-track-cue-text-position>text track cue text
   position</a> of the <a href=#text-track-cue>text track cue</a> that the
   <code><a href=#texttrackcue>TextTrackCue</a></code> object represents. On setting, if the new
-  value is negative or greater than 100, then throw an
-  <code><a href=#indexsizeerror>IndexSizeError</a></code> exception. Otherwise, set the <a href=#text-track-cue-text-position>text
-  track cue text position</a> to the new value.</p>
+  value is negative or greater than 100, then an
+  <code><a href=#indexsizeerror>IndexSizeError</a></code> exception must be thrown. Otherwise, the
+  <a href=#text-track-cue-text-position>text track cue text position</a> must be set to the new
+  value.</p>
 
   <p>The <dfn id=dom-texttrackcue-size title=dom-TextTrackCue-size><code>size</code></dfn>
   attribute, on getting, must return the <a href=#text-track-cue-size>text track cue
   size</a> of the <a href=#text-track-cue>text track cue</a> that the
   <code><a href=#texttrackcue>TextTrackCue</a></code> object represents. On setting, if the new
-  value is negative or greater than 100, then throw an
-  <code><a href=#indexsizeerror>IndexSizeError</a></code> exception. Otherwise, set the <a href=#text-track-cue-size>text
-  track cue size</a> to the new value.</p>
+  value is negative or greater than 100, then an
+  <code><a href=#indexsizeerror>IndexSizeError</a></code> exception must be thrown. Otherwise, the
+  <a href=#text-track-cue-size>text track cue size</a> must be set to the new value.</p>
 
   <p>The <dfn id=dom-texttrackcue-align title=dom-TextTrackCue-align><code>align</code></dfn>
   attribute, on getting, must return the string from the second cell
@@ -35340,12 +35342,10 @@
   <p>The <dfn id=dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML><code>getCueAsHTML()</code></dfn>
   method must convert the <a href=#text-track-cue-text>text track cue text</a> to a
   <code><a href=#documentfragment>DocumentFragment</a></code> for the <a href=#media-element>media element</a>'s
-  <code><a href=#document>Document</a></code>, using the appropriate rules for doing
-  so.
-  For example, for <a href=#webvtt>WebVTT</a>, those rules are the
-  <a href=#webvtt-cue-text-parsing-rules>WebVTT cue text parsing rules</a> and the <a href=#webvtt-cue-text-dom-construction-rules>WebVTT cue
-  text DOM construction rules</a>. <a href=#refsWEBVTT>[WEBVTT]</a>
-  </p>
+  <code><a href=#document>Document</a></code>, using the appropriate rules for doing so. For
+  example, for <a href=#webvtt>WebVTT</a>, those rules are the <a href=#webvtt-cue-text-parsing-rules>WebVTT
+  cue text parsing rules</a> and the <a href=#webvtt-cue-text-dom-construction-rules>WebVTT cue text DOM
+  construction rules</a>. <a href=#refsWEBVTT>[WEBVTT]</a></p>
 
   </div>
 

Modified: source
===================================================================
--- source	2012-09-11 23:23:12 UTC (rev 7329)
+++ source	2012-09-11 23:33:36 UTC (rev 7330)
@@ -38446,7 +38446,7 @@
 
   <hr>
 
-  <pre class="idl">
+  <pre class="idl">enum <dfn>AutoKeyword</dfn> { "auto" };
 [<span title="dom-TextTrackCue">Constructor</span>(double startTime, double endTime, DOMString text)]
 interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
   readonly attribute <span>TextTrack</span>? <span title="dom-TextTrackCue-track">track</span>;
@@ -38457,7 +38457,7 @@
            attribute boolean <span title="dom-TextTrackCue-pauseOnExit">pauseOnExit</span>;
            attribute DOMString <span title="dom-TextTrackCue-vertical">vertical</span>;
            attribute boolean <span title="dom-TextTrackCue-snapToLines">snapToLines</span>;
-           attribute long <span title="dom-TextTrackCue-line">line</span>;
+           attribute (long or <span>AutoKeyword</span>) <span title="dom-TextTrackCue-line">line</span>;
            attribute long <span title="dom-TextTrackCue-position">position</span>;
            attribute long <span title="dom-TextTrackCue-size">size</span>;
            attribute DOMString <span title="dom-TextTrackCue-align">align</span>;
@@ -38532,8 +38532,9 @@
    <dt><var title="">cue</var> . <span title="dom-TextTrackCue-line">line</span> [ = <var title="">value</var> ]</dt>
    <dd>
     <p>Returns the <span>text track cue line position</span>. In the
-    case of the value being <span title="text track cue automatic
-    line position">auto</span>, the appropriate default is returned.</p>
+    case of the value being <span title="text track cue automatic line
+    position">auto</span>, the string "<code title="">auto</code>" is
+    returned.</p>
     <p>Can be set.</p>
    </dd>
 
@@ -38710,32 +38711,33 @@
   otherwise.</p>
 
   <p>The <dfn title="dom-TextTrackCue-line"><code>line</code></dfn>
-  attribute, on getting, must return the <span>text track cue computed
-  line position</span> of the <span>text track cue</span> that the
-  <code>TextTrackCue</code> object represents. On setting, set the
-  <span>text track cue line position</span> to the new value.</p>
+  attribute, on getting, must return the <span>text track cue line
+  position</span> of the <span>text track cue</span> that the
+  <code>TextTrackCue</code> object represents. The special value <span
+  title="text track cue automatic line position">auto</span> must be
+  represented as the string "<code title="">auto</code>". On setting,
+  the <span>text track cue line position</span> must be set to the new
+  value; if the new value is the string "<code title="">auto</code>",
+  then it must be interpreted as the special value <span title="text
+  track cue automatic line position">auto</span>.</p>
 
-  <p class="note">There is no way to explicitly set the <span>text
-  track cue line position</span> to the special default <span
-  title="text track cue automatic line position">auto</span>
-  value.</p>
-
   <p>The <dfn
   title="dom-TextTrackCue-position"><code>position</code></dfn>
   attribute, on getting, must return the <span>text track cue text
   position</span> of the <span>text track cue</span> that the
   <code>TextTrackCue</code> object represents. On setting, if the new
-  value is negative or greater than 100, then throw an
-  <code>IndexSizeError</code> exception. Otherwise, set the <span>text
-  track cue text position</span> to the new value.</p>
+  value is negative or greater than 100, then an
+  <code>IndexSizeError</code> exception must be thrown. Otherwise, the
+  <span>text track cue text position</span> must be set to the new
+  value.</p>
 
   <p>The <dfn title="dom-TextTrackCue-size"><code>size</code></dfn>
   attribute, on getting, must return the <span>text track cue
   size</span> of the <span>text track cue</span> that the
   <code>TextTrackCue</code> object represents. On setting, if the new
-  value is negative or greater than 100, then throw an
-  <code>IndexSizeError</code> exception. Otherwise, set the <span>text
-  track cue size</span> to the new value.</p>
+  value is negative or greater than 100, then an
+  <code>IndexSizeError</code> exception must be thrown. Otherwise, the
+  <span>text track cue size</span> must be set to the new value.</p>
 
   <p>The <dfn
   title="dom-TextTrackCue-align"><code>align</code></dfn>
@@ -38769,12 +38771,10 @@
   title="dom-TextTrackCue-getCueAsHTML"><code>getCueAsHTML()</code></dfn>
   method must convert the <span>text track cue text</span> to a
   <code>DocumentFragment</code> for the <span>media element</span>'s
-  <code>Document</code>, using the appropriate rules for doing
-  so.
-  For example, for <span>WebVTT</span>, those rules are the
-  <span>WebVTT cue text parsing rules</span> and the <span>WebVTT cue
-  text DOM construction rules</span>. <a href="#refsWEBVTT">[WEBVTT]</a>
-  </p>
+  <code>Document</code>, using the appropriate rules for doing so. For
+  example, for <span>WebVTT</span>, those rules are the <span>WebVTT
+  cue text parsing rules</span> and the <span>WebVTT cue text DOM
+  construction rules</span>. <a href="#refsWEBVTT">[WEBVTT]</a></p>
 
   </div>
 




More information about the Commit-Watchers mailing list