W3C home > Mailing lists > Public > public-html-commits@w3.org > August 2008

html5/spec Overview.html,1.1252,1.1253

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 19 Aug 2008 00:59:13 +0000
To: public-html-commits@w3.org
Message-Id: <E1KVFZ3-0008HS-J9@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv31598

Modified Files:
	Overview.html 
Log Message:
More poking around getting the media element section to use the new event loop stuff. (whatwg r2080)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1252
retrieving revision 1.1253
diff -u -d -r1.1252 -r1.1253
--- Overview.html	18 Aug 2008 21:27:15 -0000	1.1252
+++ Overview.html	19 Aug 2008 00:59:10 -0000	1.1253
@@ -27,7 +27,7 @@
     for HTML and XHTML</h2>
 
    <h2 class="no-num no-toc" id=editors0><!-- "W3C Working Draft" -->
-    Editor's Draft <!--ZZZ-->18 August 2008</h2>
+    Editor's Draft <!--ZZZ-->19 August 2008</h2>
 
    <dl><!-- ZZZ: update the month/day
     <dt>This Version:</dt>
@@ -199,7 +199,7 @@
 
   <p>The W3C <a href="http://www.w3.org/html/wg/">HTML Working Group</a> is
    the W3C working group responsible for this specification's progress along
-   the W3C Recommendation track. <!--ZZZ:--> This specification is the 18
+   the W3C Recommendation track. <!--ZZZ:--> This specification is the 19
    August 2008 <!--ZZZ "Working Draft"-->Editor's Draft. <!--:ZZZ--></p>
   <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
   <!-- relationship to other work (required) -->
@@ -13054,7 +13054,7 @@
 
    <dd><code title=attr-hyperlink-rel><a href="#rel3">rel</a></code>
 
-   <dd><code title=attr-hyperlink-media><a href="#media12">media</a></code>
+   <dd><code title=attr-hyperlink-media><a href="#media14">media</a></code>
 
    <dd><code title=attr-hyperlink-hreflang><a
     href="#hreflang3">hreflang</a></code>
@@ -13093,7 +13093,7 @@
    href="#target3">target</a></code>, <code title=attr-hyperlink-ping><a
    href="#ping">ping</a></code>, <code title=attr-hyperlink-rel><a
    href="#rel3">rel</a></code>, <code title=attr-hyperlink-media><a
-   href="#media12">media</a></code>, <code title=attr-hyperlink-hreflang><a
+   href="#media14">media</a></code>, <code title=attr-hyperlink-hreflang><a
    href="#hreflang3">hreflang</a></code>, and <code
    title=attr-hyperlink-type><a href="#type20">type</a></code> attributes
    must be omitted if the <code title=attr-hyperlink-href><a
@@ -13122,7 +13122,7 @@
    title=attr-hyperlink-ping><a href="#ping">ping</a></code> attributes
    decide how the link is followed. The <code title=attr-hyperlink-rel><a
    href="#rel3">rel</a></code>, <code title=attr-hyperlink-media><a
-   href="#media12">media</a></code>, <code title=attr-hyperlink-hreflang><a
+   href="#media14">media</a></code>, <code title=attr-hyperlink-hreflang><a
    href="#hreflang3">hreflang</a></code>, and <code
    title=attr-hyperlink-type><a href="#type20">type</a></code> attributes may
    be used to indicate to the user the likely nature of the target resource
@@ -18697,8 +18697,8 @@
    <code title=dom-media-load><a href="#load">load()</a></code> method on the
    <a href="#media7">media element</a>, and ignores any resulting exceptions.
    The <a href="#task-source">task source</a> for this task is the <a
-   href="#media7">media element</a>'s own <a href="#new-resource">new
-   resource task source</a>.
+   href="#media7">media element</a>'s own <a href="#media12">media element
+   new resource task source</a>.
 
   <p>The DOM attributes <dfn id=src6
    title=dom-source-src><code>src</code></dfn>, <dfn id=type9
@@ -18829,6 +18829,15 @@
    resource</dfn> is used to refer to the complete set of media data, e.g.
    the complete video file, or complete audio file.
 
