[html5] r5137 - [giow] (0) Captions - Stage 20.1: wip for API definitions.

whatwg at whatwg.org whatwg at whatwg.org
Wed Jul 7 23:56:30 PDT 2010


Author: ianh
Date: 2010-07-07 23:56:29 -0700 (Wed, 07 Jul 2010)
New Revision: 5137

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Captions - Stage 20.1: wip for API definitions.

Modified: complete.html
===================================================================
--- complete.html	2010-07-07 23:44:40 UTC (rev 5136)
+++ complete.html	2010-07-08 06:56:29 UTC (rev 5137)
@@ -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 — 7 July 2010</h2>
+    <h2 class="no-num no-toc">Draft Standard — 8 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>-->
@@ -23817,7 +23817,7 @@
            attribute boolean <a href=#dom-media-muted title=dom-media-muted>muted</a>;
 <!--TT-->
   // timed tracks
-  readonly attribute <a href=#timedtrack>TimedTrack</a>[] <span title=dom-media-tracks>tracks</span>;
+  readonly attribute <a href=#timedtrack>TimedTrack</a>[] <a href=#dom-media-tracks title=dom-media-tracks>tracks</a>;
   <a href=#mutabletimedtrack>MutableTimedTrack</a> <span title=dom-media-addTrack>addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
 <!--TT-->
 };</pre>
@@ -26701,41 +26701,47 @@
 
   <h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
 
-  <dl class=domintro><dt><var title="">media</var> . <code title=dom-media-tracks>tracks</code> . <code title="">length</code></dt>
+  <dl class=domintro><dt><var title="">media</var> . <code title=dom-media-tracks><a href=#dom-media-tracks>tracks</a></code> . <code title="">length</code></dt>
    <dd>
-    <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>
+    <p>Returns the number of <a href=#timed-track title="timed track">timed tracks</a> associated with the <a href=#media-element>media element</a> (e.g. from <code><a href=#the-track-element>track</a></code> elements). This is the number of <a href=#timed-track title="timed track">timed tracks</a> in 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="">media</var> . <code title=dom-media-tracks>tracks[</code> <var title="">n</var> <code title="">]</code></dt>
+   <dt><var title="">media</var> . <code title=dom-media-tracks><a href=#dom-media-tracks>tracks[</a></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>
+    <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <var title="">n</var>th <a href=#timed-track>timed track</a> in 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="">track</var> . <code title=dom-track-track><a href=#dom-track-track>track</a></code></dt>
    <dd>
-    <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>
+    <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <code><a href=#the-track-element>track</a></code> element's <a href=#timed-track>timed track</a>.</p>
    </dd>
 
   </dl><div class=impl>
 
-<!-- XXX
- - readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>
--->
+  <p>The <dfn id=dom-media-tracks title=dom-media-tracks><code>tracks</code></dfn>
+  attribute of <a href=#media-element title="media element">media elements</a> must
+  return an <span title="array host objects">array host object</span>
+  for objects of type <code><a href=#timedtrack>TimedTrack</a></code> that is <i>fixed
+  length</i> and <i>read only</i>. The same object must be returned
+  each time the attribute is accessed. <a href=#refsWEBIDL>[WEBIDL]</a></p>
 
-  <p class=XXX>...</p>
+  <p>The array must contain the <code><a href=#timedtrack>TimedTrack</a></code> objects of the
+  <a href=#timed-track title="timed track">timed tracks</a> in the <a href=#media-element>media
+  element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>, in the same
+  order as in the <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
 
   </div>
 
   <hr><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>;
-  readonly attribute DOMString <span title=dom-TimedTrack-language>language</span>;
+  readonly attribute DOMString <a href=#dom-timedtrack-kind title=dom-TimedTrack-kind>kind</a>;
+  readonly attribute DOMString <a href=#dom-timedtrack-label title=dom-TimedTrack-label>label</a>;
+  readonly attribute DOMString <a href=#dom-timedtrack-language title=dom-TimedTrack-language>language</a>;
 
