[html5] r5133 - [e] (0) Captions - Stage 18: domintro blocks for timed track APIs.
whatwg at whatwg.org
whatwg at whatwg.org
Wed Jul 7 16:30:25 PDT 2010
Author: ianh
Date: 2010-07-07 16:30:24 -0700 (Wed, 07 Jul 2010)
New Revision: 5133
Modified:
complete.html
index
source
Log:
[e] (0) Captions - Stage 18: domintro blocks for timed track APIs.
Modified: complete.html
===================================================================
--- complete.html 2010-07-02 22:57:06 UTC (rev 5132)
+++ complete.html 2010-07-07 23:30:24 UTC (rev 5133)
@@ -209,7 +209,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<hgroup><h1>Web Applications 1.0</h1>
- <h2 class="no-num no-toc">Draft Standard — 2 July 2010</h2>
+ <h2 class="no-num no-toc">Draft Standard — 7 July 2010</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -26196,14 +26196,14 @@
<p>A writing direction, either <dfn id=timed-track-cue-horizontal-writing-direction title="timed track cue
horizontal writing direction">horizontal</dfn> (a line extends
horizontally and is positioned vertically, with consecutive lines
- displayed below each other), <dfn id=timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
+ displayed below each other), <dfn id=timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical
+ growing left writing direction">vertical growing left</dfn> (a
+ line extends vertically and is positioned horizontally, with
+ consecutive lines displayed to the left of each other<!-- used
+ for east asian-->), or <dfn id=timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
growing right writing direction">vertical growing right</dfn> (a
line extends vertically and is positioned horizontally, with
- consecutive lines displayed to the right of each other<!-- used
- for east asian-->), or <dfn id=timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical
- growing left writing direction">vertical growing left</dfn> (a
- line extends vertically and is positioned horizontally, with
- consecutive lines displayed to the left of each other<!-- used for
+ consecutive lines displayed to the right of each other<!-- used for
mongolian -->).</p>
<p>If the <a href=#timed-track-cue-writing-direction title="timed track cue writing direction">writing
@@ -26701,14 +26701,6 @@
<h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
-<!--
- // timed tracks
- readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>;
- <span>MutableTimedTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
-
- - addTrack should add it as Loaded, Disabled, and with the rules for WebSRT.
--->
-
<pre class=idl>interface <dfn id=timedtrack>TimedTrack</dfn> {
readonly attribute DOMString <span title=dom-TimedTrack-kind>kind</span>;
readonly attribute DOMString <span title=dom-TimedTrack-label>label</span>;
@@ -26741,10 +26733,10 @@
interface <dfn id=timedtrackcuelist>TimedTrackCueList</dfn> {
readonly attribute unsigned long <span title=dom-TimedTrackCueList-length>length</span>;
getter <a href=#timedtrackcue>TimedTrackCue</a> (in unsigned long index);
- <a href=#timedtrackcue>TimedTrackCue</a> getCueById(in DOMString id);
+ <a href=#timedtrackcue>TimedTrackCue</a> <span title=dom-TimedTrackCueList-getCueById>getCueById</span>(in DOMString id);
};
-[Constructor(in DOMString id, in float startTime, in float endTime, in DOMString settings, in DOMString text, in optional boolean pauseOnExit)]
+[<span title=dom-TimedTrackCue>Constructor</span>(in DOMString id, in float startTime, in float endTime, in DOMString text, in optional DOMString settings, in optional DOMString voice, in optional boolean pauseOnExit)]
interface <dfn id=timedtrackcue>TimedTrackCue</dfn> {
readonly attribute <a href=#timedtrack>TimedTrack</a> <span title=dom-TimedTrackCue-track>track</span>;
readonly attribute DOMString <span title=dom-TimedTrackCue-id>id</span>;
@@ -26773,7 +26765,7 @@
<p>Returns the number of timed tracks associated with the element (e.g. from <code><a href=#the-track-element>track</a></code> elements).</p>
</dd>
- <dt><var title="">media</var> . <code title=dom-media-tracks>tracks[<var title="">n</var>]</code></dt>
+ <dt><var title="">media</var> . <code title=dom-media-tracks>tracks[</code> <var title="">n</var> <code title="">]</code></dt>
<dd>
<p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <var title="">n</var>th timed track.</p>
</dd>
@@ -26783,13 +26775,214 @@
<p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <code><a href=#the-track-element>track</a></code> element's timed track.</p>
</dd>
- <dt class=XXX>...</dt>
- <dd class=XXX>...</dd>
+ </dl><dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-kind>kind</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-kind>timed track kind</a> string.</p>
+ </dd>
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-label>label</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-label>timed track label</a>.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-language>language</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-language>timed track language</a> string.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-readyState>readyState</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-readiness-state>timed track readiness state</a>,
+ represented by a number from the following list:</p>
+ <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-NONE>NONE</code> (0)</dt>
+ <dd>
+ <p>The <a href=#timed-track-not-loaded>timed track not loaded</a> state.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADING>LOADING</code> (1)</dt>
+ <dd>
+ <p>The <a href=#timed-track-loading>timed track loading</a> state.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADED>LOADED</code> (2)</dt>
+ <dd>
+ <p>The <a href=#timed-track-loaded>timed track loaded</a> state.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-ERROR>ERROR</code> (3)</dt>
+ <dd>
+ <p>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</p>
+ </dd>
+ </dl></dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-mode>mode</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-mode>timed track mode</a>, represented by a
+ number from the following list:</p>
+ <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-OFF>OFF</code> (0)</dt>
+ <dd>
+ <p>The <a href=#timed-track-disabled>timed track disabled</a> mode.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-HIDDEN>HIDDEN</code> (0)</dt>
+ <dd>
+ <p>The <a href=#timed-track-hidden>timed track hidden</a> mode.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-SHOWING>SHOWING</code> (0)</dt>
+ <dd>
+ <p>The <a href=#timed-track-showing>timed track showing</a> mode.</p>
+ </dd>
+ </dl><p>Can be set, to change the mode.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-cues>cues</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-list-of-cues>timed track list of cues</a>, as a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-activeCues>activeCues</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue title="timed track cue">timed track cues</a> from the <a href=#timed-track-list-of-cues>timed track list of cues</a> that are currently active (i.e. that start before the <a href=#current-playback-position>current playback position</a> and end after it), as a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ </dd>
+
+ </dl><dl class=domintro><dt><var title="">mutableTimedTrack</var> = <var title="">media</var> . <code title=dom-media-addTrack>addTrack</code>( <var title="">label</var>, <var title="">kind</var>, <var title="">language</var> )</dt>
+ <dd>
+ <p>Creates and returns a new <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object, which is also added to the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ </dd>
+
+ <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue>addCue</code>( <var title="">cue</var> )</dt>
+ <dd>
+ <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
+ <!-- XXX exception thrown if the cue is already bound -->
+ </dd>
+
+ <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue>addCue</code>( <var title="">cue</var> )</dt>
+ <dd>
+ <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
+ <!-- XXX exception thrown if it's not there -->
+ </dd>
+
+ </dl><dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-length>length</code></dt>
+ <dd>
+ <p>Returns the number of <a href=#timed-track-cue title="timed track cue">cues</a> in the list.</p>
+ </dd>
+
+ <dt><var title="">cuelist</var>[<var title="">index</var>]</dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue>timed track cue</a> with index <var title="">index</var> in the list. The cues are sorted in <a href=#timed-track-cue-order>timed track cue order</a>.</p>
+ <p>Returns null if <var title="">index</var> is out of range.</p>
+ </dd>
+
+ <dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-getCueById>getCueById</code>( <var title="">id</var> )</dt>
+ <dd>
+ <p>Returns the first <a href=#timed-track-cue>timed track cue</a> (in <a href=#timed-track-cue-order>timed track cue order</a>) with <a href=#timed-track-cue-identifier>timed track cue identifier</a> <var title="">id</var>.</p>
+ <p>Returns null if none of the cues have the given identifier.</p>
+ </dd>
+
+ </dl><dl class=domintro><dt><var title="">cue</var> = new <code title=dom-TimedTrackCue>TimedTrackCue</code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">voice</var> [, <var title="">pauseOnExit</var> ] ] ] )</dt>
+ <dd>
+ <p>Returns a new <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, for use with the <code title=dom-MutableTimedTrack-addCue>addCue()</code> method.</p>
+ <p>The <var title="">id</var> argument sets the <a href=#timed-track-cue-identifier>timed track cue identifier</a>.</p>
+ <p>The <var title="">startTime</var> argument sets the <a href=#timed-track-cue-start-time>timed track cue start time</a>.</p>
+ <p>The <var title="">endTime</var> argument sets the <a href=#timed-track-cue-end-time>timed track cue end time</a>.</p>
+ <p>The <var title="">text</var> argument sets the <a href=#timed-track-cue-text>timed track cue text</a>.</p>
+ <p>The <var title="">settings</var> argument is a string in the format of <a href=#websrt-cue-settings>WebSRT cue settings</a>. If omitted, the empty string is assumed.</p>
+ <p>The <var title="">voice</var> argument sets the <a href=#timed-track-cue-voice-identifier>timed track cue voice identifier</a>. If omitted, the empty string is assumed.</p>
+ <p>The <var title="">pauseOnExit</var> argument sets the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a>. If omitted, false is assumed.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-track>track</span></dt>
+ <dd>
+ <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object to which this
+ <a href=#timed-track-cue>timed track cue</a> belongs, if any, or null
+ otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-id>id</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-identifier>timed track cue identifier</a>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-startTime>startTime</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-start-time>timed track cue start time</a>, in seconds.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-endTime>endTime</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-end-time>timed track cue end time</a>, in seconds.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-pauseOnExit>pauseOnExit</span></dt>
+ <dd>
+ <p>Returns true if the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a> is set, false otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-direction>direction</span></dt>
+ <dd>
+ <p>Returns a string representing the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>, as follows:</p>
+ <dl><dt>If it is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a></dt>
+ <dd><p>The string "<code title="">horizontal</code>".</dd>
+ <dt>If it is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a></dt>
+ <dd><p>The string "<code title="">vertical</code>".</dd>
+ <dt>If it is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a></dt>
+ <dd><p>The string "<code title="">vertical-lr</code>".</dd>
+ </dl></dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-snapToLines>snapToLines</span></dt>
+ <dd>
+ <p>Returns true if the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set, false otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-linePosition>linePosition</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-line-position>timed track cue line position</a>. In the
+ case of the value being <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic
+ line position">auto</a>, the appropriate default is returned.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-textPosition>textPosition</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-size>size</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-size>timed track cue size</a>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-alignment>alignment</span></dt>
+ <dd>
+ <p>Returns a string representing the <a href=#timed-track-cue-alignment>timed track cue alignment</a>, as follows:</p>
+ <dl><dt>If it is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start alignment</a></dt>
+ <dd><p>The string "<code title="">start</code>".</dd>
+ <dt>If it is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle alignment</a></dt>
+ <dd><p>The string "<code title="">middle</code>".</dd>
+ <dt>If it is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end alignment</a></dt>
+ <dd><p>The string "<code title="">end</code>".</dd>
+ </dl></dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-voice>voice</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-voice-identifier>timed track cue voice identifier</a>.</p>
+ </dd>
+
+ <dt><var title="">source</var> = <var title="">cue</var> . <span title=dom-TimedTrackCue-getCueAsSource>getCueAsSource</span>()</dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-text>timed track cue text</a> in raw unparsed form.</p>
+ </dd>
+
+ <dt><var title="">fragment</var> = <var title="">cue</var> . <span title=dom-TimedTrackCue-getCueAsHTML>getCueAsHTML</span>()</dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-text>timed 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>
+ </dd>
+
</dl><div class=impl>
<p class=XXX>...
+<!-- XXX
+ - readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>;
+ - <span>MutableTimedTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
+ - addTrack should add it as Loaded, Disabled, and with the rules for WebSRT.
+-->
+
<!-- XXX
Make sure that .cues and .activeCues doesn't change while script is
running, except for addCue/removeCue and the removal of all cues in
@@ -26810,6 +27003,17 @@
<h6 id=cue-events><span class=secno>4.8.10.10.6 </span>Event definitions</h6>
+<!-- XXX
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-onload">onload</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-onerror">onerror</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-oncuechange">oncuechange</span>;
+-->
+
+<!-- XXX
+ readonly attribute <span>Function</span> <span title="dom-TimedTrackCue-onenter">onenter</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrackCue-onexit">onexit</span>;
+-->
+
<p class=XXX>...
@@ -26933,7 +27137,7 @@
component must not be included more than once per <a href=#websrt-cue-settings>WebSRT cue
settings</a> string.</p>
- <ul class=brief><li>A <a href=#websrt-vertical-text-cue-setting>WebSRT vertical text cue setting</a>.</li> <!-- D:vertical -->
+ <ul class=brief><li>A <a href=#websrt-vertical-text-cue-setting>WebSRT vertical text cue setting</a>.</li> <!-- D:vertical/vertical-lr -->
<li>A <a href=#websrt-line-position-cue-setting>WebSRT line position cue setting</a>.</li> <!-- L:100% L:1 L:-1 -->
<li>A <a href=#websrt-text-position-cue-setting>WebSRT text position cue setting</a>.</li> <!-- T:100% -->
<li>A <a href=#websrt-size-cue-setting>WebSRT size cue setting</a>.</li> <!-- S:100% -->
@@ -26943,7 +27147,7 @@
<ol><li>A U+0044 LATIN CAPITAL LETTER D character.</li>
<li>A U+003A COLON character (:).</li>
- <li>The string "<code title="">vertical</code>".</li>
+ <li>One of the following strings: "<code title="">vertical</code>", "<code title="">vertical-lr</code>".</li>
</ol><p>A <dfn id=websrt-line-position-cue-setting>WebSRT line position cue setting</dfn> consists of the
following components, in the order given:</p>
@@ -27331,9 +27535,15 @@
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> be <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
- direction">horizontal</a>.</li>
+ <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> be <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing
+ direction">vertical growing left</a>.</li>
+ <li><p>Otherwise, if <var title="">value</var> is a
+ <a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical-lr</code>", then let <var title="">cue</var>'s <a href=#timed-track-cue-writing-direction>timed track cue writing
+ direction</a> be <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
+ growing right writing direction">vertical growing
+ right</a>.</li>
+
</ol></dd>
<dt>If <var title="">setting</var> is a U+004C LATIN CAPITAL
Modified: index
===================================================================
--- index 2010-07-02 22:57:06 UTC (rev 5132)
+++ index 2010-07-07 23:30:24 UTC (rev 5133)
@@ -213,7 +213,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<hgroup><h1>HTML5 (including next generation additions still in development)</h1>
- <h2 class="no-num no-toc">Draft Standard — 2 July 2010</h2>
+ <h2 class="no-num no-toc">Draft Standard — 7 July 2010</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -26123,14 +26123,14 @@
<p>A writing direction, either <dfn id=timed-track-cue-horizontal-writing-direction title="timed track cue
horizontal writing direction">horizontal</dfn> (a line extends
horizontally and is positioned vertically, with consecutive lines
- displayed below each other), <dfn id=timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
+ displayed below each other), <dfn id=timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical
+ growing left writing direction">vertical growing left</dfn> (a
+ line extends vertically and is positioned horizontally, with
+ consecutive lines displayed to the left of each other<!-- used
+ for east asian-->), or <dfn id=timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
growing right writing direction">vertical growing right</dfn> (a
line extends vertically and is positioned horizontally, with
- consecutive lines displayed to the right of each other<!-- used
- for east asian-->), or <dfn id=timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical
- growing left writing direction">vertical growing left</dfn> (a
- line extends vertically and is positioned horizontally, with
- consecutive lines displayed to the left of each other<!-- used for
+ consecutive lines displayed to the right of each other<!-- used for
mongolian -->).</p>
<p>If the <a href=#timed-track-cue-writing-direction title="timed track cue writing direction">writing
@@ -26628,14 +26628,6 @@
<h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
-<!--
- // timed tracks
- readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>;
- <span>MutableTimedTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
-
- - addTrack should add it as Loaded, Disabled, and with the rules for WebSRT.
--->
-
<pre class=idl>interface <dfn id=timedtrack>TimedTrack</dfn> {
readonly attribute DOMString <span title=dom-TimedTrack-kind>kind</span>;
readonly attribute DOMString <span title=dom-TimedTrack-label>label</span>;
@@ -26668,10 +26660,10 @@
interface <dfn id=timedtrackcuelist>TimedTrackCueList</dfn> {
readonly attribute unsigned long <span title=dom-TimedTrackCueList-length>length</span>;
getter <a href=#timedtrackcue>TimedTrackCue</a> (in unsigned long index);
- <a href=#timedtrackcue>TimedTrackCue</a> getCueById(in DOMString id);
+ <a href=#timedtrackcue>TimedTrackCue</a> <span title=dom-TimedTrackCueList-getCueById>getCueById</span>(in DOMString id);
};
-[Constructor(in DOMString id, in float startTime, in float endTime, in DOMString settings, in DOMString text, in optional boolean pauseOnExit)]
+[<span title=dom-TimedTrackCue>Constructor</span>(in DOMString id, in float startTime, in float endTime, in DOMString text, in optional DOMString settings, in optional DOMString voice, in optional boolean pauseOnExit)]
interface <dfn id=timedtrackcue>TimedTrackCue</dfn> {
readonly attribute <a href=#timedtrack>TimedTrack</a> <span title=dom-TimedTrackCue-track>track</span>;
readonly attribute DOMString <span title=dom-TimedTrackCue-id>id</span>;
@@ -26700,7 +26692,7 @@
<p>Returns the number of timed tracks associated with the element (e.g. from <code><a href=#the-track-element>track</a></code> elements).</p>
</dd>
- <dt><var title="">media</var> . <code title=dom-media-tracks>tracks[<var title="">n</var>]</code></dt>
+ <dt><var title="">media</var> . <code title=dom-media-tracks>tracks[</code> <var title="">n</var> <code title="">]</code></dt>
<dd>
<p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <var title="">n</var>th timed track.</p>
</dd>
@@ -26710,13 +26702,214 @@
<p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <code><a href=#the-track-element>track</a></code> element's timed track.</p>
</dd>
- <dt class=XXX>...</dt>
- <dd class=XXX>...</dd>
+ </dl><dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-kind>kind</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-kind>timed track kind</a> string.</p>
+ </dd>
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-label>label</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-label>timed track label</a>.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-language>language</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-language>timed track language</a> string.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-readyState>readyState</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-readiness-state>timed track readiness state</a>,
+ represented by a number from the following list:</p>
+ <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-NONE>NONE</code> (0)</dt>
+ <dd>
+ <p>The <a href=#timed-track-not-loaded>timed track not loaded</a> state.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADING>LOADING</code> (1)</dt>
+ <dd>
+ <p>The <a href=#timed-track-loading>timed track loading</a> state.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADED>LOADED</code> (2)</dt>
+ <dd>
+ <p>The <a href=#timed-track-loaded>timed track loaded</a> state.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-ERROR>ERROR</code> (3)</dt>
+ <dd>
+ <p>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</p>
+ </dd>
+ </dl></dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-mode>mode</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-mode>timed track mode</a>, represented by a
+ number from the following list:</p>
+ <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-OFF>OFF</code> (0)</dt>
+ <dd>
+ <p>The <a href=#timed-track-disabled>timed track disabled</a> mode.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-HIDDEN>HIDDEN</code> (0)</dt>
+ <dd>
+ <p>The <a href=#timed-track-hidden>timed track hidden</a> mode.</p>
+ </dd>
+ <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-SHOWING>SHOWING</code> (0)</dt>
+ <dd>
+ <p>The <a href=#timed-track-showing>timed track showing</a> mode.</p>
+ </dd>
+ </dl><p>Can be set, to change the mode.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-cues>cues</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-list-of-cues>timed track list of cues</a>, as a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-activeCues>activeCues</code></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue title="timed track cue">timed track cues</a> from the <a href=#timed-track-list-of-cues>timed track list of cues</a> that are currently active (i.e. that start before the <a href=#current-playback-position>current playback position</a> and end after it), as a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ </dd>
+
+ </dl><dl class=domintro><dt><var title="">mutableTimedTrack</var> = <var title="">media</var> . <code title=dom-media-addTrack>addTrack</code>( <var title="">label</var>, <var title="">kind</var>, <var title="">language</var> )</dt>
+ <dd>
+ <p>Creates and returns a new <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object, which is also added to the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ </dd>
+
+ <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue>addCue</code>( <var title="">cue</var> )</dt>
+ <dd>
+ <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
+ <!-- XXX exception thrown if the cue is already bound -->
+ </dd>
+
+ <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue>addCue</code>( <var title="">cue</var> )</dt>
+ <dd>
+ <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
+ <!-- XXX exception thrown if it's not there -->
+ </dd>
+
+ </dl><dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-length>length</code></dt>
+ <dd>
+ <p>Returns the number of <a href=#timed-track-cue title="timed track cue">cues</a> in the list.</p>
+ </dd>
+
+ <dt><var title="">cuelist</var>[<var title="">index</var>]</dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue>timed track cue</a> with index <var title="">index</var> in the list. The cues are sorted in <a href=#timed-track-cue-order>timed track cue order</a>.</p>
+ <p>Returns null if <var title="">index</var> is out of range.</p>
+ </dd>
+
+ <dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-getCueById>getCueById</code>( <var title="">id</var> )</dt>
+ <dd>
+ <p>Returns the first <a href=#timed-track-cue>timed track cue</a> (in <a href=#timed-track-cue-order>timed track cue order</a>) with <a href=#timed-track-cue-identifier>timed track cue identifier</a> <var title="">id</var>.</p>
+ <p>Returns null if none of the cues have the given identifier.</p>
+ </dd>
+
+ </dl><dl class=domintro><dt><var title="">cue</var> = new <code title=dom-TimedTrackCue>TimedTrackCue</code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">voice</var> [, <var title="">pauseOnExit</var> ] ] ] )</dt>
+ <dd>
+ <p>Returns a new <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, for use with the <code title=dom-MutableTimedTrack-addCue>addCue()</code> method.</p>
+ <p>The <var title="">id</var> argument sets the <a href=#timed-track-cue-identifier>timed track cue identifier</a>.</p>
+ <p>The <var title="">startTime</var> argument sets the <a href=#timed-track-cue-start-time>timed track cue start time</a>.</p>
+ <p>The <var title="">endTime</var> argument sets the <a href=#timed-track-cue-end-time>timed track cue end time</a>.</p>
+ <p>The <var title="">text</var> argument sets the <a href=#timed-track-cue-text>timed track cue text</a>.</p>
+ <p>The <var title="">settings</var> argument is a string in the format of <a href=#websrt-cue-settings>WebSRT cue settings</a>. If omitted, the empty string is assumed.</p>
+ <p>The <var title="">voice</var> argument sets the <a href=#timed-track-cue-voice-identifier>timed track cue voice identifier</a>. If omitted, the empty string is assumed.</p>
+ <p>The <var title="">pauseOnExit</var> argument sets the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a>. If omitted, false is assumed.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-track>track</span></dt>
+ <dd>
+ <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object to which this
+ <a href=#timed-track-cue>timed track cue</a> belongs, if any, or null
+ otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-id>id</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-identifier>timed track cue identifier</a>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-startTime>startTime</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-start-time>timed track cue start time</a>, in seconds.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-endTime>endTime</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-end-time>timed track cue end time</a>, in seconds.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-pauseOnExit>pauseOnExit</span></dt>
+ <dd>
+ <p>Returns true if the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a> is set, false otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-direction>direction</span></dt>
+ <dd>
+ <p>Returns a string representing the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>, as follows:</p>
+ <dl><dt>If it is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a></dt>
+ <dd><p>The string "<code title="">horizontal</code>".</dd>
+ <dt>If it is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a></dt>
+ <dd><p>The string "<code title="">vertical</code>".</dd>
+ <dt>If it is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a></dt>
+ <dd><p>The string "<code title="">vertical-lr</code>".</dd>
+ </dl></dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-snapToLines>snapToLines</span></dt>
+ <dd>
+ <p>Returns true if the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set, false otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-linePosition>linePosition</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-line-position>timed track cue line position</a>. In the
+ case of the value being <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic
+ line position">auto</a>, the appropriate default is returned.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-textPosition>textPosition</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-size>size</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-size>timed track cue size</a>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-alignment>alignment</span></dt>
+ <dd>
+ <p>Returns a string representing the <a href=#timed-track-cue-alignment>timed track cue alignment</a>, as follows:</p>
+ <dl><dt>If it is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start alignment</a></dt>
+ <dd><p>The string "<code title="">start</code>".</dd>
+ <dt>If it is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle alignment</a></dt>
+ <dd><p>The string "<code title="">middle</code>".</dd>
+ <dt>If it is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end alignment</a></dt>
+ <dd><p>The string "<code title="">end</code>".</dd>
+ </dl></dd>
+
+ <dt><var title="">cue</var> . <span title=dom-TimedTrackCue-voice>voice</span></dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-voice-identifier>timed track cue voice identifier</a>.</p>
+ </dd>
+
+ <dt><var title="">source</var> = <var title="">cue</var> . <span title=dom-TimedTrackCue-getCueAsSource>getCueAsSource</span>()</dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-text>timed track cue text</a> in raw unparsed form.</p>
+ </dd>
+
+ <dt><var title="">fragment</var> = <var title="">cue</var> . <span title=dom-TimedTrackCue-getCueAsHTML>getCueAsHTML</span>()</dt>
+ <dd>
+ <p>Returns the <a href=#timed-track-cue-text>timed 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>
+ </dd>
+
</dl><div class=impl>
<p class=XXX>...
+<!-- XXX
+ - readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>;
+ - <span>MutableTimedTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
+ - addTrack should add it as Loaded, Disabled, and with the rules for WebSRT.
+-->
+
<!-- XXX
Make sure that .cues and .activeCues doesn't change while script is
running, except for addCue/removeCue and the removal of all cues in
@@ -26737,6 +26930,17 @@
<h6 id=cue-events><span class=secno>4.8.10.10.6 </span>Event definitions</h6>
+<!-- XXX
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-onload">onload</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-onerror">onerror</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-oncuechange">oncuechange</span>;
+-->
+
+<!-- XXX
+ readonly attribute <span>Function</span> <span title="dom-TimedTrackCue-onenter">onenter</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrackCue-onexit">onexit</span>;
+-->
+
<p class=XXX>...
@@ -26860,7 +27064,7 @@
component must not be included more than once per <a href=#websrt-cue-settings>WebSRT cue
settings</a> string.</p>
- <ul class=brief><li>A <a href=#websrt-vertical-text-cue-setting>WebSRT vertical text cue setting</a>.</li> <!-- D:vertical -->
+ <ul class=brief><li>A <a href=#websrt-vertical-text-cue-setting>WebSRT vertical text cue setting</a>.</li> <!-- D:vertical/vertical-lr -->
<li>A <a href=#websrt-line-position-cue-setting>WebSRT line position cue setting</a>.</li> <!-- L:100% L:1 L:-1 -->
<li>A <a href=#websrt-text-position-cue-setting>WebSRT text position cue setting</a>.</li> <!-- T:100% -->
<li>A <a href=#websrt-size-cue-setting>WebSRT size cue setting</a>.</li> <!-- S:100% -->
@@ -26870,7 +27074,7 @@
<ol><li>A U+0044 LATIN CAPITAL LETTER D character.</li>
<li>A U+003A COLON character (:).</li>
- <li>The string "<code title="">vertical</code>".</li>
+ <li>One of the following strings: "<code title="">vertical</code>", "<code title="">vertical-lr</code>".</li>
</ol><p>A <dfn id=websrt-line-position-cue-setting>WebSRT line position cue setting</dfn> consists of the
following components, in the order given:</p>
@@ -27258,9 +27462,15 @@
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> be <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
- direction">horizontal</a>.</li>
+ <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> be <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing
+ direction">vertical growing left</a>.</li>
+ <li><p>Otherwise, if <var title="">value</var> is a
+ <a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical-lr</code>", then let <var title="">cue</var>'s <a href=#timed-track-cue-writing-direction>timed track cue writing
+ direction</a> be <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
+ growing right writing direction">vertical growing
+ right</a>.</li>
+
</ol></dd>
<dt>If <var title="">setting</var> is a U+004C LATIN CAPITAL
Modified: source
===================================================================
--- source 2010-07-02 22:57:06 UTC (rev 5132)
+++ source 2010-07-07 23:30:24 UTC (rev 5133)
@@ -28355,13 +28355,13 @@
horizontal writing direction">horizontal</dfn> (a line extends
horizontally and is positioned vertically, with consecutive lines
displayed below each other), <dfn title="timed track cue vertical
- growing right writing direction">vertical growing right</dfn> (a
+ growing left writing direction">vertical growing left</dfn> (a
line extends vertically and is positioned horizontally, with
- consecutive lines displayed to the right of each other<!-- used
+ consecutive lines displayed to the left of each other<!-- used
for east asian-->), or <dfn title="timed track cue vertical
- growing left writing direction">vertical growing left</dfn> (a
+ growing right writing direction">vertical growing right</dfn> (a
line extends vertically and is positioned horizontally, with
- consecutive lines displayed to the left of each other<!-- used for
+ consecutive lines displayed to the right of each other<!-- used for
mongolian -->).</p>
<p>If the <span title="timed track cue writing direction">writing
@@ -28923,14 +28923,6 @@
<h6>Timed track API</h6>
-<!--
- // timed tracks
- readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>;
- <span>MutableTimedTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
-
- - addTrack should add it as Loaded, Disabled, and with the rules for WebSRT.
--->
-
<pre class="idl">interface <dfn>TimedTrack</dfn> {
readonly attribute DOMString <span title="dom-TimedTrack-kind">kind</span>;
readonly attribute DOMString <span title="dom-TimedTrack-label">label</span>;
@@ -28963,10 +28955,10 @@
interface <dfn>TimedTrackCueList</dfn> {
readonly attribute unsigned long <span title="dom-TimedTrackCueList-length">length</span>;
getter <span>TimedTrackCue</span> (in unsigned long index);
- <span>TimedTrackCue</span> getCueById(in DOMString id);
+ <span>TimedTrackCue</span> <span title="dom-TimedTrackCueList-getCueById">getCueById</span>(in DOMString id);
};
-[Constructor(in DOMString id, in float startTime, in float endTime, in DOMString settings, in DOMString text, in optional boolean pauseOnExit)]
+[<span title="dom-TimedTrackCue">Constructor</span>(in DOMString id, in float startTime, in float endTime, in DOMString text, in optional DOMString settings, in optional DOMString voice, in optional boolean pauseOnExit)]
interface <dfn>TimedTrackCue</dfn> {
readonly attribute <span>TimedTrack</span> <span title="dom-TimedTrackCue-track">track</span>;
readonly attribute DOMString <span title="dom-TimedTrackCue-id">id</span>;
@@ -28997,7 +28989,7 @@
<p>Returns the number of timed tracks associated with the element (e.g. from <code>track</code> elements).</p>
</dd>
- <dt><var title="">media</var> . <code title="dom-media-tracks">tracks[<var title="">n</var>]</code></dt>
+ <dt><var title="">media</var> . <code title="dom-media-tracks">tracks[</code> <var title="">n</var> <code title="">]</code></dt>
<dd>
<p>Returns the <code>TimedTrack</code> object representing the <var title="">n</var>th timed track.</p>
</dd>
@@ -29007,15 +28999,240 @@
<p>Returns the <code>TimedTrack</code> object representing the <code>track</code> element's timed track.</p>
</dd>
- <dt class="XXX">...</dt>
- <dd class="XXX">...</dd>
+ </dl>
+ <dl class="domintro">
+
+ <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-kind">kind</code></dt>
+ <dd>
+ <p>Returns the <span>timed track kind</span> string.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-label">label</code></dt>
+ <dd>
+ <p>Returns the <span>timed track label</span>.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-language">language</code></dt>
+ <dd>
+ <p>Returns the <span>timed track language</span> string.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-readyState">readyState</code></dt>
+ <dd>
+ <p>Returns the <span>timed track readiness state</span>,
+ represented by a number from the following list:</p>
+ <dl>
+ <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-NONE">NONE</code> (0)</dt>
+ <dd>
+ <p>The <span>timed track not loaded</span> state.</p>
+ </dd>
+ <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-LOADING">LOADING</code> (1)</dt>
+ <dd>
+ <p>The <span>timed track loading</span> state.</p>
+ </dd>
+ <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-LOADED">LOADED</code> (2)</dt>
+ <dd>
+ <p>The <span>timed track loaded</span> state.</p>
+ </dd>
+ <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-ERROR">ERROR</code> (3)</dt>
+ <dd>
+ <p>The <span>timed track failed to load</span> state.</p>
+ </dd>
+ </dl>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-mode">mode</code></dt>
+ <dd>
+ <p>Returns the <span>timed track mode</span>, represented by a
+ number from the following list:</p>
+ <dl>
+ <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-OFF">OFF</code> (0)</dt>
+ <dd>
+ <p>The <span>timed track disabled</span> mode.</p>
+ </dd>
+ <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-HIDDEN">HIDDEN</code> (0)</dt>
+ <dd>
+ <p>The <span>timed track hidden</span> mode.</p>
+ </dd>
+ <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-SHOWING">SHOWING</code> (0)</dt>
+ <dd>
+ <p>The <span>timed track showing</span> mode.</p>
+ </dd>
+ </dl>
+ <p>Can be set, to change the mode.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-cues">cues</code></dt>
+ <dd>
+ <p>Returns the <span>timed track list of cues</span>, as a <code>TimedTrackCueList</code> object.</p>
+ </dd>
+
+ <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-activeCues">activeCues</code></dt>
+ <dd>
+ <p>Returns the <span title="timed track cue">timed track cues</span> from the <span>timed track list of cues</span> that are currently active (i.e. that start before the <span>current playback position</span> and end after it), as a <code>TimedTrackCueList</code> object.</p>
+ </dd>
+
</dl>
+ <dl class="domintro">
+
+ <dt><var title="">mutableTimedTrack</var> = <var title="">media</var> . <code title="dom-media-addTrack">addTrack</code>( <var title="">label</var>, <var title="">kind</var>, <var title="">language</var> )</dt>
+ <dd>
+ <p>Creates and returns a new <code>MutableTimedTrack</code> object, which is also added to the <span>media element</span>'s <span>list of timed tracks</span>.</p>
+ </dd>
+
+ <dt><var title="">mutableTimedTrack</var> . <code title="dom-MutableTimedTrack-addCue">addCue</code>( <var title="">cue</var> )</dt>
+ <dd>
+ <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <span>timed track list of cues</span>.</p>
+ <!-- XXX exception thrown if the cue is already bound -->
+ </dd>
+
+ <dt><var title="">mutableTimedTrack</var> . <code title="dom-MutableTimedTrack-addCue">addCue</code>( <var title="">cue</var> )</dt>
+ <dd>
+ <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <span>timed track list of cues</span>.</p>
+ <!-- XXX exception thrown if it's not there -->
+ </dd>
+
+ </dl>
+
+ <dl class="domintro">
+
+ <dt><var title="">cuelist</var> . <code title="dom-TimedTrackCueList-length">length</code></dt>
+ <dd>
+ <p>Returns the number of <span title="timed track cue">cues</span> in the list.</p>
+ </dd>
+
+ <dt><var title="">cuelist</var>[<var title="">index</var>]</dt>
+ <dd>
+ <p>Returns the <span>timed track cue</span> with index <var title="">index</var> in the list. The cues are sorted in <span>timed track cue order</span>.</p>
+ <p>Returns null if <var title="">index</var> is out of range.</p>
+ </dd>
+
+ <dt><var title="">cuelist</var> . <code title="dom-TimedTrackCueList-getCueById">getCueById</code>( <var title="">id</var> )</dt>
+ <dd>
+ <p>Returns the first <span>timed track cue</span> (in <span>timed track cue order</span>) with <span>timed track cue identifier</span> <var title="">id</var>.</p>
+ <p>Returns null if none of the cues have the given identifier.</p>
+ </dd>
+
+ </dl>
+
+ <dl class="domintro">
+
+ <dt><var title="">cue</var> = new <code title="dom-TimedTrackCue">TimedTrackCue</code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">voice</var> [, <var title="">pauseOnExit</var> ] ] ] )</dt>
+ <dd>
+ <p>Returns a new <code>TimedTrackCue</code> object, for use with the <code title="dom-MutableTimedTrack-addCue">addCue()</code> method.</p>
+ <p>The <var title="">id</var> argument sets the <span>timed track cue identifier</span>.</p>
+ <p>The <var title="">startTime</var> argument sets the <span>timed track cue start time</span>.</p>
+ <p>The <var title="">endTime</var> argument sets the <span>timed track cue end time</span>.</p>
+ <p>The <var title="">text</var> argument sets the <span>timed track cue text</span>.</p>
+ <p>The <var title="">settings</var> argument is a string in the format of <span>WebSRT cue settings</span>. If omitted, the empty string is assumed.</p>
+ <p>The <var title="">voice</var> argument sets the <span>timed track cue voice identifier</span>. If omitted, the empty string is assumed.</p>
+ <p>The <var title="">pauseOnExit</var> argument sets the <span>timed track cue pause-on-exit flag</span>. If omitted, false is assumed.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-track">track</span></dt>
+ <dd>
+ <p>Returns the <code>TimedTrack</code> object to which this
+ <span>timed track cue</span> belongs, if any, or null
+ otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-id">id</span></dt>
+ <dd>
+ <p>Returns the <span>timed track cue identifier</span>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-startTime">startTime</span></dt>
+ <dd>
+ <p>Returns the <span>timed track cue start time</span>, in seconds.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-endTime">endTime</span></dt>
+ <dd>
+ <p>Returns the <span>timed track cue end time</span>, in seconds.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-pauseOnExit">pauseOnExit</span></dt>
+ <dd>
+ <p>Returns true if the <span>timed track cue pause-on-exit flag</span> is set, false otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-direction">direction</span></dt>
+ <dd>
+ <p>Returns a string representing the <span>timed track cue writing direction</span>, as follows:</p>
+ <dl>
+ <dt>If it is <span title="timed track cue horizontal writing direction">horizontal</span></dt>
+ <dd><p>The string "<code title="">horizontal</code>".</p></dd>
+ <dt>If it is <span title="timed track cue vertical growing left writing direction">vertical growing left</span></dt>
+ <dd><p>The string "<code title="">vertical</code>".</p></dd>
+ <dt>If it is <span title="timed track cue vertical growing right writing direction">vertical growing right</span></dt>
+ <dd><p>The string "<code title="">vertical-lr</code>".</p></dd>
+ </dl>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-snapToLines">snapToLines</span></dt>
+ <dd>
+ <p>Returns true if the <span>timed track cue snap-to-lines flag</span> is set, false otherwise.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-linePosition">linePosition</span></dt>
+ <dd>
+ <p>Returns the <span>timed track cue line position</span>. In the
+ case of the value being <span title="timed track cue automatic
+ line position">auto</span>, the appropriate default is returned.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-textPosition">textPosition</span></dt>
+ <dd>
+ <p>Returns the <span>timed track cue text position</span>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-size">size</span></dt>
+ <dd>
+ <p>Returns the <span>timed track cue size</span>.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-alignment">alignment</span></dt>
+ <dd>
+ <p>Returns a string representing the <span>timed track cue alignment</span>, as follows:</p>
+ <dl>
+ <dt>If it is <span title="timed track cue start alignment">start alignment</span></dt>
+ <dd><p>The string "<code title="">start</code>".</p></dd>
+ <dt>If it is <span title="timed track cue middle alignment">middle alignment</span></dt>
+ <dd><p>The string "<code title="">middle</code>".</p></dd>
+ <dt>If it is <span title="timed track cue end alignment">end alignment</span></dt>
+ <dd><p>The string "<code title="">end</code>".</p></dd>
+ </dl>
+ </dd>
+
+ <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-voice">voice</span></dt>
+ <dd>
+ <p>Returns the <span>timed track cue voice identifier</span>.</p>
+ </dd>
+
+ <dt><var title="">source</var> = <var title="">cue</var> . <span title="dom-TimedTrackCue-getCueAsSource">getCueAsSource</span>()</dt>
+ <dd>
+ <p>Returns the <span>timed track cue text</span> in raw unparsed form.</p>
+ </dd>
+
+ <dt><var title="">fragment</var> = <var title="">cue</var> . <span title="dom-TimedTrackCue-getCueAsHTML">getCueAsHTML</span>()</dt>
+ <dd>
+ <p>Returns the <span>timed track cue text</span> as a <code>DocumentFragment</code> of <span>HTML elements</span> and other DOM nodes.</p>
+ </dd>
+
+ </dl>
+
<div class="impl">
<p class="XXX">...
+<!-- XXX
+ - readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>;
+ - <span>MutableTimedTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
+ - addTrack should add it as Loaded, Disabled, and with the rules for WebSRT.
+-->
+
<!-- XXX
Make sure that .cues and .activeCues doesn't change while script is
running, except for addCue/removeCue and the removal of all cues in
@@ -29036,6 +29253,17 @@
<h6 id="cue-events">Event definitions</h6>
+<!-- XXX
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-onload">onload</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-onerror">onerror</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrack-oncuechange">oncuechange</span>;
+-->
+
+<!-- XXX
+ readonly attribute <span>Function</span> <span title="dom-TimedTrackCue-onenter">onenter</span>;
+ readonly attribute <span>Function</span> <span title="dom-TimedTrackCue-onexit">onexit</span>;
+-->
+
<p class="XXX">...
@@ -29200,7 +29428,7 @@
settings</span> string.</p>
<ul class="brief">
- <li>A <span>WebSRT vertical text cue setting</span>.</li> <!-- D:vertical -->
+ <li>A <span>WebSRT vertical text cue setting</span>.</li> <!-- D:vertical/vertical-lr -->
<li>A <span>WebSRT line position cue setting</span>.</li> <!-- L:100% L:1 L:-1 -->
<li>A <span>WebSRT text position cue setting</span>.</li> <!-- T:100% -->
<li>A <span>WebSRT size cue setting</span>.</li> <!-- S:100% -->
@@ -29213,7 +29441,7 @@
<ol>
<li>A U+0044 LATIN CAPITAL LETTER D character.</li>
<li>A U+003A COLON character (:).</li>
- <li>The string "<code title="">vertical</code>".</li>
+ <li>One of the following strings: "<code title="">vertical</code>", "<code title="">vertical-lr</code>".</li>
</ol>
<p>A <dfn>WebSRT line position cue setting</dfn> consists of the
@@ -29679,9 +29907,17 @@
<span>case-sensitive</span> match for the string "<code
title="">vertical</code>", then let <var title="">cue</var>'s
<span>timed track cue writing direction</span> be <span
- title="timed track cue horizontal writing
- direction">horizontal</span>.</p></li>
+ title="timed track cue vertical growing left writing
+ direction">vertical growing left</span>.</p></li>
+ <li><p>Otherwise, if <var title="">value</var> is a
+ <span>case-sensitive</span> match for the string "<code
+ title="">vertical-lr</code>", then let <var
+ title="">cue</var>'s <span>timed track cue writing
+ direction</span> be <span title="timed track cue vertical
+ growing right writing direction">vertical growing
+ right</span>.</p></li>
+
</ol>
</dd>
More information about the Commit-Watchers
mailing list