[html5] r6606 - [giow] (0) Have a TextTrackList object instead of a TextTrack[] array, so we can [...]

whatwg at whatwg.org whatwg at whatwg.org
Fri Sep 30 16:03:13 PDT 2011


Author: ianh
Date: 2011-09-30 16:03:12 -0700 (Fri, 30 Sep 2011)
New Revision: 6606

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Have a TextTrackList object instead of a TextTrack[] array, so we can add members to it.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=13358

Modified: complete.html
===================================================================
--- complete.html	2011-09-30 17:45:04 UTC (rev 6605)
+++ complete.html	2011-09-30 23:03:12 UTC (rev 6606)
@@ -26486,7 +26486,7 @@
   // tracks
   readonly attribute <a href=#audiotracklist>AudioTrackList</a> <a href=#dom-media-audiotracks title=dom-media-audioTracks>audioTracks</a>;
   readonly attribute <a href=#videotracklist>VideoTrackList</a> <a href=#dom-media-videotracks title=dom-media-videoTracks>videoTracks</a>;
-  readonly attribute <a href=#texttrack>TextTrack</a>[] <a href=#dom-media-texttracks title=dom-media-textTracks>textTracks</a>;
+  readonly attribute <a href=#texttracklist>TextTrackList</a> <a href=#dom-media-texttracks title=dom-media-textTracks>textTracks</a>;
   <a href=#mutabletexttrack>MutableTextTrack</a> <a href=#dom-media-addtexttrack title=dom-media-addTextTrack>addTextTrack</a>(DOMString kind, optional DOMString label, optional DOMString language);
 };</pre>
 
@@ -31277,6 +31277,11 @@
 
   <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
 
+  <pre class=idl>interface <dfn id=texttracklist>TextTrackList</dfn> {
+  readonly attribute unsigned long <a href=#dom-texttracklist-length title=dom-TextTrackList-length>length</a>;
+  getter <a href=#texttrack>TextTrack</a> (unsigned long index);
+};</pre>
+
   <dl class=domintro><dt><var title="">media</var> . <code title=dom-media-textTracks><a href=#dom-media-texttracks>textTracks</a></code> . <code title="">length</code></dt>
    <dd>
     <p>Returns the number of <a href=#text-track title="text track">text 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=#text-track title="text track">text tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
@@ -31294,18 +31299,36 @@
 
   </dl><div class=impl>
 
-  <p>The <dfn id=dom-media-texttracks title=dom-media-textTracks><code>textTracks</code></dfn>
-  attribute of <a href=#media-element title="media element">media elements</a> must
-  return a <a href=#platform-array-objects title="platform array objects">platform array object</a>
-  for objects of type <code><a href=#texttrack>TextTrack</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>A <code><a href=#texttracklist>TextTrackList</a></code> object represents a dynamically
+  updating list of <a href=#text-track title="text track">text tracks</a> in a
+  given order.</p>
 
-  <p>The array must contain the <code><a href=#texttrack>TextTrack</a></code> objects of the
-  <a href=#text-track title="text track">text tracks</a> in the <a href=#media-element>media
-  element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, in the same
-  order as in the <a href=#list-of-text-tracks>list of text tracks</a>.</p>
+  <p>The <dfn id=dom-media-texttracks title=dom-media-textTracks><code>textTracks</code></dfn> attribute
+  of <a href=#media-element title="media element">media elements</a> must return a
+  <code><a href=#texttracklist>TextTrackList</a></code> object representing the
+  <code><a href=#texttrack>TextTrack</a></code> objects of the <a href=#text-track title="text track">text
+  tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text
+  tracks</a>, in the same order as in the <a href=#list-of-text-tracks>list of text
+  tracks</a>. The same object must be returned each time the
+  attribute is accessed. <a href=#refsWEBIDL>[WEBIDL]</a></p>
 
+  <p>The <dfn id=dom-texttracklist-length title=dom-TextTrackList-length><code>length</code></dfn> attribute
+  of a <code><a href=#texttracklist>TextTrackList</a></code> object must return the number of
+  <a href=#text-track title="text track">text tracks</a> in the list represented
+  by the <code><a href=#texttracklist>TextTrackList</a></code> object.</p>
+
+  <p>The <a href=#supported-property-indices>supported property indices</a> of a
+  <code><a href=#texttracklist>TextTrackList</a></code> object at any instant are the numbers
+  from zero to the number of <a href=#text-track title="text track">text
+  tracks</a> in the list represented by the
+  <code><a href=#texttracklist>TextTrackList</a></code> object minus one, if any. If there are no
+  <a href=#text-track title="text track">text tracks</a> in the list, there are
+  no <a href=#supported-property-indices>supported property indices</a>.</p>
+
+  <p>To <a href=#determine-the-value-of-an-indexed-property>determine the value of an indexed property</a> of a
+  <code><a href=#texttracklist>TextTrackList</a></code> object for a given index <var title="">index</var>, the user agent must return the <var title="">index</var>th <a href=#text-track>text track</a> in the list
+  represented by the <code><a href=#texttracklist>TextTrackList</a></code> object.</p>
+
   </div>
 
   <hr><pre class=idl>interface <dfn id=texttrack>TextTrack</dfn> : <a href=#eventtarget>EventTarget</a> {