-  const unsigned short <span title=dom-TimedTrack-NONE>NONE</span> = 0;
-  const unsigned short <span title=dom-TimedTrack-LOADING>LOADING</span> = 1;
-  const unsigned short <span title=dom-TimedTrack-LOADED>LOADED</span> = 2;
-  const unsigned short <span title=dom-TimedTrack-ERROR>ERROR</span> = 3;
-  readonly attribute unsigned short <span title=dom-TimedTrack-readyState>readyState</span>;
+  const unsigned short <a href=#dom-timedtrack-none title=dom-TimedTrack-NONE>NONE</a> = 0;
+  const unsigned short <a href=#dom-timedtrack-loading title=dom-TimedTrack-LOADING>LOADING</a> = 1;
+  const unsigned short <a href=#dom-timedtrack-loaded title=dom-TimedTrack-LOADED>LOADED</a> = 2;
+  const unsigned short <a href=#dom-timedtrack-error title=dom-TimedTrack-ERROR>ERROR</a> = 3;
+  readonly attribute unsigned short <a href=#dom-timedtrack-readystate title=dom-TimedTrack-readyState>readyState</a>;
   readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-onload title=handler-TimedTrack-onload>onload</a>;
   readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-onerror title=handler-TimedTrack-onerror>onerror</a>;
 
@@ -26750,38 +26756,38 @@
   readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-oncuechange title=handler-TimedTrack-oncuechange>oncuechange</a>;
 };</pre>
 
-  <dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-kind>kind</code></dt>
+  <dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-kind><a href=#dom-timedtrack-kind>kind</a></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>
+   <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-label><a href=#dom-timedtrack-label>label</a></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>
+   <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-language><a href=#dom-timedtrack-language>language</a></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>
+   <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-readyState><a href=#dom-timedtrack-readystate>readyState</a></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>
+    <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-NONE><a href=#dom-timedtrack-none>NONE</a></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>
+     <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADING><a href=#dom-timedtrack-loading>LOADING</a></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>
+     <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADED><a href=#dom-timedtrack-loaded>LOADED</a></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>
+     <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-ERROR><a href=#dom-timedtrack-error>ERROR</a></code> (3)</dt>
      <dd>
       <p>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</p>
      </dd>
@@ -26818,9 +26824,45 @@
 
   </dl><div class=impl>
 
-  <p class=XXX>...</p>
+  <p>The <dfn id=dom-timedtrack-kind title=dom-TimedTrack-kind><code>kind</code></dfn>
+  attribute must return the <a href=#timed-track-kind>timed track kind</a> of the
+  <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+  represents.</p>
 
-<!-- XXX
+  <p>The <dfn id=dom-timedtrack-label title=dom-TimedTrack-label><code>label</code></dfn>
+  attribute must return the <a href=#timed-track-label>timed track label</a> of the
+  <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+  represents.</p>
+
+  <p>The <dfn id=dom-timedtrack-language title=dom-TimedTrack-language><code>language</code></dfn>
+  attribute must return the <a href=#timed-track-language>timed track language</a> of the
+  <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+  represents.</p>
+
+  <p>The <dfn id=dom-timedtrack-readystate title=dom-TimedTrack-readyState><code>readyState</code></dfn>
+  attribute must return the code corresponding to the <a href=#timed-track-readiness-state>timed
+  track readiness state</a> of the <a href=#timed-track>timed track</a> that
+  the <code><a href=#timedtrack>TimedTrack</a></code> object represents, as defined by the
+  following list:</p>
+
+  <dl><dt><dfn id=dom-timedtrack-none title=dom-TimedTrack-NONE><code>NONE</code></dfn> (numeric value 0)</dt>
+   <dd>The <a href=#timed-track-not-loaded>timed track not loaded</a> state.</dd>
+   <dt><dfn id=dom-timedtrack-loading title=dom-TimedTrack-LOADING><code>LOADING</code></dfn> (numeric value 1)</dt>
+   <dd>The <a href=#timed-track-loading>timed track loading</a> state.</dd>
+   <dt><dfn id=dom-timedtrack-loaded title=dom-TimedTrack-LOADED><code>LOADED</code></dfn> (numeric value 2)</dt>
+   <dd>The <a href=#timed-track-loaded>timed track loaded</a> state.</dd>
+   <dt><dfn id=dom-timedtrack-error title=dom-TimedTrack-ERROR><code>ERROR</code></dfn> (numeric value 3)</dt>
+   <dd>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</dd>
+  </dl><!-- XXX
+
+  const unsigned short <dfn title="dom-TimedTrack-OFF"><code>OFF</code></dfn> = 0
+  const unsigned short <dfn title="dom-TimedTrack-HIDDEN"><code>HIDDEN</code></dfn> = 1
+  const unsigned short <dfn title="dom-TimedTrack-SHOWING"><code>SHOWING</code></dfn> = 2
+           attribute unsigned short <dfn title="dom-TimedTrack-mode"><code>mode</code></dfn>
+
+  readonly attribute <span>TimedTrackCueList</span> <dfn title="dom-TimedTrack-cues"><code>cues</code></dfn>
+  readonly attribute <span>TimedTrackCueList</span> <dfn title="dom-TimedTrack-activeCues"><code>activeCues</code></dfn>
+
    Make sure that .cues and .activeCues doesn't change while script is
    running, except for addCue/removeCue and the removal of all cues in
    the face of a dynamic track.src change.
