Browse files

[giow] (0) Make TextTrackCue more mutable.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=14105

git-svn-id: http://svn.whatwg.org/webapps@6711 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent c416bd1 commit 383f0e73b8ac7edb17ff3521d381e9ea2f889c1e @Hixie Hixie committed Oct 20, 2011
Showing with 366 additions and 244 deletions.
  1. +123 −81 complete.html
  2. +123 −81 index
  3. +120 −82 source
View
204 complete.html
@@ -32062,22 +32062,18 @@ <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
[<a href=#dom-texttrackcue title=dom-TextTrackCue>Constructor</a>(DOMString id, double startTime, double endTime, DOMString text, optional DOMString settings, optional boolean pauseOnExit)]
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>;
- readonly attribute DOMString <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a>;
- readonly attribute double <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a>;
- readonly attribute double <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a>;
- readonly attribute boolean <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a>;
-
-<!--TTVTT-->
- readonly attribute DOMString <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a>;
- readonly attribute boolean <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a>;
- readonly attribute long <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a>;
- readonly attribute long <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a>;
- readonly attribute long <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a>;
- readonly attribute DOMString <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a>;
-<!--TTVTT-->
-
- DOMString <a href=#dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource>getCueAsSource</a>();
+ attribute DOMString <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a>;
+ attribute double <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a>;
+ attribute double <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a>;
+ attribute boolean <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a>;
+ attribute DOMString <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a>;
+ attribute boolean <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a>;
+ attribute long <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a>;
+ attribute long <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a>;
+ attribute long <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a>;
+ attribute DOMString <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a>;
+ attribute DOMString <a href=#dom-texttrackcue-cueassource title=dom-TextTrackCue-cueAsSource>cueAsSource</a>();
<a href=#documentfragment>DocumentFragment</a> <a href=#dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML>getCueAsHTML</a>();
[TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-texttrackcue-onenter title=handler-TextTrackCue-onenter>onenter</a>;
@@ -32102,28 +32098,31 @@ <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-identifier>text track cue identifier</a>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-start-time>text track cue start time</a>, in seconds.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-end-time>text track cue end time</a>, in seconds.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a> is set, false otherwise.</p>
+ <p>Can be set.</p>
</dd>
-<!--TTVTT-->
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns a string representing the <a href=#text-track-cue-writing-direction>text track cue writing direction</a>, as follows:</p>
<dl class=switch><dt>If it is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a></dt>
@@ -32132,31 +32131,36 @@ <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
<dd><p>The string "<code title="">vertical</code>".</dd>
<dt>If it is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a></dt>
<dd><p>The string "<code title="">vertical-lr</code>".</dd>
- </dl></dd>
+ </dl><p>Can be set.</p>
+ </dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set, false otherwise.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</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>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-size>text track cue size</a>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns a string representing the <a href=#text-track-cue-alignment>text track cue alignment</a>, as follows:</p>
<dl class=switch><dt>If it is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start alignment</a></dt>
@@ -32165,22 +32169,23 @@ <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
<dd><p>The string "<code title="">middle</code>".</dd>
<dt>If it is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end alignment</a></dt>
<dd><p>The string "<code title="">end</code>".</dd>
- </dl></dd>
-<!--TTVTT-->
+ </dl><p>Can be set.</p>
+ </dd>
- <dt><var title="">source</var> = <var title="">cue</var> . <a href=#dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource>getCueAsSource</a>()</dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-cueassource title=dom-TextTrackCue-cueAsSource>cueAsSource</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-text>text track cue text</a> in raw unparsed form.</p>
+ <p>Can be set.</p>
</dd>
<dt><var title="">fragment</var> = <var title="">cue</var> . <a href=#dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML>getCueAsHTML</a>()</dt>
<dd>
<p>Returns the <a href=#text-track-cue-text>text track cue text</a> as a <code><a href=#documentfragment>DocumentFragment</a></code> of <a href=#html-elements>HTML elements</a> and other DOM nodes.</p>
+ <p>Can be set.</p>
</dd>
</dl><div class=impl>
-<!--TTVTT-->
<p>The <dfn id=dom-texttrackcue title=dom-TextTrackCue><code>TextTrackCue(<var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var>, <var title="">settings</var>, <var title="">pauseOnExit</var>)</code></dfn> constructor, when invoked,
must run the following steps:</p>
@@ -32244,38 +32249,43 @@ <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
<li><p>Return the <code><a href=#texttrackcue>TextTrackCue</a></code> object representing
<var title="">cue</var>.</li>
- </ol><!--TTVTT--><p>The <dfn id=dom-texttrackcue-track title=dom-TextTrackCue-track><code>track</code></dfn>
- attribute must return the <code><a href=#texttrack>TextTrack</a></code> object of the
- <a href=#text-track>text track</a> with which the <a href=#text-track-cue>text track cue</a>
- that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is associated,
- if any; or null otherwise.</p>
+ </ol><p>The <dfn id=dom-texttrackcue-track title=dom-TextTrackCue-track><code>track</code></dfn>
+ attribute, on getting, must return the <code><a href=#texttrack>TextTrack</a></code> object
+ of the <a href=#text-track>text track</a> with which the <a href=#text-track-cue>text track
+ cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is
+ associated, if any; or null otherwise.</p>
<p>The <dfn id=dom-texttrackcue-id title=dom-TextTrackCue-id><code>id</code></dfn>
- attribute must return the <a href=#text-track-cue-identifier>text track cue identifier</a> of
- the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
- object represents.</p>
+ attribute, on getting, must return the <a href=#text-track-cue-identifier>text track cue
+ identifier</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, the <a href=#text-track-cue-identifier>text track cue
+ identifier</a> must be set to the new value.</p>
<p>The <dfn id=dom-texttrackcue-starttime title=dom-TextTrackCue-startTime><code>startTime</code></dfn>
- attribute must return the <a href=#text-track-cue-start-time>text track cue start time</a> of
- the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
- object represents, in seconds.</p>
+ attribute, on getting, must return the <a href=#text-track-cue-start-time>text track cue start
+ time</a> of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, in seconds. On setting, the <a href=#text-track-cue-start-time>text track cue start
+ time</a> must be set to the new value, interpreted in seconds.</p>
<p>The <dfn id=dom-texttrackcue-endtime title=dom-TextTrackCue-endTime><code>endTime</code></dfn>
- attribute must return the <a href=#text-track-cue-end-time>text track cue end time</a> of
- the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
- object represents, in seconds.</p>
+ attribute, on getting, must return the <a href=#text-track-cue-end-time>text track cue end
+ time</a> of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, in seconds. On setting, the <a href=#text-track-cue-end-time>text track cue end
+ time</a> must be set to the new value, interpreted in seconds.</p>
<p>The <dfn id=dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit><code>pauseOnExit</code></dfn>
- attribute must return true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue
+ attribute, on getting, must return true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue
pause-on-exit flag</a> of the <a href=#text-track-cue>text track cue</a> that
the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is set; or false
+ otherwise. On setting, the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit
+ flag</a> must be set if the new value is true, and must be unset
otherwise.</p>
<p>The <dfn id=dom-texttrackcue-direction title=dom-TextTrackCue-direction><code>direction</code></dfn>
- attribute must return the string from the second cell of the row in
- the table below whose first cell is the <a href=#text-track-cue-writing-direction>text track cue
- writing direction</a> of the <a href=#text-track-cue>text track cue</a> that the
- <code><a href=#texttrackcue>TextTrackCue</a></code> object represents:</p>
+ attribute, on getting, must return the string from the second cell
+ of the row in the table below whose first cell is the <a href=#text-track-cue-writing-direction>text
+ track cue writing direction</a> of the <a href=#text-track-cue>text track
+ cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents:</p>
<table><thead><tr><th> <a href=#text-track-cue-writing-direction>Text track cue writing direction</a>
<th> <code title=dom-TextTrackCue-direction><a href=#dom-texttrackcue-direction>direction</a></code> value
@@ -32285,22 +32295,31 @@ <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
<td> "<code title="">vertical</code>"
<tr><td> <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">Vertical growing right</a>
<td> "<code title="">vertical-lr</code>"
- </table><!--TTVTT--><p>The <dfn id=dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines><code>snapToLines</code></dfn>
- attribute must return true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue
+ </table><p>On setting, the <a href=#text-track-cue-writing-direction>text track cue writing direction</a>
+ must be set to the value given in the first cell of the row in the
+ table above whose second cell is a <a href=#case-sensitive>case-sensitive</a> match
+ for the new value, if any. If none of the values match, then the
+ user agent must instead throw a <code><a href=#syntaxerror>SyntaxError</a></code>
+ exception.</p>
+
+ <p>The <dfn id=dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines><code>snapToLines</code></dfn>
+ attribute, on getting, must return true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue
snap-to-lines flag</a> of the <a href=#text-track-cue>text track cue</a> that
the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is set; or false
+ otherwise. On setting, the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines
+ flag</a> must be set if the new value is true, and must be unset
otherwise.</p>
<p>The <dfn id=dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition><code>linePosition</code></dfn>
- attribute 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
+ 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, if that value is
- numeric. Otherwise, the value is the special value <a href=#text-track-cue-automatic-line-position title="text track cue automatic line position">auto</a>; if the
- <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> of the <a href=#text-track-cue>text
- track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object
- represents is not set, the attribute must return the value 100;
- otherwise, it must return the value returned by the following
- algorithm:</p>
+ numeric. Otherwise, the value is the special value <a href=#text-track-cue-automatic-line-position title="text
+ track cue automatic line position">auto</a>; if the <a href=#text-track-cue-snap-to-lines-flag>text
+ track cue snap-to-lines flag</a> of the <a href=#text-track-cue>text track
+ cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is
+ not set, the attribute must return the value 100; otherwise, it must
+ return the value returned by the following algorithm:</p>
<ol><li><p>Let <var title="">cue</var> be the <a href=#text-track-cue>text track
cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object
@@ -32310,40 +32329,63 @@ <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
<a href=#text-track>text track</a>, return &minus;1 and abort these
steps.</li>
- <li><p>Let <var title="">track</var> be the <a href=#text-track>text
- track</a> that the <var title="">cue</var> is associated
- with.</li>
+ <li><p>Let <var title="">track</var> be the <a href=#text-track>text track</a>
+ that the <var title="">cue</var> is associated with.</li>
- <li><p>Let <var title="">n</var> be the number of <a href=#text-track title="text track">text tracks</a> whose <a href=#text-track-mode>text track
- mode</a> is <a href=#text-track-showing title="text track showing">showing</a> or
- <a href=#text-track-showing-by-default title="text track showing by default">showing by
- default</a> and that are in the <a href=#media-element>media element</a>'s
- <a href=#list-of-text-tracks>list of text tracks</a> before <var title="">track</var>.</li>
+ <li><p>Let <var title="">n</var> be the number of <a href=#text-track title="text
+ track">text tracks</a> whose <a href=#text-track-mode>text track mode</a> is
+ <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a> and
+ that are in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text
+ tracks</a> before <var title="">track</var>.</li>
<li><p>Return <var title="">n</var>.</li>
- </ol><p>The <dfn id=dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition><code>textPosition</code></dfn>
- attribute 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.</p>
+ </ol><p>On setting, if the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a>
+ is not set, and 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-line-position>text track cue line position</a> to the new value.</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-textposition title=dom-TextTrackCue-textPosition><code>textPosition</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>
<p>The <dfn id=dom-texttrackcue-size title=dom-TextTrackCue-size><code>size</code></dfn>
- attribute 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.</p>
+ 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>
<p>The <dfn id=dom-texttrackcue-alignment title=dom-TextTrackCue-alignment><code>alignment</code></dfn>
- attribute must return the string from the second cell of the row in
- the table below whose first cell is the <a href=#text-track-cue-alignment>text track cue
- alignment</a> of the <a href=#text-track-cue>text track cue</a> that the
- <code><a href=#texttrackcue>TextTrackCue</a></code> object represents:</p>
+ attribute, on getting, must return the string from the second cell
+ of the row in the table below whose first cell is the <a href=#text-track-cue-alignment>text
+ track cue alignment</a> of the <a href=#text-track-cue>text track cue</a> that
+ the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents:</p>
<table><thead><tr><th><a href=#text-track-cue-alignment>Text track cue alignment</a> <th> <code title=dom-TextTrackCue-alignment><a href=#dom-texttrackcue-alignment>alignment</a></code> value
<tbody><tr><td><a href=#text-track-cue-start-alignment title="text track cue start alignment">Start alignment</a> <td> "<code title="">start</code>"
<tr><td><a href=#text-track-cue-middle-alignment title="text track cue middle alignment">Middle alignment</a> <td> "<code title="">middle</code>"
<tr><td><a href=#text-track-cue-end-alignment title="text track cue end alignment">End alignment</a> <td> "<code title="">end</code>"
- </table><!--TTVTT--><p>The <dfn id=dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource><code>getCueAsSource()</code></dfn>
- method must return the raw <a href=#text-track-cue-text>text track cue text</a>.</p>
+ </table><p>On setting, the <a href=#text-track-cue-alignment>text track cue alignment</a> must be set
+ to the value given in the first cell of the row in the table above
+ whose second cell is a <a href=#case-sensitive>case-sensitive</a> match for the new
+ value, if any. If none of the values match, then the user agent must
+ instead throw a <code><a href=#syntaxerror>SyntaxError</a></code> exception.</p>
+
+ <p>The <dfn id=dom-texttrackcue-cueassource title=dom-TextTrackCue-cueAsSource><code>cueAsSource</code></dfn>
+ attribute, on getting, must return the raw <a href=#text-track-cue-text>text track cue
+ text</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, the
+ <a href=#text-track-cue-text>text track cue text</a> must be set to the new value.</p>
<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
View
204 index
@@ -32062,22 +32062,18 @@ window.onbeforeunload = function () {
[<a href=#dom-texttrackcue title=dom-TextTrackCue>Constructor</a>(DOMString id, double startTime, double endTime, DOMString text, optional DOMString settings, optional boolean pauseOnExit)]
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>;
- readonly attribute DOMString <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a>;
- readonly attribute double <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a>;
- readonly attribute double <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a>;
- readonly attribute boolean <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a>;
-
-<!--TTVTT-->
- readonly attribute DOMString <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a>;
- readonly attribute boolean <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a>;
- readonly attribute long <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a>;
- readonly attribute long <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a>;
- readonly attribute long <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a>;
- readonly attribute DOMString <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a>;
-<!--TTVTT-->
-
- DOMString <a href=#dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource>getCueAsSource</a>();
+ attribute DOMString <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a>;
+ attribute double <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a>;
+ attribute double <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a>;
+ attribute boolean <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a>;
+ attribute DOMString <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a>;
+ attribute boolean <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a>;
+ attribute long <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a>;
+ attribute long <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a>;
+ attribute long <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a>;
+ attribute DOMString <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a>;
+ attribute DOMString <a href=#dom-texttrackcue-cueassource title=dom-TextTrackCue-cueAsSource>cueAsSource</a>();
<a href=#documentfragment>DocumentFragment</a> <a href=#dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML>getCueAsHTML</a>();
[TreatNonCallableAsNull] attribute <a href=#function>Function</a>? <a href=#handler-texttrackcue-onenter title=handler-TextTrackCue-onenter>onenter</a>;
@@ -32102,28 +32098,31 @@ interface <dfn id=texttrackcue>TextTrackCue</dfn> : <a href=#eventtarget>EventTa
otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-identifier>text track cue identifier</a>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-start-time>text track cue start time</a>, in seconds.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-end-time>text track cue end time</a>, in seconds.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a> is set, false otherwise.</p>
+ <p>Can be set.</p>
</dd>
-<!--TTVTT-->
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns a string representing the <a href=#text-track-cue-writing-direction>text track cue writing direction</a>, as follows:</p>
<dl class=switch><dt>If it is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a></dt>
@@ -32132,31 +32131,36 @@ interface <dfn id=texttrackcue>TextTrackCue</dfn> : <a href=#eventtarget>EventTa
<dd><p>The string "<code title="">vertical</code>".</dd>
<dt>If it is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a></dt>
<dd><p>The string "<code title="">vertical-lr</code>".</dd>
- </dl></dd>
+ </dl><p>Can be set.</p>
+ </dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set, false otherwise.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</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>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-size>text track cue size</a>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns a string representing the <a href=#text-track-cue-alignment>text track cue alignment</a>, as follows:</p>
<dl class=switch><dt>If it is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start alignment</a></dt>
@@ -32165,22 +32169,23 @@ interface <dfn id=texttrackcue>TextTrackCue</dfn> : <a href=#eventtarget>EventTa
<dd><p>The string "<code title="">middle</code>".</dd>
<dt>If it is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end alignment</a></dt>
<dd><p>The string "<code title="">end</code>".</dd>
- </dl></dd>
-<!--TTVTT-->
+ </dl><p>Can be set.</p>
+ </dd>
- <dt><var title="">source</var> = <var title="">cue</var> . <a href=#dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource>getCueAsSource</a>()</dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-cueassource title=dom-TextTrackCue-cueAsSource>cueAsSource</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href=#text-track-cue-text>text track cue text</a> in raw unparsed form.</p>
+ <p>Can be set.</p>
</dd>
<dt><var title="">fragment</var> = <var title="">cue</var> . <a href=#dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML>getCueAsHTML</a>()</dt>
<dd>
<p>Returns the <a href=#text-track-cue-text>text track cue text</a> as a <code><a href=#documentfragment>DocumentFragment</a></code> of <a href=#html-elements>HTML elements</a> and other DOM nodes.</p>
+ <p>Can be set.</p>
</dd>
</dl><div class=impl>
-<!--TTVTT-->
<p>The <dfn id=dom-texttrackcue title=dom-TextTrackCue><code>TextTrackCue(<var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var>, <var title="">settings</var>, <var title="">pauseOnExit</var>)</code></dfn> constructor, when invoked,
must run the following steps:</p>
@@ -32244,38 +32249,43 @@ interface <dfn id=texttrackcue>TextTrackCue</dfn> : <a href=#eventtarget>EventTa
<li><p>Return the <code><a href=#texttrackcue>TextTrackCue</a></code> object representing
<var title="">cue</var>.</li>
- </ol><!--TTVTT--><p>The <dfn id=dom-texttrackcue-track title=dom-TextTrackCue-track><code>track</code></dfn>
- attribute must return the <code><a href=#texttrack>TextTrack</a></code> object of the
- <a href=#text-track>text track</a> with which the <a href=#text-track-cue>text track cue</a>
- that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is associated,
- if any; or null otherwise.</p>
+ </ol><p>The <dfn id=dom-texttrackcue-track title=dom-TextTrackCue-track><code>track</code></dfn>
+ attribute, on getting, must return the <code><a href=#texttrack>TextTrack</a></code> object
+ of the <a href=#text-track>text track</a> with which the <a href=#text-track-cue>text track
+ cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is
+ associated, if any; or null otherwise.</p>
<p>The <dfn id=dom-texttrackcue-id title=dom-TextTrackCue-id><code>id</code></dfn>
- attribute must return the <a href=#text-track-cue-identifier>text track cue identifier</a> of
- the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
- object represents.</p>
+ attribute, on getting, must return the <a href=#text-track-cue-identifier>text track cue
+ identifier</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, the <a href=#text-track-cue-identifier>text track cue
+ identifier</a> must be set to the new value.</p>
<p>The <dfn id=dom-texttrackcue-starttime title=dom-TextTrackCue-startTime><code>startTime</code></dfn>
- attribute must return the <a href=#text-track-cue-start-time>text track cue start time</a> of
- the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
- object represents, in seconds.</p>
+ attribute, on getting, must return the <a href=#text-track-cue-start-time>text track cue start
+ time</a> of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, in seconds. On setting, the <a href=#text-track-cue-start-time>text track cue start
+ time</a> must be set to the new value, interpreted in seconds.</p>
<p>The <dfn id=dom-texttrackcue-endtime title=dom-TextTrackCue-endTime><code>endTime</code></dfn>
- attribute must return the <a href=#text-track-cue-end-time>text track cue end time</a> of
- the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
- object represents, in seconds.</p>
+ attribute, on getting, must return the <a href=#text-track-cue-end-time>text track cue end
+ time</a> of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, in seconds. On setting, the <a href=#text-track-cue-end-time>text track cue end
+ time</a> must be set to the new value, interpreted in seconds.</p>
<p>The <dfn id=dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit><code>pauseOnExit</code></dfn>
- attribute must return true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue
+ attribute, on getting, must return true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue
pause-on-exit flag</a> of the <a href=#text-track-cue>text track cue</a> that
the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is set; or false
+ otherwise. On setting, the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit
+ flag</a> must be set if the new value is true, and must be unset
otherwise.</p>
<p>The <dfn id=dom-texttrackcue-direction title=dom-TextTrackCue-direction><code>direction</code></dfn>
- attribute must return the string from the second cell of the row in
- the table below whose first cell is the <a href=#text-track-cue-writing-direction>text track cue
- writing direction</a> of the <a href=#text-track-cue>text track cue</a> that the
- <code><a href=#texttrackcue>TextTrackCue</a></code> object represents:</p>
+ attribute, on getting, must return the string from the second cell
+ of the row in the table below whose first cell is the <a href=#text-track-cue-writing-direction>text
+ track cue writing direction</a> of the <a href=#text-track-cue>text track
+ cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents:</p>
<table><thead><tr><th> <a href=#text-track-cue-writing-direction>Text track cue writing direction</a>
<th> <code title=dom-TextTrackCue-direction><a href=#dom-texttrackcue-direction>direction</a></code> value
@@ -32285,22 +32295,31 @@ interface <dfn id=texttrackcue>TextTrackCue</dfn> : <a href=#eventtarget>EventTa
<td> "<code title="">vertical</code>"
<tr><td> <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">Vertical growing right</a>
<td> "<code title="">vertical-lr</code>"
- </table><!--TTVTT--><p>The <dfn id=dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines><code>snapToLines</code></dfn>
- attribute must return true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue
+ </table><p>On setting, the <a href=#text-track-cue-writing-direction>text track cue writing direction</a>
+ must be set to the value given in the first cell of the row in the
+ table above whose second cell is a <a href=#case-sensitive>case-sensitive</a> match
+ for the new value, if any. If none of the values match, then the
+ user agent must instead throw a <code><a href=#syntaxerror>SyntaxError</a></code>
+ exception.</p>
+
+ <p>The <dfn id=dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines><code>snapToLines</code></dfn>
+ attribute, on getting, must return true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue
snap-to-lines flag</a> of the <a href=#text-track-cue>text track cue</a> that
the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is set; or false
+ otherwise. On setting, the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines
+ flag</a> must be set if the new value is true, and must be unset
otherwise.</p>
<p>The <dfn id=dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition><code>linePosition</code></dfn>
- attribute 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
+ 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, if that value is
- numeric. Otherwise, the value is the special value <a href=#text-track-cue-automatic-line-position title="text track cue automatic line position">auto</a>; if the
- <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> of the <a href=#text-track-cue>text
- track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object
- represents is not set, the attribute must return the value 100;
- otherwise, it must return the value returned by the following
- algorithm:</p>
+ numeric. Otherwise, the value is the special value <a href=#text-track-cue-automatic-line-position title="text
+ track cue automatic line position">auto</a>; if the <a href=#text-track-cue-snap-to-lines-flag>text
+ track cue snap-to-lines flag</a> of the <a href=#text-track-cue>text track
+ cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is
+ not set, the attribute must return the value 100; otherwise, it must
+ return the value returned by the following algorithm:</p>
<ol><li><p>Let <var title="">cue</var> be the <a href=#text-track-cue>text track
cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object
@@ -32310,40 +32329,63 @@ interface <dfn id=texttrackcue>TextTrackCue</dfn> : <a href=#eventtarget>EventTa
<a href=#text-track>text track</a>, return &minus;1 and abort these
steps.</li>
- <li><p>Let <var title="">track</var> be the <a href=#text-track>text
- track</a> that the <var title="">cue</var> is associated
- with.</li>
+ <li><p>Let <var title="">track</var> be the <a href=#text-track>text track</a>
+ that the <var title="">cue</var> is associated with.</li>
- <li><p>Let <var title="">n</var> be the number of <a href=#text-track title="text track">text tracks</a> whose <a href=#text-track-mode>text track
- mode</a> is <a href=#text-track-showing title="text track showing">showing</a> or
- <a href=#text-track-showing-by-default title="text track showing by default">showing by
- default</a> and that are in the <a href=#media-element>media element</a>'s
- <a href=#list-of-text-tracks>list of text tracks</a> before <var title="">track</var>.</li>
+ <li><p>Let <var title="">n</var> be the number of <a href=#text-track title="text
+ track">text tracks</a> whose <a href=#text-track-mode>text track mode</a> is
+ <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a> and
+ that are in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text
+ tracks</a> before <var title="">track</var>.</li>
<li><p>Return <var title="">n</var>.</li>
- </ol><p>The <dfn id=dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition><code>textPosition</code></dfn>
- attribute 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.</p>
+ </ol><p>On setting, if the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a>
+ is not set, and 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-line-position>text track cue line position</a> to the new value.</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-textposition title=dom-TextTrackCue-textPosition><code>textPosition</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>
<p>The <dfn id=dom-texttrackcue-size title=dom-TextTrackCue-size><code>size</code></dfn>
- attribute 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.</p>
+ 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>
<p>The <dfn id=dom-texttrackcue-alignment title=dom-TextTrackCue-alignment><code>alignment</code></dfn>
- attribute must return the string from the second cell of the row in
- the table below whose first cell is the <a href=#text-track-cue-alignment>text track cue
- alignment</a> of the <a href=#text-track-cue>text track cue</a> that the
- <code><a href=#texttrackcue>TextTrackCue</a></code> object represents:</p>
+ attribute, on getting, must return the string from the second cell
+ of the row in the table below whose first cell is the <a href=#text-track-cue-alignment>text
+ track cue alignment</a> of the <a href=#text-track-cue>text track cue</a> that
+ the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents:</p>
<table><thead><tr><th><a href=#text-track-cue-alignment>Text track cue alignment</a> <th> <code title=dom-TextTrackCue-alignment><a href=#dom-texttrackcue-alignment>alignment</a></code> value
<tbody><tr><td><a href=#text-track-cue-start-alignment title="text track cue start alignment">Start alignment</a> <td> "<code title="">start</code>"
<tr><td><a href=#text-track-cue-middle-alignment title="text track cue middle alignment">Middle alignment</a> <td> "<code title="">middle</code>"
<tr><td><a href=#text-track-cue-end-alignment title="text track cue end alignment">End alignment</a> <td> "<code title="">end</code>"
- </table><!--TTVTT--><p>The <dfn id=dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource><code>getCueAsSource()</code></dfn>
- method must return the raw <a href=#text-track-cue-text>text track cue text</a>.</p>
+ </table><p>On setting, the <a href=#text-track-cue-alignment>text track cue alignment</a> must be set
+ to the value given in the first cell of the row in the table above
+ whose second cell is a <a href=#case-sensitive>case-sensitive</a> match for the new
+ value, if any. If none of the values match, then the user agent must
+ instead throw a <code><a href=#syntaxerror>SyntaxError</a></code> exception.</p>
+
+ <p>The <dfn id=dom-texttrackcue-cueassource title=dom-TextTrackCue-cueAsSource><code>cueAsSource</code></dfn>
+ attribute, on getting, must return the raw <a href=#text-track-cue-text>text track cue
+ text</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, the
+ <a href=#text-track-cue-text>text track cue text</a> must be set to the new value.</p>
<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
View
202 source
@@ -35000,22 +35000,18 @@ window.onbeforeunload = function () {
[<span title="dom-TextTrackCue">Constructor</span>(DOMString id, double startTime, double endTime, DOMString text, optional DOMString settings, optional boolean pauseOnExit)]
interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
readonly attribute <span>TextTrack</span>? <span title="dom-TextTrackCue-track">track</span>;
- readonly attribute DOMString <span title="dom-TextTrackCue-id">id</span>;
- readonly attribute double <span title="dom-TextTrackCue-startTime">startTime</span>;
- readonly attribute double <span title="dom-TextTrackCue-endTime">endTime</span>;
- readonly attribute boolean <span title="dom-TextTrackCue-pauseOnExit">pauseOnExit</span>;
-
-<!--END w3c-html--><!--TTVTT-->
- readonly attribute DOMString <span title="dom-TextTrackCue-direction">direction</span>;
- readonly attribute boolean <span title="dom-TextTrackCue-snapToLines">snapToLines</span>;
- readonly attribute long <span title="dom-TextTrackCue-linePosition">linePosition</span>;
- readonly attribute long <span title="dom-TextTrackCue-textPosition">textPosition</span>;
- readonly attribute long <span title="dom-TextTrackCue-size">size</span>;
- readonly attribute DOMString <span title="dom-TextTrackCue-alignment">alignment</span>;
-<!--START w3c-html--><!--TTVTT-->
-
- DOMString <span title="dom-TextTrackCue-getCueAsSource">getCueAsSource</span>();
+ attribute DOMString <span title="dom-TextTrackCue-id">id</span>;
+ attribute double <span title="dom-TextTrackCue-startTime">startTime</span>;
+ attribute double <span title="dom-TextTrackCue-endTime">endTime</span>;
+ attribute boolean <span title="dom-TextTrackCue-pauseOnExit">pauseOnExit</span>;
+ attribute DOMString <span title="dom-TextTrackCue-direction">direction</span>;
+ attribute boolean <span title="dom-TextTrackCue-snapToLines">snapToLines</span>;
+ attribute long <span title="dom-TextTrackCue-linePosition">linePosition</span>;
+ attribute long <span title="dom-TextTrackCue-textPosition">textPosition</span>;
+ attribute long <span title="dom-TextTrackCue-size">size</span>;
+ attribute DOMString <span title="dom-TextTrackCue-alignment">alignment</span>;
+ attribute DOMString <span title="dom-TextTrackCue-cueAsSource">cueAsSource</span>();
<span>DocumentFragment</span> <span title="dom-TextTrackCue-getCueAsHTML">getCueAsHTML</span>();
[TreatNonCallableAsNull] attribute <span>Function</span>? <span title="handler-TextTrackCue-onenter">onenter</span>;
@@ -35042,28 +35038,31 @@ interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-id">id</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-id">id</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <span>text track cue identifier</span>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-startTime">startTime</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-startTime">startTime</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <span>text track cue start time</span>, in seconds.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-endTime">endTime</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-endTime">endTime</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <span>text track cue end time</span>, in seconds.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-pauseOnExit">pauseOnExit</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-pauseOnExit">pauseOnExit</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns true if the <span>text track cue pause-on-exit flag</span> is set, false otherwise.</p>
+ <p>Can be set.</p>
</dd>
-<!--END w3c-html--><!--TTVTT-->
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-direction">direction</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-direction">direction</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns a string representing the <span>text track cue writing direction</span>, as follows:</p>
<dl class="switch">
@@ -35074,31 +35073,36 @@ interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
<dt>If it is <span title="text track cue vertical growing right writing direction">vertical growing right</span></dt>
<dd><p>The string "<code title="">vertical-lr</code>".</p></dd>
</dl>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-snapToLines">snapToLines</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-snapToLines">snapToLines</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns true if the <span>text track cue snap-to-lines flag</span> is set, false otherwise.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-linePosition">linePosition</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-linePosition">linePosition</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>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-textPosition">textPosition</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-textPosition">textPosition</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <span>text track cue text position</span>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-size">size</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-size">size</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <span>text track cue size</span>.</p>
+ <p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TextTrackCue-alignment">alignment</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-alignment">alignment</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns a string representing the <span>text track cue alignment</span>, as follows:</p>
<dl class="switch">
@@ -35109,24 +35113,25 @@ interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
<dt>If it is <span title="text track cue end alignment">end alignment</span></dt>
<dd><p>The string "<code title="">end</code>".</p></dd>
</dl>
+ <p>Can be set.</p>
</dd>
-<!--START w3c-html--><!--TTVTT-->
- <dt><var title="">source</var> = <var title="">cue</var> . <span title="dom-TextTrackCue-getCueAsSource">getCueAsSource</span>()</dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-cueAsSource">cueAsSource</span> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <span>text track cue text</span> in raw unparsed form.</p>
+ <p>Can be set.</p>
</dd>
<dt><var title="">fragment</var> = <var title="">cue</var> . <span title="dom-TextTrackCue-getCueAsHTML">getCueAsHTML</span>()</dt>
<dd>
<p>Returns the <span>text track cue text</span> as a <code>DocumentFragment</code> of <span>HTML elements</span> and other DOM nodes.</p>
+ <p>Can be set.</p>
</dd>
</dl>
<div class="impl">
-<!--END w3c-html--><!--TTVTT-->
<p>The <dfn title="dom-TextTrackCue"><code>TextTrackCue(<var
title="">id</var>, <var title="">startTime</var>, <var
title="">endTime</var>, <var title="">text</var>, <var
@@ -35201,44 +35206,48 @@ interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
<var title="">cue</var>.</p></li>
</ol>
-<!--START w3c-html--><!--TTVTT-->
<p>The <dfn title="dom-TextTrackCue-track"><code>track</code></dfn>
- attribute must return the <code>TextTrack</code> object of the
- <span>text track</span> with which the <span>text track cue</span>
- that the <code>TextTrackCue</code> object represents is associated,
- if any; or null otherwise.</p>
+ attribute, on getting, must return the <code>TextTrack</code> object
+ of the <span>text track</span> with which the <span>text track
+ cue</span> that the <code>TextTrackCue</code> object represents is
+ associated, if any; or null otherwise.</p>
<p>The <dfn title="dom-TextTrackCue-id"><code>id</code></dfn>
- attribute must return the <span>text track cue identifier</span> of
- the <span>text track cue</span> that the <code>TextTrackCue</code>
- object represents.</p>
+ attribute, on getting, must return the <span>text track cue
+ identifier</span> of the <span>text track cue</span> that the
+ <code>TextTrackCue</code> object represents. On setting, the <span>text track cue
+ identifier</span> must be set to the new value.</p>
<p>The <dfn
title="dom-TextTrackCue-startTime"><code>startTime</code></dfn>
- attribute must return the <span>text track cue start time</span> of
- the <span>text track cue</span> that the <code>TextTrackCue</code>
- object represents, in seconds.</p>
+ attribute, on getting, must return the <span>text track cue start
+ time</span> of the <span>text track cue</span> that the
+ <code>TextTrackCue</code> object represents, in seconds. On setting, the <span>text track cue start
+ time</span> must be set to the new value, interpreted in seconds.</p>
<p>The <dfn
title="dom-TextTrackCue-endTime"><code>endTime</code></dfn>
- attribute must return the <span>text track cue end time</span> of
- the <span>text track cue</span> that the <code>TextTrackCue</code>
- object represents, in seconds.</p>
+ attribute, on getting, must return the <span>text track cue end
+ time</span> of the <span>text track cue</span> that the
+ <code>TextTrackCue</code> object represents, in seconds. On setting, the <span>text track cue end
+ time</span> must be set to the new value, interpreted in seconds.</p>
<p>The <dfn
title="dom-TextTrackCue-pauseOnExit"><code>pauseOnExit</code></dfn>
- attribute must return true if the <span>text track cue
+ attribute, on getting, must return true if the <span>text track cue
pause-on-exit flag</span> of the <span>text track cue</span> that
the <code>TextTrackCue</code> object represents is set; or false
+ otherwise. On setting, the <span>text track cue pause-on-exit
+ flag</span> must be set if the new value is true, and must be unset
otherwise.</p>
<p>The <dfn
title="dom-TextTrackCue-direction"><code>direction</code></dfn>
- attribute must return the string from the second cell of the row in
- the table below whose first cell is the <span>text track cue
- writing direction</span> of the <span>text track cue</span> that the
- <code>TextTrackCue</code> object represents:</p>
+ attribute, on getting, must return the string from the second cell
+ of the row in the table below whose first cell is the <span>text
+ track cue writing direction</span> of the <span>text track
+ cue</span> that the <code>TextTrackCue</code> object represents:</p>
<table>
<thead>
@@ -35253,26 +35262,33 @@ interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
<td> "<code title="">vertical-lr</code>"
</table>
-<!--END w3c-html--><!--TTVTT-->
+ <p>On setting, the <span>text track cue writing direction</span>
+ must be set to the value given in the first cell of the row in the
+ table above whose second cell is a <span>case-sensitive</span> match
+ for the new value, if any. If none of the values match, then the
+ user agent must instead throw a <code>SyntaxError</code>
+ exception.</p>
+
<p>The <dfn
title="dom-TextTrackCue-snapToLines"><code>snapToLines</code></dfn>
- attribute must return true if the <span>text track cue
+ attribute, on getting, must return true if the <span>text track cue
snap-to-lines flag</span> of the <span>text track cue</span> that
the <code>TextTrackCue</code> object represents is set; or false
+ otherwise. On setting, the <span>text track cue snap-to-lines
+ flag</span> must be set if the new value is true, and must be unset
otherwise.</p>
<p>The <dfn
title="dom-TextTrackCue-linePosition"><code>linePosition</code></dfn>
- attribute must return the <span>text track cue line position</span>
- of the <span>text track cue</span> that the
+ 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, if that value is
- numeric. Otherwise, the value is the special value <span
- title="text track cue automatic line position">auto</span>; if the
- <span>text track cue snap-to-lines flag</span> of the <span>text
- track cue</span> that the <code>TextTrackCue</code> object
- represents is not set, the attribute must return the value 100;
- otherwise, it must return the value returned by the following
- algorithm:</p>
+ numeric. Otherwise, the value is the special value <span title="text
+ track cue automatic line position">auto</span>; if the <span>text
+ track cue snap-to-lines flag</span> of the <span>text track
+ cue</span> that the <code>TextTrackCue</code> object represents is
+ not set, the attribute must return the value 100; otherwise, it must
+ return the value returned by the following algorithm:</p>
<ol>
@@ -35284,39 +35300,53 @@ interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
<span>text track</span>, return &#x2212;1 and abort these
steps.</p></li>
- <li><p>Let <var title="">track</var> be the <span>text
- track</span> that the <var title="">cue</var> is associated
- with.</p></li>
+ <li><p>Let <var title="">track</var> be the <span>text track</span>
+ that the <var title="">cue</var> is associated with.</p></li>
- <li><p>Let <var title="">n</var> be the number of <span
- title="text track">text tracks</span> whose <span>text track
- mode</span> is <span title="text track showing">showing</span> or
- <span title="text track showing by default">showing by
- default</span> and that are in the <span>media element</span>'s
- <span>list of text tracks</span> before <var
- title="">track</var>.</p></li>
+ <li><p>Let <var title="">n</var> be the number of <span title="text
+ track">text tracks</span> whose <span>text track mode</span> is
+ <span title="text track showing">showing</span> or <span
+ title="text track showing by default">showing by default</span> and
+ that are in the <span>media element</span>'s <span>list of text
+ tracks</span> before <var title="">track</var>.</p></li>
<li><p>Return <var title="">n</var>.</p></li>
</ol>
+ <p>On setting, if the <span>text track cue snap-to-lines flag</span>
+ is not set, and the new value is negative or greater than 100, then
+ throw an <code>IndexSizeError</code> exception. Otherwise, set the
+ <span>text track cue line position</span> to the new value.</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-textPosition"><code>textPosition</code></dfn>
- attribute must return the <span>text track cue text position</span>
- of the <span>text track cue</span> that the
- <code>TextTrackCue</code> object represents.</p>
+ 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>
<p>The <dfn title="dom-TextTrackCue-size"><code>size</code></dfn>
- attribute must return the <span>text track cue size</span> of the
- <span>text track cue</span> that the <code>TextTrackCue</code>
- object represents.</p>
+ 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>
<p>The <dfn
title="dom-TextTrackCue-alignment"><code>alignment</code></dfn>
- attribute must return the string from the second cell of the row in
- the table below whose first cell is the <span>text track cue
- alignment</span> of the <span>text track cue</span> that the
- <code>TextTrackCue</code> object represents:</p>
+ attribute, on getting, must return the string from the second cell
+ of the row in the table below whose first cell is the <span>text
+ track cue alignment</span> of the <span>text track cue</span> that
+ the <code>TextTrackCue</code> object represents:</p>
<table>
<thead>
@@ -35326,11 +35356,19 @@ interface <dfn>TextTrackCue</dfn> : <span>EventTarget</span> {
<tr> <td><span title="text track cue middle alignment">Middle alignment</span> <td> "<code title="">middle</code>"
<tr> <td><span title="text track cue end alignment">End alignment</span> <td> "<code title="">end</code>"
</table>
-<!--START w3c-html--><!--TTVTT-->
+
+ <p>On setting, the <span>text track cue alignment</span> must be set
+ to the value given in the first cell of the row in the table above
+ whose second cell is a <span>case-sensitive</span> match for the new
+ value, if any. If none of the values match, then the user agent must
+ instead throw a <code>SyntaxError</code> exception.</p>
<p>The <dfn
- title="dom-TextTrackCue-getCueAsSource"><code>getCueAsSource()</code></dfn>
- method must return the raw <span>text track cue text</span>.</p>
+ title="dom-TextTrackCue-cueAsSource"><code>cueAsSource</code></dfn>
+ attribute, on getting, must return the raw <span>text track cue
+ text</span> of the <span>text track cue</span> that the
+ <code>TextTrackCue</code> object represents. On setting, the
+ <span>text track cue text</span> must be set to the new value.</p>
<p>The <dfn
title="dom-TextTrackCue-getCueAsHTML"><code>getCueAsHTML()</code></dfn>

0 comments on commit 383f0e7

Please sign in to comment.