+  <p><a href="#media7" title="media element">Media elements</a> use two <a
+   href="#task-queues" title="task queue">task queues</a>, the <dfn
+   id=media11>media element event task source</dfn> for asynchronous events
+   and callbacks, and the <dfn id=media12>media element new resource task
+   source</dfn> for handling implicit loads. Unless otherwise specified, all
+   the tasks <a href="#queue" title="queue a task">queued</a> in this section
+   and its subsections use the <a href="#media11">media element event task
+   source</a>.
+
   <h5 id=error><span class=secno>4.7.10.1. </span>Error codes</h5>
 
   <p>All <a href="#media7" title="media element">media elements</a> have an
@@ -18891,8 +18900,8 @@
    href="#load">load()</a></code> method on the <a href="#media7">media
    element</a>, and ignores any resulting exceptions. The <a
    href="#task-source">task source</a> for this task is the <a
-   href="#media7">media element</a>'s own <a href="#new-resource">new
-   resource task source</a>.
+   href="#media7">media element</a>'s own <a href="#media12">media element
+   new resource task source</a>.
 
   <p class=note>If a <code title=attr-media-src><a
    href="#src7">src</a></code> attribute is specified, the resource it
@@ -19080,9 +19089,14 @@
   <ol>
    <li>
     <p>If there are any <a href="#tasks" title=concept-task>tasks</a> from
-     the <a href="#media7">media element</a>'s own <dfn id=new-resource>new
-     resource task source</dfn> in one of the <a href="#task-queues"
-     title="task queue">task queues</a>, then remove those tasks.
+     the <a href="#media7">media element</a>'s <a href="#media12">media
+     element new resource task source</a> or its <a href="#media11">media
+     element event task source</a> in one of the <a href="#task-queues"
+     title="task queue">task queues</a>, then remove those tasks.</p>
+
+    <p class=note>Basically, pending events, callbacks, and loads for the
+     media element are discarded when the media element starts loading a new
+     resource.</p>
 
    <li>
     <p>Any already-running instance of this algorithm for this element must
@@ -19466,8 +19480,8 @@
    href="#load">load()</a></code> method on the <a href="#media7">media
    element</a>, and ignores any resulting exceptions. The <a
    href="#task-source">task source</a> for this task is the <a
-   href="#media7">media element</a>'s own <a href="#new-resource">new
-   resource task source</a>.
+   href="#media7">media element</a>'s own <a href="#media12">media element
+   new resource task source</a>.
 
   <p>The <dfn id=bufferingrate
    title=dom-media-bufferingRate><code>bufferingRate</code></dfn> attribute
@@ -19531,12 +19545,11 @@
 
   <p>When the length of the <a href="#media10">media resource</a> changes
    (e.g. from being unknown to known, or from indeterminate to known, or from
-   a previously established length to a new length) the user agent must, once
-   any running scripts have finished, <a href="#firing2">fire a simple
+   a previously established length to a new length) the user agent must <a
+   href="#queue">queue a task</a> to <a href="#firing2">fire a simple
    event</a> called <code title=event-durationchange><a
    href="#durationchange">durationchange</a></code> at the <a
-   href="#media7">media element</a>.</p>
-  <!-- xxx queue -->
+   href="#media7">media element</a>.
 
   <p><a href="#media7" title="media element">Media elements</a> have a <dfn
    id=current0>current playback position</dfn>, which must initially be zero.
@@ -19975,20 +19988,19 @@
    href="#stopped">stopped due to errors</a>, or playback having <a
    href="#paused0">paused for user interaction</a>, or the <a href="#seek"
    title=dom-media-seek>seeking algorithm</a> being invoked, the user agent
-   must <a href="#firing2">fire a simple event</a> called <code
-   title=event-timeupdate><a href="#timeupdate">timeupdate</a></code> at the
-   element, and then must <a href="#firing2">fire a simple event</a> called
-   <code title=event-waiting><a href="#waiting">waiting</a></code> at the
-   element.</p>
-  <!-- xxx queue -->
+   must <a href="#queue">queue a task</a> to <a href="#firing2">fire a simple
+   event</a> called <code title=event-timeupdate><a
+   href="#timeupdate">timeupdate</a></code> at the element, and <a
+   href="#queue">queue a task</a> to <a href="#firing2">fire a simple
+   event</a> called <code title=event-waiting><a
+   href="#waiting">waiting</a></code> at the element.
 
   <p>When a <a href="#media7">media element</a> that is <a
    href="#actively">actively playing</a> stops playing because it has <a
    href="#paused0">paused for user interaction</a>, the user agent must <a
