[html5] r6608 - [giow] (0) Define an event interface for addtrack events. Fixing http://www.w3.o [...]

whatwg at whatwg.org whatwg at whatwg.org
Fri Sep 30 16:27:58 PDT 2011


Author: ianh
Date: 2011-09-30 16:27:56 -0700 (Fri, 30 Sep 2011)
New Revision: 6608

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Define an event interface for addtrack events.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=13358

Modified: complete.html
===================================================================
--- complete.html	2011-09-30 23:12:04 UTC (rev 6607)
+++ complete.html	2011-09-30 23:27:56 UTC (rev 6608)
@@ -596,10 +596,11 @@
          <li><a href=#webvtt-cue-text-dom-construction-rules><span class=secno>4.8.10.13.5 </span>WebVTT cue text DOM construction rules</a></ol></li>
        <li><a href=#user-interface><span class=secno>4.8.10.14 </span>User interface</a></li>
        <li><a href=#time-ranges><span class=secno>4.8.10.15 </span>Time ranges</a></li>
-       <li><a href=#mediaevents><span class=secno>4.8.10.16 </span>Event summary</a></li>
-       <li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.17 </span>Security and privacy considerations</a></li>
-       <li><a href=#best-practices-for-authors-using-media-elements><span class=secno>4.8.10.18 </span>Best practices for authors using media elements</a></li>
-       <li><a href=#best-practices-for-implementors-of-media-elements><span class=secno>4.8.10.19 </span>Best practices for implementors of media elements</a></ol></li>
+       <li><a href=#event-definitions><span class=secno>4.8.10.16 </span>Event definitions</a></li>
+       <li><a href=#mediaevents><span class=secno>4.8.10.17 </span>Event summary</a></li>
+       <li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.18 </span>Security and privacy considerations</a></li>
+       <li><a href=#best-practices-for-authors-using-media-elements><span class=secno>4.8.10.19 </span>Best practices for authors using media elements</a></li>
+       <li><a href=#best-practices-for-implementors-of-media-elements><span class=secno>4.8.10.20 </span>Best practices for implementors of media elements</a></ol></li>
      <li><a href=#the-canvas-element><span class=secno>4.8.11 </span>The <code>canvas</code> element</a>
       <ol>
        <li><a href=#2dcontext><span class=secno>4.8.11.1 </span>The 2D context</a>
@@ -884,7 +885,7 @@
      <li><a href=#scroll-to-fragid><span class=secno>6.5.9 </span>Navigating to a fragment identifier</a></li>
      <li><a href=#history-traversal><span class=secno>6.5.10 </span>History traversal</a>
       <ol>
-       <li><a href=#event-definitions><span class=secno>6.5.10.1 </span>Event definitions</a></ol></li>
+       <li><a href=#event-definitions-0><span class=secno>6.5.10.1 </span>Event definitions</a></ol></li>
      <li><a href=#unloading-documents><span class=secno>6.5.11 </span>Unloading documents</a>
       <ol>
        <li><a href=#event-definition><span class=secno>6.5.11.1 </span>Event definition</a></ol></li>
@@ -1005,7 +1006,7 @@
     <ol>
      <li><a href=#security-considerations><span class=secno>9.5.1 </span>Security considerations</a></ol></li>
    <li><a href=#garbage-collection-0><span class=secno>9.6 </span>Garbage collection</a></li>
-   <li><a href=#event-definitions-0><span class=secno>9.7 </span>Event definitions</a></li>
+   <li><a href=#event-definitions-1><span class=secno>9.7 </span>Event definitions</a></li>
    <li><a href=#mediastreamevents><span class=secno>9.8 </span>Event Summary</a></ol></li>
  <li><a href=#workers><span class=secno>10 </span>Web workers</a>
   <ol>
@@ -1050,7 +1051,7 @@
      <li><a href=#worker-locations><span class=secno>10.3.4 </span>Worker locations</a></ol></ol></li>
  <li><a href=#comms><span class=secno>11 </span>Communication</a>
   <ol>
-   <li><a href=#event-definitions-1><span class=secno>11.1 </span>Event definitions</a></li>
+   <li><a href=#event-definitions-2><span class=secno>11.1 </span>Event definitions</a></li>
    <li><a href=#server-sent-events><span class=secno>11.2 </span>Server-sent events</a>
     <ol>
      <li><a href=#server-sent-events-intro><span class=secno>11.2.1 </span>Introduction</a></li>