Modified: index
===================================================================
--- index	2011-09-30 17:45:04 UTC (rev 6605)
+++ index	2011-09-30 23:03:12 UTC (rev 6606)
@@ -26353,7 +26353,7 @@
   // tracks
   readonly attribute <a href=#audiotracklist>AudioTrackList</a> <a href=#dom-media-audiotracks title=dom-media-audioTracks>audioTracks</a>;
   readonly attribute <a href=#videotracklist>VideoTrackList</a> <a href=#dom-media-videotracks title=dom-media-videoTracks>videoTracks</a>;
-  readonly attribute <a href=#texttrack>TextTrack</a>[] <a href=#dom-media-texttracks title=dom-media-textTracks>textTracks</a>;
+  readonly attribute <a href=#texttracklist>TextTrackList</a> <a href=#dom-media-texttracks title=dom-media-textTracks>textTracks</a>;
   <a href=#mutabletexttrack>MutableTextTrack</a> <a href=#dom-media-addtexttrack title=dom-media-addTextTrack>addTextTrack</a>(DOMString kind, optional DOMString label, optional DOMString language);
 };</pre>
 
@@ -31144,6 +31144,11 @@
 
   <h6 id=text-track-api><span class=secno>4.8.10.12.5 </span>Text track API</h6>
 
+  <pre class=idl>interface <dfn id=texttracklist>TextTrackList</dfn> {
+  readonly attribute unsigned long <a href=#dom-texttracklist-length title=dom-TextTrackList-length>length</a>;
+  getter <a href=#texttrack>TextTrack</a> (unsigned long index);
+};</pre>
+
   <dl class=domintro><dt><var title="">media</var> . <code title=dom-media-textTracks><a href=#dom-media-texttracks>textTracks</a></code> . <code title="">length</code></dt>
    <dd>
     <p>Returns the number of <a href=#text-track title="text track">text 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=#text-track title="text track">text tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
@@ -31161,18 +31166,36 @@
 
   </dl><div class=impl>
 
-  <p>The <dfn id=dom-media-texttracks title=dom-media-textTracks><code>textTracks</code></dfn>
-  attribute of <a href=#media-element title="media element">media elements</a> must
-  return a <a href=#platform-array-objects title="platform array objects">platform array object</a>
-  for objects of type <code><a href=#texttrack>TextTrack</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>A <code><a href=#texttracklist>TextTrackList</a></code> object represents a dynamically
+  updating list of <a href=#text-track title="text track">text tracks</a> in a
+  given order.</p>
 
-  <p>The array must contain the <code><a href=#texttrack>TextTrack</a></code> objects of the
-  <a href=#text-track title="text track">text tracks</a> in the <a href=#media-element>media
-  element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, in the same
-  order as in the <a href=#list-of-text-tracks>list of text tracks</a>.</p>
+  <p>The <dfn id=dom-media-texttracks title=dom-media-textTracks><code>textTracks</code></dfn> attribute
+  of <a href=#media-element title="media element">media elements</a> must return a
+  <code><a href=#texttracklist>TextTrackList</a></code> object representing the
+  <code><a href=#texttrack>TextTrack</a></code> objects of the <a href=#text-track title="text track">text
+  tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text
+  tracks</a>, in the same order as in the <a href=#list-of-text-tracks>list of text
+  tracks</a>. The same object must be returned each time the
+  attribute is accessed. <a href=#refsWEBIDL>[WEBIDL]</a></p>
 