-   href="#firing2">fire a simple event</a> called <code
-   title=event-timeupdate><a href="#timeupdate">timeupdate</a></code> at the
-   element.</p>
-  <!-- xxx queue -->
+   href="#queue">queue a task</a> to <a href="#firing2">fire a simple
+   event</a> called <code title=event-timeupdate><a
+   href="#timeupdate">timeupdate</a></code> at the element.
 
   <p>When <code title=dom-media-currentLoop><a
    href="#currentloop">currentLoop</a></code> is less than <span><code
@@ -19996,12 +20008,12 @@
    href="#playcount0">playCount</a></code>-1</span> and the <a
    href="#current0">current playback position</a> reaches the <var><a
    href="#effective1">effective loop end</a></var>, then the user agent must
-   <a href="#seek" title=dom-media-seek>seek</a> to the <var><a
-   href="#effective0">effective loop start</a></var>, increase <code
-   title=dom-media-currentLoop><a href="#currentloop">currentLoop</a></code>
-   by 1, and <a href="#firing2">fire a simple event</a> called <code
-   title=event-timeupdate><a href="#timeupdate">timeupdate</a></code>.</p>
-  <!-- xxx queue -->
+   increase <code title=dom-media-currentLoop><a
+   href="#currentloop">currentLoop</a></code> by 1, <a href="#queue">queue a
+   task</a> to <a href="#firing2">fire a simple event</a> called <code
+   title=event-timeupdate><a href="#timeupdate">timeupdate</a></code>, and <a
+   href="#seek" title=dom-media-seek>seek</a> to the <var><a
+   href="#effective0">effective loop start</a></var>.
 
   <p>When <code title=dom-media-currentLoop><a
    href="#currentloop">currentLoop</a></code> is equal to the <span><code
@@ -20020,16 +20032,15 @@
      href="#ended0">ended</a></code> attribute becomes true.
 
    <li>
-    <p>The user agent must <a href="#firing2">fire a simple event</a> called
-     <code title=event-timeupdate><a href="#timeupdate">timeupdate</a></code>
-     at the element.
-   </li>
-   <!-- xxx queue -->
+    <p>The user agent must <a href="#queue">queue a task</a> to <a
+     href="#firing2">fire a simple event</a> called <code
+     title=event-timeupdate><a href="#timeupdate">timeupdate</a></code> at
+     the element.
 
    <li>
-    <p>The user agent must <a href="#firing2">fire a simple event</a> called
-     <code title=event-ended><a href="#ended1">ended</a></code> at the
-     element.
+    <p>The user agent must <a href="#queue">queue a task</a> to <a
+     href="#firing2">fire a simple event</a> called <code
+     title=event-ended><a href="#ended1">ended</a></code> at the element.
   </ol>
 
   <p>The <dfn id=defaultplaybackrate
@@ -20058,12 +20069,13 @@
    title=dom-media-playbackRate><a
    href="#playbackrate">playbackRate</a></code> attributes change value
    (either by being set by script or by being changed directly by the user
-   agent, e.g. in response to user control) the user agent must, once any
-   running scripts have finished, <a href="#firing2">fire a simple event</a>
-   called <code title=event-ratechange><a
+   agent, e.g. in response to user control) the user agent must <a
+   href="#queue">queue a task</a> to <a href="#firing2">fire a simple
+   event</a> called <code title=event-ratechange><a
    href="#ratechange">ratechange</a></code> at the <a href="#media7">media
-   element</a>.</p>
-  <!-- xxx queue -->
+   element</a>.
+
+  <hr>
 
   <p>When the <dfn id=play title=dom-media-play><code>play()</code></dfn>
    method on a <a href="#media7">media element</a> is invoked, the user agent
@@ -23754,7 +23766,7 @@
 
    <dd><code title=attr-hyperlink-rel><a href="#rel3">rel</a></code>
 
-   <dd><code title=attr-hyperlink-media><a href="#media12">media</a></code>
+   <dd><code title=attr-hyperlink-media><a href="#media14">media</a></code>
 
    <dd><code title=attr-hyperlink-hreflang><a
     href="#hreflang3">hreflang</a></code>
@@ -23774,7 +23786,7 @@
            attribute DOMString <a href="#ping1" title=dom-area-ping>ping</a>;
            attribute DOMString <a href="#rel2" title=dom-area-rel>rel</a>;
   readonly attribute DOMTokenList <a href="#rellist1" title=dom-area-relList>relList</a>;
