[html5] r5142 - [giow] (0) Captions - Stage 20.5: more wip for API definitions.
whatwg at whatwg.org
whatwg at whatwg.org
Thu Jul 8 12:56:03 PDT 2010
Author: ianh
Date: 2010-07-08 12:56:02 -0700 (Thu, 08 Jul 2010)
New Revision: 5142
Modified:
complete.html
index
source
Log:
[giow] (0) Captions - Stage 20.5: more wip for API definitions.
Modified: complete.html
===================================================================
--- complete.html 2010-07-08 18:59:31 UTC (rev 5141)
+++ complete.html 2010-07-08 19:56:02 UTC (rev 5142)
@@ -26916,14 +26916,15 @@
</dl><p>If the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents is
not the <a href=#timed-track-disabled>timed track disabled</a> mode, then the <dfn id=dom-timedtrack-cues title=dom-TimedTrack-cues><code>cues</code></dfn> attribute must
- return a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object that represents the
- subset of the <a href=#timed-track-list-of-cues>timed track list of cues</a> of the
- <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
- represents whose <a href=#timed-track-cue-start-time title="timed track cue start time">start
- times</a> occur before the <a href=#earliest-possible-position-when-the-script-started>earliest possible position when
- the script started</a>, in <a href=#timed-track-cue-order>timed track cue
- order</a>. Otherwise, it must return null. When an object is
- returned, the same object must be returned each time.</p>
+ return a <a href=#live>live</a> <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object
+ that represents the subset of the <a href=#timed-track-list-of-cues>timed track list of
+ cues</a> of the <a href=#timed-track>timed track</a> that the
+ <code><a href=#timedtrack>TimedTrack</a></code> object represents whose <a href=#timed-track-cue-start-time title="timed
+ track cue start time">start times</a> occur before the
+ <a href=#earliest-possible-position-when-the-script-started>earliest possible position when the script started</a>, in
+ <a href=#timed-track-cue-order>timed track cue order</a>. Otherwise, it must return
+ null. When an object is returned, the same object must be returned
+ each time.</p>
<p>The <dfn id=earliest-possible-position-when-the-script-started>earliest possible position when the script started</dfn>
is whatever the <a href=#earliest-possible-position>earliest possible position</a> was the last
@@ -26932,16 +26933,17 @@
<p>If the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents is
not the <a href=#timed-track-disabled>timed track disabled</a> mode, then the <dfn id=dom-timedtrack-activecues title=dom-TimedTrack-activeCues><code>activeCues</code></dfn>
- attribute must return a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object that
- represents the subset of the <a href=#timed-track-list-of-cues>timed track list of cues</a>
- of the <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code>
- object represents whose <a href=#timed-track-cue-start-time title="timed track cue start
- time">start times</a> occur before the <a href=#current-playback-position-when-the-script-started>current playback
- position when the script started</a> and whose <a href=#timed-track-cue-end-time title="timed
- track cue end time">end times</a> occur after the <a href=#current-playback-position-when-the-script-started>current
- playback position when the script started</a>, in <a href=#timed-track-cue-order>timed
- track cue order</a>. Otherwise, it must return null. When an
- object is returned, the same object must be returned each time.</p>
+ attribute must return a <a href=#live>live</a>
+ <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object that represents the subset of
+ the <a href=#timed-track-list-of-cues>timed track list of cues</a> of the <a href=#timed-track>timed
+ track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents
+ whose <a href=#timed-track-cue-start-time title="timed track cue start time">start times</a>
+ occur before the <a href=#current-playback-position-when-the-script-started>current playback position when the script
+ started</a> and whose <a href=#timed-track-cue-end-time title="timed track cue end time">end
+ times</a> occur after the <a href=#current-playback-position-when-the-script-started>current playback position when
+ the script started</a>, in <a href=#timed-track-cue-order>timed track cue
+ order</a>. Otherwise, it must return null. When an object is
+ returned, the same object must be returned each time.</p>
<p>The <dfn id=current-playback-position-when-the-script-started>current playback position when the script started</dfn>
is whatever the <a href=#current-playback-position>current playback position</a> was the last
@@ -27064,12 +27066,12 @@
</ol></div>
<hr><pre class=idl>interface <dfn id=timedtrackcuelist>TimedTrackCueList</dfn> {
- readonly attribute unsigned long <span title=dom-TimedTrackCueList-length>length</span>;
+ readonly attribute unsigned long <a href=#dom-timedtrackcuelist-length title=dom-TimedTrackCueList-length>length</a>;
getter <a href=#timedtrackcue>TimedTrackCue</a> (in unsigned long index);
- <a href=#timedtrackcue>TimedTrackCue</a> <span title=dom-TimedTrackCueList-getCueById>getCueById</span>(in DOMString id);
+ <a href=#timedtrackcue>TimedTrackCue</a> <a href=#dom-timedtrackcuelist-getcuebyid title=dom-TimedTrackCueList-getCueById>getCueById</a>(in DOMString id);
};</pre>
- <dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-length>length</code></dt>
+ <dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-length><a href=#dom-timedtrackcuelist-length>length</a></code></dt>
<dd>
<p>Returns the number of <a href=#timed-track-cue title="timed track cue">cues</a> in the list.</p>
</dd>
@@ -27077,10 +27079,9 @@
<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>
+ <dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-getCueById><a href=#dom-timedtrackcuelist-getcuebyid>getCueById</a></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>
@@ -27088,8 +27089,34 @@
</dl><div class=impl>
- <p class=XXX>...</p>
+ <p>A <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object represents a dynamically
+ updating list of <a href=#timed-track-cue title="timed track cue">timed track
+ cues</a> in a given order.</p>
+ <p>The <dfn id=dom-timedtrackcuelist-length title=dom-TimedTrackCueList-length><code>length</code></dfn>
+ attribute must return the number of <a href=#timed-track-cue title="timed track
+ cue">cues</a> in the list represented by the
+ <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+
+ <p>The <span>supported property indicies</span> of a
+ <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object at any instant are the numbers
+ from zero to the number of <a href=#timed-track-cue title="timed track cue">cues</a>
+ in the list represented by the <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object
+ minus one, if any. If there are no <a href=#timed-track-cue title="timed track
+ cue">cues</a> in the list, there are no <span>supported property
+ indicies</span>.</p>
+
+ <p>To <span>determine the value of an indexed property</span> for a
+ given index <var title="">index</var>, the user agent must return
+ the <var title="">index</var>th <a href=#timed-track-cue>timed track cue</a> in the
+ list represented by the <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+
+ <p>The <dfn id=dom-timedtrackcuelist-getcuebyid title=dom-TimedTrackCueList-getCueById><code>getCueById(<var title="">id</var>)</code></dfn> method must return the first
+ <a href=#timed-track-cue>timed track cue</a> in the list represented by the
+ <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object whose <a href=#timed-track-cue-identifier>timed track cue
+ identifier</a> is <var title="">id</var>, if any, or null
+ otherwise.</p>
+
</div>
<hr><pre class=idl>[<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)]
Modified: index
===================================================================
--- index 2010-07-08 18:59:31 UTC (rev 5141)
+++ index 2010-07-08 19:56:02 UTC (rev 5142)
@@ -26843,14 +26843,15 @@
</dl><p>If the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents is
not the <a href=#timed-track-disabled>timed track disabled</a> mode, then the <dfn id=dom-timedtrack-cues title=dom-TimedTrack-cues><code>cues</code></dfn> attribute must
- return a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object that represents the
- subset of the <a href=#timed-track-list-of-cues>timed track list of cues</a> of the
- <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
- represents whose <a href=#timed-track-cue-start-time title="timed track cue start time">start
- times</a> occur before the <a href=#earliest-possible-position-when-the-script-started>earliest possible position when
- the script started</a>, in <a href=#timed-track-cue-order>timed track cue
- order</a>. Otherwise, it must return null. When an object is
- returned, the same object must be returned each time.</p>
+ return a <a href=#live>live</a> <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object
+ that represents the subset of the <a href=#timed-track-list-of-cues>timed track list of
+ cues</a> of the <a href=#timed-track>timed track</a> that the
+ <code><a href=#timedtrack>TimedTrack</a></code> object represents whose <a href=#timed-track-cue-start-time title="timed
+ track cue start time">start times</a> occur before the
+ <a href=#earliest-possible-position-when-the-script-started>earliest possible position when the script started</a>, in
+ <a href=#timed-track-cue-order>timed track cue order</a>. Otherwise, it must return
+ null. When an object is returned, the same object must be returned
+ each time.</p>
<p>The <dfn id=earliest-possible-position-when-the-script-started>earliest possible position when the script started</dfn>
is whatever the <a href=#earliest-possible-position>earliest possible position</a> was the last
@@ -26859,16 +26860,17 @@
<p>If the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents is
not the <a href=#timed-track-disabled>timed track disabled</a> mode, then the <dfn id=dom-timedtrack-activecues title=dom-TimedTrack-activeCues><code>activeCues</code></dfn>
- attribute must return a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object that
- represents the subset of the <a href=#timed-track-list-of-cues>timed track list of cues</a>
- of the <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code>
- object represents whose <a href=#timed-track-cue-start-time title="timed track cue start
- time">start times</a> occur before the <a href=#current-playback-position-when-the-script-started>current playback
- position when the script started</a> and whose <a href=#timed-track-cue-end-time title="timed
- track cue end time">end times</a> occur after the <a href=#current-playback-position-when-the-script-started>current
- playback position when the script started</a>, in <a href=#timed-track-cue-order>timed
- track cue order</a>. Otherwise, it must return null. When an
- object is returned, the same object must be returned each time.</p>
+ attribute must return a <a href=#live>live</a>
+ <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object that represents the subset of
+ the <a href=#timed-track-list-of-cues>timed track list of cues</a> of the <a href=#timed-track>timed
+ track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents
+ whose <a href=#timed-track-cue-start-time title="timed track cue start time">start times</a>
+ occur before the <a href=#current-playback-position-when-the-script-started>current playback position when the script
+ started</a> and whose <a href=#timed-track-cue-end-time title="timed track cue end time">end
+ times</a> occur after the <a href=#current-playback-position-when-the-script-started>current playback position when
+ the script started</a>, in <a href=#timed-track-cue-order>timed track cue
+ order</a>. Otherwise, it must return null. When an object is
+ returned, the same object must be returned each time.</p>
<p>The <dfn id=current-playback-position-when-the-script-started>current playback position when the script started</dfn>
is whatever the <a href=#current-playback-position>current playback position</a> was the last
@@ -26991,12 +26993,12 @@
</ol></div>
<hr><pre class=idl>interface <dfn id=timedtrackcuelist>TimedTrackCueList</dfn> {
- readonly attribute unsigned long <span title=dom-TimedTrackCueList-length>length</span>;
+ readonly attribute unsigned long <a href=#dom-timedtrackcuelist-length title=dom-TimedTrackCueList-length>length</a>;
getter <a href=#timedtrackcue>TimedTrackCue</a> (in unsigned long index);
- <a href=#timedtrackcue>TimedTrackCue</a> <span title=dom-TimedTrackCueList-getCueById>getCueById</span>(in DOMString id);
+ <a href=#timedtrackcue>TimedTrackCue</a> <a href=#dom-timedtrackcuelist-getcuebyid title=dom-TimedTrackCueList-getCueById>getCueById</a>(in DOMString id);
};</pre>
- <dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-length>length</code></dt>
+ <dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-length><a href=#dom-timedtrackcuelist-length>length</a></code></dt>
<dd>
<p>Returns the number of <a href=#timed-track-cue title="timed track cue">cues</a> in the list.</p>
</dd>
@@ -27004,10 +27006,9 @@
<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>
+ <dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-getCueById><a href=#dom-timedtrackcuelist-getcuebyid>getCueById</a></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>
@@ -27015,8 +27016,34 @@
</dl><div class=impl>
- <p class=XXX>...</p>
+ <p>A <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object represents a dynamically
+ updating list of <a href=#timed-track-cue title="timed track cue">timed track
+ cues</a> in a given order.</p>
+ <p>The <dfn id=dom-timedtrackcuelist-length title=dom-TimedTrackCueList-length><code>length</code></dfn>
+ attribute must return the number of <a href=#timed-track-cue title="timed track
+ cue">cues</a> in the list represented by the
+ <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+
+ <p>The <span>supported property indicies</span> of a
+ <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object at any instant are the numbers
+ from zero to the number of <a href=#timed-track-cue title="timed track cue">cues</a>
+ in the list represented by the <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object
+ minus one, if any. If there are no <a href=#timed-track-cue title="timed track
+ cue">cues</a> in the list, there are no <span>supported property
+ indicies</span>.</p>
+
+ <p>To <span>determine the value of an indexed property</span> for a
+ given index <var title="">index</var>, the user agent must return
+ the <var title="">index</var>th <a href=#timed-track-cue>timed track cue</a> in the
+ list represented by the <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+
+ <p>The <dfn id=dom-timedtrackcuelist-getcuebyid title=dom-TimedTrackCueList-getCueById><code>getCueById(<var title="">id</var>)</code></dfn> method must return the first
+ <a href=#timed-track-cue>timed track cue</a> in the list represented by the
+ <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object whose <a href=#timed-track-cue-identifier>timed track cue
+ identifier</a> is <var title="">id</var>, if any, or null
+ otherwise.</p>
+
</div>
<hr><pre class=idl>[<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)]
Modified: source
===================================================================
--- source 2010-07-08 18:59:31 UTC (rev 5141)
+++ source 2010-07-08 19:56:02 UTC (rev 5142)
@@ -29166,14 +29166,15 @@
track</span> that the <code>TimedTrack</code> object represents is
not the <span>timed track disabled</span> mode, then the <dfn
title="dom-TimedTrack-cues"><code>cues</code></dfn> attribute must
- return a <code>TimedTrackCueList</code> object that represents the
- subset of the <span>timed track list of cues</span> of the
- <span>timed track</span> that the <code>TimedTrack</code> object
- represents whose <span title="timed track cue start time">start
- times</span> occur before the <span>earliest possible position when
- the script started</span>, in <span>timed track cue
- order</span>. Otherwise, it must return null. When an object is
- returned, the same object must be returned each time.</p>
+ return a <span>live</span> <code>TimedTrackCueList</code> object
+ that represents the subset of the <span>timed track list of
+ cues</span> of the <span>timed track</span> that the
+ <code>TimedTrack</code> object represents whose <span title="timed
+ track cue start time">start times</span> occur before the
+ <span>earliest possible position when the script started</span>, in
+ <span>timed track cue order</span>. Otherwise, it must return
+ null. When an object is returned, the same object must be returned
+ each time.</p>
<p>The <dfn>earliest possible position when the script started</dfn>
is whatever the <span>earliest possible position</span> was the last
@@ -29183,16 +29184,17 @@
track</span> that the <code>TimedTrack</code> object represents is
not the <span>timed track disabled</span> mode, then the <dfn
title="dom-TimedTrack-activeCues"><code>activeCues</code></dfn>
- attribute must return a <code>TimedTrackCueList</code> object that
- represents the subset of the <span>timed track list of cues</span>
- of the <span>timed track</span> that the <code>TimedTrack</code>
- object represents whose <span title="timed track cue start
- time">start times</span> occur before the <span>current playback
- position when the script started</span> and whose <span title="timed
- track cue end time">end times</span> occur after the <span>current
- playback position when the script started</span>, in <span>timed
- track cue order</span>. Otherwise, it must return null. When an
- object is returned, the same object must be returned each time.</p>
+ attribute must return a <span>live</span>
+ <code>TimedTrackCueList</code> object that represents the subset of
+ the <span>timed track list of cues</span> of the <span>timed
+ track</span> that the <code>TimedTrack</code> object represents
+ whose <span title="timed track cue start time">start times</span>
+ occur before the <span>current playback position when the script
+ started</span> and whose <span title="timed track cue end time">end
+ times</span> occur after the <span>current playback position when
+ the script started</span>, in <span>timed track cue
+ order</span>. Otherwise, it must return null. When an object is
+ returned, the same object must be returned each time.</p>
<p>The <dfn>current playback position when the script started</dfn>
is whatever the <span>current playback position</span> was the last
@@ -29358,7 +29360,6 @@
<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>
@@ -29371,8 +29372,37 @@
<div class="impl">
- <p class="XXX">...</p>
+ <p>A <code>TimedTrackCueList</code> object represents a dynamically
+ updating list of <span title="timed track cue">timed track
+ cues</span> in a given order.</p>
+ <p>The <dfn
+ title="dom-TimedTrackCueList-length"><code>length</code></dfn>
+ attribute must return the number of <span title="timed track
+ cue">cues</span> in the list represented by the
+ <code>TimedTrackCueList</code> object.</p>
+
+ <p>The <span>supported property indicies</span> of a
+ <code>TimedTrackCueList</code> object at any instant are the numbers
+ from zero to the number of <span title="timed track cue">cues</span>
+ in the list represented by the <code>TimedTrackCueList</code> object
+ minus one, if any. If there are no <span title="timed track
+ cue">cues</span> in the list, there are no <span>supported property
+ indicies</span>.</p>
+
+ <p>To <span>determine the value of an indexed property</span> for a
+ given index <var title="">index</var>, the user agent must return
+ the <var title="">index</var>th <span>timed track cue</span> in the
+ list represented by the <code>TimedTrackCueList</code> object.</p>
+
+ <p>The <dfn
+ title="dom-TimedTrackCueList-getCueById"><code>getCueById(<var
+ title="">id</var>)</code></dfn> method must return the first
+ <span>timed track cue</span> in the list represented by the
+ <code>TimedTrackCueList</code> object whose <span>timed track cue
+ identifier</span> is <var title="">id</var>, if any, or null
+ otherwise.</p>
+
</div>
<hr>
More information about the Commit-Watchers
mailing list