@@ -26835,10 +26877,8 @@
 
  - <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.
--->
+--></div>
 
-  </div>
-
   <hr><pre class=idl>interface <dfn id=mutabletimedtrack>MutableTimedTrack</dfn> : <a href=#timedtrack>TimedTrack</a> {
  void <span title=dom-MutableTimedTrack-addCue>addCue</span>(in <a href=#timedtrackcue>TimedTrackCue</a> cue);
  void <span title=dom-MutableTimedTrack-removeCue>removeCue</span>(in <a href=#timedtrackcue>TimedTrackCue</a> cue);
@@ -26962,7 +27002,7 @@
    <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>
+    <dl class=switch><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>
@@ -26995,7 +27035,7 @@
    <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>
+    <dl class=switch><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>

Modified: index
===================================================================
--- index	2010-07-07 23:44:40 UTC (rev 5136)
+++ index	2010-07-08 06:56:29 UTC (rev 5137)
@@ -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 — 7 July 2010</h2>
+    <h2 class="no-num no-toc">Draft Standard — 8 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>-->
@@ -23744,7 +23744,7 @@
            attribute boolean <a href=#dom-media-muted title=dom-media-muted>muted</a>;
 <!--TT-->
   // timed tracks
-  readonly attribute <a href=#timedtrack>TimedTrack</a>[] <span title=dom-media-tracks>tracks</span>;
+  readonly attribute <a href=#timedtrack>TimedTrack</a>[] <a href=#dom-media-tracks title=dom-media-tracks>tracks</a>;
   <a href=#mutabletimedtrack>MutableTimedTrack</a> <span title=dom-media-addTrack>addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
 <!--TT-->
 };</pre>
@@ -26628,41 +26628,47 @@
 
   <h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
 
-  <dl class=domintro><dt><var title="">media</var> . <code title=dom-media-tracks>tracks</code> . <code title="">length</code></dt>
+  <dl class=domintro><dt><var title="">media</var> . <code title=dom-media-tracks><a href=#dom-media-tracks>tracks</a></code> . <code title="">length</code></dt>
    <dd>
-    <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>
+    <p>Returns the number of <a href=#timed-track title="timed track">timed tracks</a> associated with the <a href=#media-element>media element</a> (e.g. from <code><a href=#the-track-element>track</a></code> elements). This is the number of <a href=#timed-track title="timed track">timed tracks</a> in 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="">media</var> . <code title=dom-media-tracks>tracks[</code> <var title="">n</var> <code title="">]</code></dt>
+   <dt><var title="">media</var> . <code title=dom-media-tracks><a href=#dom-media-tracks>tracks[</a></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>
+    <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <var title="">n</var>th <a href=#timed-track>timed track</a> in 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="">track</var> . <code title=dom-track-track><a href=#dom-track-track>track</a></code></dt>
    <dd>
-    <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>
+    <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <code><a href=#the-track-element>track</a></code> element's <a href=#timed-track>timed track</a>.</p>
    </dd>
 
   </dl><div class=impl>
 
-<!-- XXX
- - readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>
--->
+  <p>The <dfn id=dom-media-tracks title=dom-media-tracks><code>tracks</code></dfn>
+  attribute of <a href=#media-element title="media element">media elements</a> must
+  return an <span title="array host objects">array host object</span>
+  for objects of type <code><a href=#timedtrack>TimedTrack</a></code> that is <i>fixed
+  length</i> and <i>read only</i>. The same object must be returned
+  each time the attribute is accessed. <a href=#refsWEBIDL>[WEBIDL]</a></p>
 
-  <p class=XXX>...</p>
+  <p>The array must contain the <code><a href=#timedtrack>TimedTrack</a></code> objects of the
+  <a href=#timed-track title="timed track">timed tracks</a> in the <a href=#media-element>media
+  element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>, in the same
+  order as in the <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
 
   </div>
 
   <hr><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>;
-  readonly attribute DOMString <span title=dom-TimedTrack-language>language</span>;
+  readonly attribute DOMString <a href=#dom-timedtrack-kind title=dom-TimedTrack-kind>kind</a>;
+  readonly attribute DOMString <a href=#dom-timedtrack-label title=dom-TimedTrack-label>label</a>;
+  readonly attribute DOMString <a href=#dom-timedtrack-language title=dom-TimedTrack-language>language</a>;
 
-  const unsigned short <span title=dom-TimedTrack-NONE>NONE</span> = 0;
-  const unsigned short <span title=dom-TimedTrack-LOADING>LOADING</span> = 1;
-  const unsigned short <span title=dom-TimedTrack-LOADED>LOADED</span> = 2;
-  const unsigned short <span title=dom-TimedTrack-ERROR>ERROR</span> = 3;
-  readonly attribute unsigned short <span title=dom-TimedTrack-readyState>readyState</span>;
+  const unsigned short <a href=#dom-timedtrack-none title=dom-TimedTrack-NONE>NONE</a> = 0;
+  const unsigned short <a href=#dom-timedtrack-loading title=dom-TimedTrack-LOADING>LOADING</a> = 1;
+  const unsigned short <a href=#dom-timedtrack-loaded title=dom-TimedTrack-LOADED>LOADED</a> = 2;
+  const unsigned short <a href=#dom-timedtrack-error title=dom-TimedTrack-ERROR>ERROR</a> = 3;
+  readonly attribute unsigned short <a href=#dom-timedtrack-readystate title=dom-TimedTrack-readyState>readyState</a>;
   readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-onload title=handler-TimedTrack-onload>onload</a>;
   readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-onerror title=handler-TimedTrack-onerror>onerror</a>;
 
@@ -26677,38 +26683,38 @@
   readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-oncuechange title=handler-TimedTrack-oncuechange>oncuechange</a>;
 };</pre>
 