+  <p>The <dfn id=dom-texttracklist-length title=dom-TextTrackList-length><code>length</code></dfn> attribute
+  of a <code><a href=#texttracklist>TextTrackList</a></code> object must return the number of
+  <a href=#text-track title="text track">text tracks</a> in the list represented
+  by the <code><a href=#texttracklist>TextTrackList</a></code> object.</p>
+
+  <p>The <a href=#supported-property-indices>supported property indices</a> of a
+  <code><a href=#texttracklist>TextTrackList</a></code> object at any instant are the numbers
+  from zero to the number of <a href=#text-track title="text track">text
+  tracks</a> in the list represented by the
+  <code><a href=#texttracklist>TextTrackList</a></code> object minus one, if any. If there are no
+  <a href=#text-track title="text track">text tracks</a> in the list, there are
+  no <a href=#supported-property-indices>supported property indices</a>.</p>
+
+  <p>To <a href=#determine-the-value-of-an-indexed-property>determine the value of an indexed property</a> of a
+  <code><a href=#texttracklist>TextTrackList</a></code> object for a given index <var title="">index</var>, the user agent must return the <var title="">index</var>th <a href=#text-track>text track</a> in the list
+  represented by the <code><a href=#texttracklist>TextTrackList</a></code> object.</p>
+
   </div>
 
   <hr><pre class=idl>interface <dfn id=texttrack>TextTrack</dfn> : <a href=#eventtarget>EventTarget</a> {

Modified: source
===================================================================
--- source	2011-09-30 17:45:04 UTC (rev 6605)
+++ source	2011-09-30 23:03:12 UTC (rev 6606)
@@ -28505,7 +28505,7 @@
   // tracks
   readonly attribute <span>AudioTrackList</span> <span title="dom-media-audioTracks">audioTracks</span>;
   readonly attribute <span>VideoTrackList</span> <span title="dom-media-videoTracks">videoTracks</span>;
-  readonly attribute <span>TextTrack</span>[] <span title="dom-media-textTracks">textTracks</span>;
+  readonly attribute <span>TextTrackList</span> <span title="dom-media-textTracks">textTracks</span>;
   <span>MutableTextTrack</span> <span title="dom-media-addTextTrack">addTextTrack</span>(DOMString kind, optional DOMString label, optional DOMString language);
 };</pre>
 
@@ -34118,6 +34118,11 @@
 
   <h6>Text track API</h6>
 
+  <pre class="idl">interface <dfn>TextTrackList</dfn> {
+  readonly attribute unsigned long <span title="dom-TextTrackList-length">length</span>;
+  getter <span>TextTrack</span> (unsigned long index);
+};</pre>
+
   <dl class="domintro">
 
    <dt><var title="">media</var> . <code title="dom-media-textTracks">textTracks</code> . <code title="">length</code></dt>
@@ -34139,19 +34144,40 @@
 
   <div class="impl">
 
-  <p>The <dfn title="dom-media-textTracks"><code>textTracks</code></dfn>
-  attribute of <span title="media element">media elements</span> must
-  return a <span title="platform array objects">platform array object</span>
-  for objects of type <code>TextTrack</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>A <code>TextTrackList</code> object represents a dynamically
+  updating list of <span title="text track">text tracks</span> in a
+  given order.</p>
 
-  <p>The array must contain the <code>TextTrack</code> objects of the
-  <span title="text track">text tracks</span> in the <span>media
-  element</span>'s <span>list of text tracks</span>, in the same
-  order as in the <span>list of text tracks</span>.</p>
+  <p>The <dfn
+  title="dom-media-textTracks"><code>textTracks</code></dfn> attribute
+  of <span title="media element">media elements</span> must return a
+  <code>TextTrackList</code> object representing the
+  <code>TextTrack</code> objects of the <span title="text track">text
+  tracks</span> in the <span>media element</span>'s <span>list of text
+  tracks</span>, in the same order as in the <span>list of text
+  tracks</span>. The same object must be returned each time the
+  attribute is accessed. <a href="#refsWEBIDL">[WEBIDL]</a></p>
 
+  <p>The <dfn
+  title="dom-TextTrackList-length"><code>length</code></dfn> attribute
+  of a <code>TextTrackList</code> object must return the number of
+  <span title="text track">text tracks</span> in the list represented
+  by the <code>TextTrackList</code> object.</p>
+
+  <p>The <span>supported property indices</span> of a
+  <code>TextTrackList</code> object at any instant are the numbers
+  from zero to the number of <span title="text track">text
+  tracks</span> in the list represented by the
+  <code>TextTrackList</code> object minus one, if any. If there are no
+  <span title="text track">text tracks</span> in the list, there are
+  no <span>supported property indices</span>.</p>
+
+  <p>To <span>determine the value of an indexed property</span> of a
+  <code>TextTrackList</code> object for a given index <var
+  title="">index</var>, the user agent must return the <var
+  title="">index</var>th <span>text track</span> in the list
+  represented by the <code>TextTrackList</code> object.</p>
+
   </div>
 
   <hr>




More information about the Commit-Watchers mailing list