- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 19 Aug 2008 00:59:13 +0000
- To: public-html-commits@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 UTC