-  <dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-kind>kind</code></dt>
+  <dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-kind><a href=#dom-timedtrack-kind>kind</a></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>
+   <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-label><a href=#dom-timedtrack-label>label</a></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>
+   <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-language><a href=#dom-timedtrack-language>language</a></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>
+   <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-readyState><a href=#dom-timedtrack-readystate>readyState</a></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>
+    <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-NONE><a href=#dom-timedtrack-none>NONE</a></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>
+     <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADING><a href=#dom-timedtrack-loading>LOADING</a></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>
+     <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADED><a href=#dom-timedtrack-loaded>LOADED</a></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>
+     <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-ERROR><a href=#dom-timedtrack-error>ERROR</a></code> (3)</dt>
      <dd>
       <p>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</p>
      </dd>
@@ -26745,9 +26751,45 @@
 
   </dl><div class=impl>
 
-  <p class=XXX>...</p>
+  <p>The <dfn id=dom-timedtrack-kind title=dom-TimedTrack-kind><code>kind</code></dfn>
+  attribute must return the <a href=#timed-track-kind>timed track kind</a> of the
+  <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+  represents.</p>
 
-<!-- XXX
+  <p>The <dfn id=dom-timedtrack-label title=dom-TimedTrack-label><code>label</code></dfn>
+  attribute must return the <a href=#timed-track-label>timed track label</a> of the
+  <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+  represents.</p>
+
+  <p>The <dfn id=dom-timedtrack-language title=dom-TimedTrack-language><code>language</code></dfn>
+  attribute must return the <a href=#timed-track-language>timed track language</a> of the
+  <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+  represents.</p>
+
+  <p>The <dfn id=dom-timedtrack-readystate title=dom-TimedTrack-readyState><code>readyState</code></dfn>
+  attribute must return the code corresponding to the <a href=#timed-track-readiness-state>timed
+  track readiness state</a> of the <a href=#timed-track>timed track</a> that
+  the <code><a href=#timedtrack>TimedTrack</a></code> object represents, as defined by the
+  following list:</p>
+
+  <dl><dt><dfn id=dom-timedtrack-none title=dom-TimedTrack-NONE><code>NONE</code></dfn> (numeric value 0)</dt>
+   <dd>The <a href=#timed-track-not-loaded>timed track not loaded</a> state.</dd>
+   <dt><dfn id=dom-timedtrack-loading title=dom-TimedTrack-LOADING><code>LOADING</code></dfn> (numeric value 1)</dt>
+   <dd>The <a href=#timed-track-loading>timed track loading</a> state.</dd>
+   <dt><dfn id=dom-timedtrack-loaded title=dom-TimedTrack-LOADED><code>LOADED</code></dfn> (numeric value 2)</dt>
+   <dd>The <a href=#timed-track-loaded>timed track loaded</a> state.</dd>
+   <dt><dfn id=dom-timedtrack-error title=dom-TimedTrack-ERROR><code>ERROR</code></dfn> (numeric value 3)</dt>
+   <dd>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</dd>
+  </dl><!-- XXX
+
+  const unsigned short <dfn title="dom-TimedTrack-OFF"><code>OFF</code></dfn> = 0
+  const unsigned short <dfn title="dom-TimedTrack-HIDDEN"><code>HIDDEN</code></dfn> = 1
+  const unsigned short <dfn title="dom-TimedTrack-SHOWING"><code>SHOWING</code></dfn> = 2
+           attribute unsigned short <dfn title="dom-TimedTrack-mode"><code>mode</code></dfn>
+
+  readonly attribute <span>TimedTrackCueList</span> <dfn title="dom-TimedTrack-cues"><code>cues</code></dfn>
+  readonly attribute <span>TimedTrackCueList</span> <dfn title="dom-TimedTrack-activeCues"><code>activeCues</code></dfn>
+
    Make sure that .cues and .activeCues doesn't change while script is
    running, except for addCue/removeCue and the removal of all cues in
    the face of a dynamic track.src change.