@@ -1071,7 +1072,7 @@
      <li><a href=#the-websocket-interface><span class=secno>11.3.2 </span>The <code>WebSocket</code> interface</a></li>
      <li><a href=#feedback-from-the-protocol><span class=secno>11.3.3 </span>Feedback from the protocol</a>
       <ol>
-       <li><a href=#event-definitions-2><span class=secno>11.3.3.1 </span>Event definitions</a></li>
+       <li><a href=#event-definitions-3><span class=secno>11.3.3.1 </span>Event definitions</a></li>
        <li><a href=#garbage-collection-2><span class=secno>11.3.3.2 </span>Garbage collection</a></ol></ol></li>
    <li><a href=#web-messaging><span class=secno>11.4 </span>Cross-document messaging</a>
     <ol>
@@ -34385,8 +34386,40 @@
   </div>
 
 
-  <h5 id=mediaevents><span class=secno>4.8.10.16 </span>Event summary</h5>
+  <h5 id=event-definitions><span class=secno>4.8.10.16 </span>Event definitions</h5>
 
+  <pre class=idl>[Constructor(DOMString type, optional <a href=#trackeventinit>TrackEventInit</a> eventInitDict)]
+interface <dfn id=trackevent>TrackEvent</dfn> : <a href=#event>Event</a> {
+  readonly attribute object? <a href=#dom-trackevent-track title=dom-TrackEvent-track>track</a>;
+};
+
+dictionary <dfn id=trackeventinit>TrackEventInit</dfn> : <a href=#eventinit>EventInit</a> {
+  object? Track;
+};</pre>
+
+  <dl class=domintro><dt><var title="">event</var> . <code title=dom-TrackEvent-track><a href=#dom-trackevent-track>track</a></code></dt>
+
+   <dd>
+
+    <p>Returns the track object (<code><a href=#texttrack>TextTrack</a></code>,
+    <code><a href=#audiotrack>AudioTrack</a></code>, or <code><a href=#videotrack>VideoTrack</a></code>) to which the
+    event relates.</p>
+
+   </dd>
+
+  </dl><div class=impl>
+
+  <p>The <dfn id=dom-trackevent-track title=dom-TrackEvent-track><code>track</code></dfn>
+  attribute must return the value it was initialized to. When the
+  object is created, this attribute must be initialized to null. It
+  represents the context information for the event.</p>
+
+  </div>
+
+
+
+  <h5 id=mediaevents><span class=secno>4.8.10.17 </span>Event summary</h5>
+
   <p><i>This section is non-normative.</i></p>
 
   <p>The following events fire on <a href=#media-element title="media element">media
@@ -34548,7 +34581,7 @@
      <td>Either the <code title=dom-MediaController-volume><a href=#dom-mediacontroller-volume>volume</a></code> attribute or the <code title=dom-MediaController-muted><a href=#dom-mediacontroller-muted>muted</a></code> attribute has just been updated.
   </table><div class=impl>
 
-  <h5 id=security-and-privacy-considerations><span class=secno>4.8.10.17 </span>Security and privacy considerations</h5>
+  <h5 id=security-and-privacy-considerations><span class=secno>4.8.10.18 </span>Security and privacy considerations</h5>
 
   <p>The main security and privacy implications of the
   <code><a href=#the-video-element>video</a></code> and <code><a href=#the-audio-element>audio</a></code> elements come from the
@@ -34596,7 +34629,7 @@
   </div>
 
 
-  <h5 id=best-practices-for-authors-using-media-elements><span class=secno>4.8.10.18 </span>Best practices for authors using media elements</h5>
+  <h5 id=best-practices-for-authors-using-media-elements><span class=secno>4.8.10.19 </span>Best practices for authors using media elements</h5>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -34619,7 +34652,7 @@
 
   <div class=impl>
 
-  <h5 id=best-practices-for-implementors-of-media-elements><span class=secno>4.8.10.19 </span>Best practices for implementors of media elements</h5>
+  <h5 id=best-practices-for-implementors-of-media-elements><span class=secno>4.8.10.20 </span>Best practices for implementors of media elements</h5>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -65302,7 +65335,7 @@
   <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
 
 
-  <h5 id=event-definitions><span class=secno>6.5.10.1 </span>Event definitions</h5>
+  <h5 id=event-definitions-0><span class=secno>6.5.10.1 </span>Event definitions</h5>
 
   </div>
 
@@ -76923,7 +76956,7 @@
   change this, see the /unloading document cleanup steps/. -->
 
 
-  <h3 id=event-definitions-0><span class=secno>9.7 </span>Event definitions</h3>
+  <h3 id=event-definitions-1><span class=secno>9.7 </span>Event definitions</h3>
 
   <p>The <code title=event-MediaStream-addstream><a href=#event-mediastream-addstream>addstream</a></code> and
   <code title=event-MediaStream-removestream><a href=#event-mediastream-removestream>removestream</a></code> events
@@ -79331,7 +79364,7 @@
 
 
 
-  <h3 id=event-definitions-1><span class=secno>11.1 </span>Event definitions</h3>
+  <h3 id=event-definitions-2><span class=secno>11.1 </span>Event definitions</h3>
 
   <p>Messages in <a href=#server-sent-events>server-sent events</a>, <a href=#network>Web
   sockets</a>, <a href=#web-messaging>cross-document messaging</a>, and
@@ -80816,7 +80849,7 @@
   source</dfn>.</p>
 
 
-  <h5 id=event-definitions-2><span class=secno>11.3.3.1 </span>Event definitions</h5>
+  <h5 id=event-definitions-3><span class=secno>11.3.3.1 </span>Event definitions</h5>
 
   <pre class=idl>[Constructor(DOMString type, optional <a href=#closeeventinit>CloseEventInit</a> eventInitDict)]
 interface <dfn id=closeevent>CloseEvent</dfn> : <a href=#event>Event</a> {

Modified: index
===================================================================
--- index	2011-09-30 23:12:04 UTC (rev 6607)
+++ index	2011-09-30 23:27:56 UTC (rev 6608)
@@ -596,10 +596,11 @@
          <li><a href=#webvtt-cue-text-dom-construction-rules><span class=secno>4.8.10.13.5 </span>WebVTT cue text DOM construction rules</a></ol></li>
        <li><a href=#user-interface><span class=secno>4.8.10.14 </span>User interface</a></li>
        <li><a href=#time-ranges><span class=secno>4.8.10.15 </span>Time ranges</a></li>
-       <li><a href=#mediaevents><span class=secno>4.8.10.16 </span>Event summary</a></li>
-       <li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.17 </span>Security and privacy considerations</a></li>
-       <li><a href=#best-practices-for-authors-using-media-elements><span class=secno>4.8.10.18 </span>Best practices for authors using media elements</a></li>
-       <li><a href=#best-practices-for-implementors-of-media-elements><span class=secno>4.8.10.19 </span>Best practices for implementors of media elements</a></ol></li>
+       <li><a href=#event-definitions><span class=secno>4.8.10.16 </span>Event definitions</a></li>
+       <li><a href=#mediaevents><span class=secno>4.8.10.17 </span>Event summary</a></li>
+       <li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.18 </span>Security and privacy considerations</a></li>
+       <li><a href=#best-practices-for-authors-using-media-elements><span class=secno>4.8.10.19 </span>Best practices for authors using media elements</a></li>
+       <li><a href=#best-practices-for-implementors-of-media-elements><span class=secno>4.8.10.20 </span>Best practices for implementors of media elements</a></ol></li>
      <li><a href=#the-canvas-element><span class=secno>4.8.11 </span>The <code>canvas</code> element</a>
       <ol>
        <li><a href=#2dcontext><span class=secno>4.8.11.1 </span>The 2D context</a>
@@ -884,7 +885,7 @@
      <li><a href=#scroll-to-fragid><span class=secno>6.5.9 </span>Navigating to a fragment identifier</a></li>
      <li><a href=#history-traversal><span class=secno>6.5.10 </span>History traversal</a>
       <ol>
-       <li><a href=#event-definitions><span class=secno>6.5.10.1 </span>Event definitions</a></ol></li>
+       <li><a href=#event-definitions-0><span class=secno>6.5.10.1 </span>Event definitions</a></ol></li>
      <li><a href=#unloading-documents><span class=secno>6.5.11 </span>Unloading documents</a>
       <ol>
        <li><a href=#event-definition><span class=secno>6.5.11.1 </span>Event definition</a></ol></li>
@@ -1005,11 +1006,11 @@
     <ol>
      <li><a href=#security-considerations><span class=secno>9.5.1 </span>Security considerations</a></ol></li>
    <li><a href=#garbage-collection-0><span class=secno>9.6 </span>Garbage collection</a></li>
-   <li><a href=#event-definitions-0><span class=secno>9.7 </span>Event definitions</a></li>
+   <li><a href=#event-definitions-1><span class=secno>9.7 </span>Event definitions</a></li>
    <li><a href=#mediastreamevents><span class=secno>9.8 </span>Event Summary</a></ol></li>
  <li><a href=#comms><span class=secno>10 </span>Communication</a>
   <ol>
-   <li><a href=#event-definitions-1><span class=secno>10.1 </span>Event definitions</a></li>
+   <li><a href=#event-definitions-2><span class=secno>10.1 </span>Event definitions</a></li>
    <li><a href=#web-messaging><span class=secno>10.2 </span>Cross-document messaging</a>
     <ol>
      <li><a href=#introduction-13><span class=secno>10.2.1 </span>Introduction</a></li>
@@ -34252,8 +34253,40 @@
   </div>
 
 
-  <h5 id=mediaevents><span class=secno>4.8.10.16 </span>Event summary</h5>
+  <h5 id=event-definitions><span class=secno>4.8.10.16 </span>Event definitions</h5>
 
+  <pre class=idl>[Constructor(DOMString type, optional <a href=#trackeventinit>TrackEventInit</a> eventInitDict)]
+interface <dfn id=trackevent>TrackEvent</dfn> : <a href=#event>Event</a> {
+  readonly attribute object? <a href=#dom-trackevent-track title=dom-TrackEvent-track>track</a>;
+};
+
+dictionary <dfn id=trackeventinit>TrackEventInit</dfn> : <a href=#eventinit>EventInit</a> {
+  object? Track;
+};</pre>
+
+  <dl class=domintro><dt><var title="">event</var> . <code title=dom-TrackEvent-track><a href=#dom-trackevent-track>track</a></code></dt>
+
+   <dd>
+
+    <p>Returns the track object (<code><a href=#texttrack>TextTrack</a></code>,
+    <code><a href=#audiotrack>AudioTrack</a></code>, or <code><a href=#videotrack>VideoTrack</a></code>) to which the
+    event relates.</p>
+
+   </dd>
+
+  </dl><div class=impl>
+
+  <p>The <dfn id=dom-trackevent-track title=dom-TrackEvent-track><code>track</code></dfn>
+  attribute must return the value it was initialized to. When the
+  object is created, this attribute must be initialized to null. It
+  represents the context information for the event.</p>
+
+  </div>
+
+
+
+  <h5 id=mediaevents><span class=secno>4.8.10.17 </span>Event summary</h5>
+
   <p><i>This section is non-normative.</i></p>
 
   <p>The following events fire on <a href=#media-element title="media element">media
@@ -34415,7 +34448,7 @@
      <td>Either the <code title=dom-MediaController-volume><a href=#dom-mediacontroller-volume>volume</a></code> attribute or the <code title=dom-MediaController-muted><a href=#dom-mediacontroller-muted>muted</a></code> attribute has just been updated.
   </table><div class=impl>
 
-  <h5 id=security-and-privacy-considerations><span class=secno>4.8.10.17 </span>Security and privacy considerations</h5>
+  <h5 id=security-and-privacy-considerations><span class=secno>4.8.10.18 </span>Security and privacy considerations</h5>
 
   <p>The main security and privacy implications of the
   <code><a href=#the-video-element>video</a></code> and <code><a href=#the-audio-element>audio</a></code> elements come from the
@@ -34463,7 +34496,7 @@
   </div>
 
 
-  <h5 id=best-practices-for-authors-using-media-elements><span class=secno>4.8.10.18 </span>Best practices for authors using media elements</h5>
+  <h5 id=best-practices-for-authors-using-media-elements><span class=secno>4.8.10.19 </span>Best practices for authors using media elements</h5>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -34486,7 +34519,7 @@
 
   <div class=impl>
 
-  <h5 id=best-practices-for-implementors-of-media-elements><span class=secno>4.8.10.19 </span>Best practices for implementors of media elements</h5>
+  <h5 id=best-practices-for-implementors-of-media-elements><span class=secno>4.8.10.20 </span>Best practices for implementors of media elements</h5>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -36986,7 +37019,7 @@
 
   <!-- this is filler to make sure the TCP packet boundary doesn't fall in the middle of one of the NCRs below -->
   <!-- (because otherwise the parser in anolis screws it up) -->
-  <p><img alt="The top of the em square is roughly at the top of the glyphs in a font, the hanging baseline is where some glyphs like आ are anchored, the middle is half-way between the top of the em square and the bottom of the em square, the alphabetic baseline is where characters like Á, ÿ, f, and Ω are anchored, the ideographic baseline is where glyphs like 私 and 達 are anchored, and the bottom of the em square is roughly at the bottom of the glyphs in a font. The top and bottom of the bounding box can be far from these baselines, due to glyphs extending far outside the em square." height=300 src=http://images.whatwg.org/baselines.png width=738></p>
+  <p><img alt="The top of the em square is roughly at the top of the glyphs in a font, the hanging baseline is where some glyphs like आ are anchored, the middle is half-way between the top of the em square and the bottom of the em square, the alphabetic baseline is where characters like Á, " height=300 src=http://images.whatwg.org/baselines.png width=738>x00FF;, f, and Ω are anchored, the ideographic baseline is where glyphs like 私 and 達 are anchored, and the bottom of the em square is roughly at the bottom of the glyphs in a font. The top and bottom of the bounding box can be far from these baselines, due to glyphs extending far outside the em square."></p>
 
   <p>The keywords map to these alignment points as follows:</p>
 
@@ -65169,7 +65202,7 @@
   <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
 
 
-  <h5 id=event-definitions><span class=secno>6.5.10.1 </span>Event definitions</h5>
+  <h5 id=event-definitions-0><span class=secno>6.5.10.1 </span>Event definitions</h5>
 
   </div>
 
@@ -76819,7 +76852,7 @@
   change this, see the /unloading document cleanup steps/. -->
 
 
-  <h3 id=event-definitions-0><span class=secno>9.7 </span>Event definitions</h3>
+  <h3 id=event-definitions-1><span class=secno>9.7 </span>Event definitions</h3>
 
   <p>The <code title=event-MediaStream-addstream><a href=#event-mediastream-addstream>addstream</a></code> and
   <code title=event-MediaStream-removestream><a href=#event-mediastream-removestream>removestream</a></code> events
@@ -76915,7 +76948,7 @@
 
 
 
-  <h3 id=event-definitions-1><span class=secno>10.1 </span>Event definitions</h3>
+  <h3 id=event-definitions-2><span class=secno>10.1 </span>Event definitions</h3>
 
   <p>Messages in <span>server-sent events</span>, <span>Web
   sockets</span>, <a href=#web-messaging>cross-document messaging</a>, and

Modified: source
===================================================================
--- source	2011-09-30 23:12:04 UTC (rev 6607)
+++ source	2011-09-30 23:27:56 UTC (rev 6608)
@@ -37766,6 +37766,42 @@
   </div>
 
 
+  <h5>Event definitions</h5>
+
+  <pre class="idl">[Constructor(DOMString type, optional <span>TrackEventInit</span> eventInitDict)]
+interface <dfn>TrackEvent</dfn> : <span>Event</span> {
+  readonly attribute object? <span title="dom-TrackEvent-track">track</span>;
+};
+
+dictionary <dfn>TrackEventInit</dfn> : <span>EventInit</span> {
+  object? Track;
+};</pre>
+
+  <dl class="domintro">
+
+   <dt><var title="">event</var> . <code title="dom-TrackEvent-track">track</code></dt>
+
+   <dd>
+
+    <p>Returns the track object (<code>TextTrack</code>,
+    <code>AudioTrack</code>, or <code>VideoTrack</code>) to which the
+    event relates.</p>
+
+   </dd>
+
+  </dl>
+
+  <div class="impl">
+
+  <p>The <dfn title="dom-TrackEvent-track"><code>track</code></dfn>
+  attribute must return the value it was initialized to. When the
+  object is created, this attribute must be initialized to null. It
+  represents the context information for the event.</p>
+
+  </div>
+
+
+
   <h5 id="mediaevents">Event summary</h5>
 
   <!--END dev-html--><p><i>This section is non-normative.</i></p><!--START dev-html-->




More information about the Commit-Watchers mailing list