-           attribute DOMString <a href="#media11" title=dom-area-media>media</a>;
+           attribute DOMString <a href="#media13" title=dom-area-media>media</a>;
            attribute DOMString <a href="#hreflang2" title=dom-area-hreflang>hreflang</a>;
            attribute DOMString <a href="#type10" title=dom-area-type>type</a>;
 };</pre>
@@ -23933,7 +23945,7 @@
    <code title=attr-hyperlink-ping><a href="#ping">ping</a></code> attributes
    decide how the link is followed. The <code title=attr-hyperlink-rel><a
    href="#rel3">rel</a></code>, <code title=attr-hyperlink-media><a
-   href="#media12">media</a></code>, <code title=attr-hyperlink-hreflang><a
+   href="#media14">media</a></code>, <code title=attr-hyperlink-hreflang><a
    href="#hreflang3">hreflang</a></code>, and <code
    title=attr-hyperlink-type><a href="#type20">type</a></code> attributes may
    be used to indicate to the user the likely nature of the target resource
@@ -23943,7 +23955,7 @@
    href="#target3">target</a></code>, <code title=attr-hyperlink-ping><a
    href="#ping">ping</a></code>, <code title=attr-hyperlink-rel><a
    href="#rel3">rel</a></code>, <code title=attr-hyperlink-media><a
-   href="#media12">media</a></code>, <code title=attr-hyperlink-hreflang><a
+   href="#media14">media</a></code>, <code title=attr-hyperlink-hreflang><a
    href="#hreflang3">hreflang</a></code>, and <code
    title=attr-hyperlink-type><a href="#type20">type</a></code> attributes
    must be omitted if the <code title=attr-hyperlink-href><a
@@ -23980,7 +23992,7 @@
    title=dom-area-href><code>href</code></dfn>, <dfn id=target2
    title=dom-area-target><code>target</code></dfn>, <dfn id=ping1
    title=dom-area-ping><code>ping</code></dfn>, <dfn id=rel2
-   title=dom-area-rel><code>rel</code></dfn>, <dfn id=media11
+   title=dom-area-rel><code>rel</code></dfn>, <dfn id=media13
    title=dom-area-media><code>media</code></dfn>, <dfn id=hreflang2
    title=dom-area-hreflang><code>hreflang</code></dfn>, and <dfn id=type10
    title=dom-area-type><code>type</code></dfn>, each must <a
@@ -38440,11 +38452,11 @@
    with the destination resource other than there being a hyperlink between
    the two.
 
-  <p>The <dfn id=media12 title=attr-hyperlink-media><code>media</code></dfn>
+  <p>The <dfn id=media14 title=attr-hyperlink-media><code>media</code></dfn>
    attribute describes for which media the target document was designed. It
    is purely advisory. The value must be a valid <a href="#mq">media
    query</a>. <a href="#references">[MQ]</a> The default, if the <code
-   title=attr-hyperlink-media><a href="#media12">media</a></code> attribute
+   title=attr-hyperlink-media><a href="#media14">media</a></code> attribute
    is omitted, is <code>all</code>.
 
   <p>The <dfn id=hreflang3
@@ -38982,14 +38994,14 @@
    representation of the current document.
 
   <p>The nature of the referenced document is given by the <code
-   title=attr-hyperlink-media><a href="#media12">media</a></code>, <code
+   title=attr-hyperlink-media><a href="#media14">media</a></code>, <code
    title=attr-hyperlink-hreflang><a href="#hreflang3">hreflang</a></code>,
    and <code title=attr-hyperlink-type><a href="#type20">type</a></code>
    attributes.
 
   <p>If the <code title=rel-alternate><a
    href="#alternate">alternate</a></code> keyword is used with the <code
-   title=attr-hyperlink-media><a href="#media12">media</a></code> attribute,
+   title=attr-hyperlink-media><a href="#media14">media</a></code> attribute,
    it indicates that the referenced document is intended for use with the
    media specified.
 
@@ -39007,7 +39019,7 @@
    document in the specified format.
 
   <p>The <code title=attr-hyperlink-media><a
-   href="#media12">media</a></code>, <code title=attr-hyperlink-hreflang><a
+   href="#media14">media</a></code>, <code title=attr-hyperlink-hreflang><a
    href="#hreflang3">hreflang</a></code>, and <code
    title=attr-hyperlink-type><a href="#type20">type</a></code> attributes can
    be combined when specified with the <code title=rel-alternate><a
Received on Tuesday, 19 August 2008 00:59:49 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:32:58 GMT