@@ -26762,10 +26804,8 @@
 
  - <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.
--->
+--></div>
 
-  </div>
-
   <hr><pre class=idl>interface <dfn id=mutabletimedtrack>MutableTimedTrack</dfn> : <a href=#timedtrack>TimedTrack</a> {
  void <span title=dom-MutableTimedTrack-addCue>addCue</span>(in <a href=#timedtrackcue>TimedTrackCue</a> cue);
  void <span title=dom-MutableTimedTrack-removeCue>removeCue</span>(in <a href=#timedtrackcue>TimedTrackCue</a> cue);
@@ -26889,7 +26929,7 @@
    <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>
+    <dl class=switch><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>
@@ -26922,7 +26962,7 @@
    <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>
+    <dl class=switch><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>

Modified: source
===================================================================
--- source	2010-07-07 23:44:40 UTC (rev 5136)
+++ source	2010-07-08 06:56:29 UTC (rev 5137)
@@ -2301,7 +2301,7 @@
 
    <li>Authors can use the <code
    title="attr-hyperlink-rel">rel=""</code> mechanism to annotate
-   links with specific meanings by registering <Span
+   links with specific meanings by registering <span
    title="concept-rel-extensions"> extensions to the predefined set of
    link types</span>. This is also used by Microformats.</li>
 
@@ -22855,7 +22855,7 @@
     navigating browsing contexts other than the sandboxed browsing
     context itself</a> (or browsing contexts further nested inside
     it), and the <span>top-level browsing context</span> (which is
-    protected by the <Span>sandboxed top-level navigation browsing
+    protected by the <span>sandboxed top-level navigation browsing
     context flag</span> defined next).</p>
 
     <p>This flag also <a href="#sandboxWindowOpen">prevents content
@@ -28927,28 +28927,35 @@
 
    <dt><var title="">media</var> . <code title="dom-media-tracks">tracks</code> . <code title="">length</code></dt>
    <dd>
-    <p>Returns the number of timed tracks associated with the element (e.g. from <code>track</code> elements).</p>
+    <p>Returns the number of <span title="timed track">timed tracks</span> associated with the <span>media element</span> (e.g. from <code>track</code> elements). This is the number of <span title="timed track">timed tracks</span> in the <span>media element</span>'s <span>list of timed tracks</span>.</p>
    </dd>
 
    <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>
+    <p>Returns the <code>TimedTrack</code> object representing the <var title="">n</var>th <span>timed track</span> in the <span>media element</span>'s <span>list of timed tracks</span>.</p>
    </dd>
 
    <dt><var title="">track</var> . <code title="dom-track-track">track</code></dt>
    <dd>
-    <p>Returns the <code>TimedTrack</code> object representing the <code>track</code> element's timed track.</p>
+    <p>Returns the <code>TimedTrack</code> object representing the <code>track</code> element's <span>timed track</span>.</p>
    </dd>
 
   </dl>
 
   <div class="impl">
 
-<!-- XXX
- - readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>
--->
+  <p>The <dfn title="dom-media-tracks"><code>tracks</code></dfn>
+  attribute of <span title="media element">media elements</span> must
+  return an <span title="array host objects">array host object</span>
+  for objects of type <code>TimedTrack</code> that is <i>fixed
+  length</i> and <i>read only</i>. The same object must be returned
+  each time the attribute is accessed. <a
+  href="#refsWEBIDL">[WEBIDL]</a></p>
 
-  <p class="XXX">...</p>
+  <p>The array must contain the <code>TimedTrack</code> objects of the
+  <span title="timed track">timed tracks</span> in the <span>media
+  element</span>'s <span>list of timed tracks</span>, in the same
+  order as in the <span>list of timed tracks</span>.</p>
 
   </div>
 
@@ -28973,7 +28980,7 @@
            attribute unsigned short <span title="dom-TimedTrack-mode">mode</span>;
 
   readonly attribute <span>TimedTrackCueList</span> <span title="dom-TimedTrack-cues">cues</span>;
-  readonly attribute <Span>TimedTrackCueList</span> <span title="dom-TimedTrack-activeCues">activeCues</span>;
+  readonly attribute <span>TimedTrackCueList</span> <span title="dom-TimedTrack-activeCues">activeCues</span>;
 
   readonly attribute <span>Function</span> <span title="handler-TimedTrack-oncuechange">oncuechange</span>;
 };</pre>
@@ -29054,9 +29061,50 @@
 
   <div class="impl">
 
-  <p class="XXX">...</p>
+  <p>The <dfn title="dom-TimedTrack-kind"><code>kind</code></dfn>
+  attribute must return the <span>timed track kind</span> of the
+  <span>timed track</span> that the <code>TimedTrack</code> object
+  represents.</p>
 
+  <p>The <dfn title="dom-TimedTrack-label"><code>label</code></dfn>
+  attribute must return the <span>timed track label</span> of the
+  <span>timed track</span> that the <code>TimedTrack</code> object
+  represents.</p>
+
+  <p>The <dfn
+  title="dom-TimedTrack-language"><code>language</code></dfn>
+  attribute must return the <span>timed track language</span> of the
+  <span>timed track</span> that the <code>TimedTrack</code> object
+  represents.</p>
+
+  <p>The <dfn
+  title="dom-TimedTrack-readyState"><code>readyState</code></dfn>
+  attribute must return the code corresponding to the <span>timed
+  track readiness state</span> of the <span>timed track</span> that
+  the <code>TimedTrack</code> object represents, as defined by the
+  following list:</p>
+
+  <dl>
+   <dt><dfn title="dom-TimedTrack-NONE"><code>NONE</code></dfn> (numeric value 0)</dt>
+   <dd>The <span>timed track not loaded</span> state.</dd>
+   <dt><dfn title="dom-TimedTrack-LOADING"><code>LOADING</code></dfn> (numeric value 1)</dt>
+   <dd>The <span>timed track loading</span> state.</dd>
+   <dt><dfn title="dom-TimedTrack-LOADED"><code>LOADED</code></dfn> (numeric value 2)</dt>
+   <dd>The <span>timed track loaded</span> state.</dd>
+   <dt><dfn title="dom-TimedTrack-ERROR"><code>ERROR</code></dfn> (numeric value 3)</dt>
+   <dd>The <span>timed track failed to load</span> state.</dd>
+  </dl>
+
 <!-- XXX
+
+  const unsigned short <dfn title="dom-TimedTrack-OFF"><code>OFF</code></dfn> = 0
+  const unsigned short <dfn title="dom-TimedTrack-HIDDEN"><code>HIDDEN</code></dfn> = 1
+  const unsigned short <dfn title="dom-TimedTrack-SHOWING"><code>SHOWING</code></dfn> = 2
+           attribute unsigned short <dfn title="dom-TimedTrack-mode"><code>mode</code></dfn>
+
+  readonly attribute <span>TimedTrackCueList</span> <dfn title="dom-TimedTrack-cues"><code>cues</code></dfn>
+  readonly attribute <span>TimedTrackCueList</span> <dfn title="dom-TimedTrack-activeCues"><code>activeCues</code></dfn>
+
    Make sure that .cues and .activeCues doesn't change while script is
    running, except for addCue/removeCue and the removal of all cues in
    the face of a dynamic track.src change.
@@ -29214,7 +29262,7 @@
    <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>
+    <dl class="switch">
      <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>
@@ -29249,7 +29297,7 @@
    <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>
+    <dl class="switch">
      <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>




More information about the Commit-Watchers mailing list