- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 14 Oct 2009 09:56:42 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv17658
Modified Files:
Overview.html
Log Message:
Make media elements not fire progress events, just regular events, since we don't know what to put in their 'loaded' attributes. (whatwg r4133)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3286
retrieving revision 1.3287
diff -u -d -r1.3286 -r1.3287
--- Overview.html 14 Oct 2009 09:49:32 -0000 1.3286
+++ Overview.html 14 Oct 2009 09:56:38 -0000 1.3287
@@ -19372,11 +19372,9 @@
<li><p>If <var title="">aborted</var> is true, set the <code title="dom-media-error"><a href="#dom-media-error">error</a></code> attribute to a new
<code><a href="#mediaerror">MediaError</a></code> object whose <code title="dom-MediaError-code"><a href="#dom-mediaerror-code">code</a></code> attribute is set to <code title="dom-MediaError-MEDIA_ERR_ABORTED"><a href="#dom-mediaerror-media_err_aborted">MEDIA_ERR_ABORTED</a></code>,
- <a href="#fire-a-progress-event">fire a progress event</a> named <code title="event-media-abort"><a href="#event-media-abort">abort</a></code> at the <a href="#media-element">media element</a>,
- in the context of the <a href="#fetch" title="fetch">fetching process</a>
- that is in progress for the element, and <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code> at
- the <a href="#media-element">media element</a>, in the context of the same <a href="#fetch" title="fetch">fetching process</a>.</li>
+ <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-abort"><a href="#event-media-abort">abort</a></code> at the <a href="#media-element">media
+ element</a>, and <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code> at the <a href="#media-element">media
+ element</a>.</li>
<li><p>Set the <code title="dom-media-error"><a href="#dom-media-error">error</a></code> attribute
to null and the <a href="#autoplaying-flag">autoplaying flag</a> to true.</li>
@@ -19438,9 +19436,9 @@
its <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> to
<code title="dom-media-NETWORK_LOADING"><a href="#dom-media-network_loading">NETWORK_LOADING</a></code>.</li>
- <li><p>⌛ <a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-loadstart"><a href="#event-media-loadstart">loadstart</a></code>
- at the <a href="#media-element">media element</a>, with no relevant <a href="#fetch" title="fetch">fetching process</a>.</li>
+ <li><p>⌛ <a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-loadstart"><a href="#event-media-loadstart">loadstart</a></code> at the <a href="#media-element">media
+ element</a>.</li>
<li>
@@ -19476,17 +19474,13 @@
the <a href="#dom-media-network_no_source" title="dom-media-NETWORK_NO_SOURCE">NETWORK_NO_SOURCE</a>
value.</li>
- <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-error"><a href="#event-media-error">error</a></code> at the
- <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> that was used to try to
- obtain the <a href="#media-resource">media resource</a> in the <a href="#concept-media-load-resource" title="concept-media-load-resource">resource fetch
- algorithm</a>.</li>
+ <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-error"><a href="#event-media-error">error</a></code>
+ at the <a href="#media-element">media element</a>.</li>
- <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code> at
- the <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> that was used to try to
- obtain the <a href="#media-resource">media resource</a> in the <a href="#concept-media-load-resource" title="concept-media-load-resource">resource fetch
- algorithm</a>.</li>
+ <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code> at the <a href="#media-element">media
+ element</a>.</li>
<li><p>Set the element's <a href="#delaying-the-load-event-flag">delaying-the-load-event flag</a>
to false. This stops <a href="#delay-the-load-event" title="delay the load event">delaying
@@ -19661,15 +19655,11 @@
<p>Every 350ms (±200ms) or for every byte received, whichever
is <em>least</em> frequent, <a href="#queue-a-task">queue a task</a> to
- <a href="#fire-a-progress-event">fire a progress event</a> named <code title="event-media-progress"><a href="#event-media-progress">progress</a></code> at the element, in the
- context of the <a href="#fetch" title="fetch">fetching process</a> started
- by this instance of this algorithm.</p>
+ <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-progress"><a href="#event-media-progress">progress</a></code> at the element.</p>
<p>If at any point the user agent has received no data for more
than about three seconds, then <a href="#queue-a-task">queue a task</a> to
- <a href="#fire-a-progress-event">fire a progress event</a> named <code title="event-media-stalled"><a href="#event-media-stalled">stalled</a></code> at the element, in the
- context of the <a href="#fetch" title="fetch">fetching process</a> started
- by this instance of this algorithm.</p>
+ <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-stalled"><a href="#event-media-stalled">stalled</a></code> at the element.</p>
<p>User agents may allow users to selectively block or slow
<a href="#media-data">media data</a> downloads. When a <a href="#media-element">media
@@ -19685,10 +19675,10 @@
resource or not, or while waiting for user input in an interactive
resource. When a <a href="#media-element">media element</a>'s download has been
suspended, the user agent must set the <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> to <code title="dom-media-NETWORK_IDLE"><a href="#dom-media-network_idle">NETWORK_IDLE</a></code> and <a href="#queue-a-task">queue
- a task</a> to <a href="#fire-a-progress-event">fire a progress event</a> named <code title="event-media-suspend"><a href="#event-media-suspend">suspend</a></code> at the element, in the
- context of the <a href="#fetch" title="fetch">fetching process</a> started
- by this instance of this algorithm. If and when downloading of the
- resource resumes, the user agent must set the <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> to <code title="dom-media-NETWORK_LOADING"><a href="#dom-media-network_loading">NETWORK_LOADING</a></code>.</p>
+ a task</a> to <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-suspend"><a href="#event-media-suspend">suspend</a></code> at the element. If and
+ when downloading of the resource resumes, the user agent must set
+ the <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> to
+ <code title="dom-media-NETWORK_LOADING"><a href="#dom-media-network_loading">NETWORK_LOADING</a></code>.</p>
<p>The <code title="attr-media-autobuffer"><a href="#attr-media-autobuffer">autobuffer</a></code>
attribute provides a hint that the author expects that downloading
@@ -19841,10 +19831,9 @@
<dd>
- <p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-progress"><a href="#event-media-progress">progress</a></code>
- at the <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> started by this instance
- of this algorithm.</p>
+ <p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple event</a>
+ named <code title="event-media-progress"><a href="#event-media-progress">progress</a></code> at the
+ <a href="#media-element">media element</a>.</p>
</dd>
@@ -19866,15 +19855,13 @@
attribute to a new <code><a href="#mediaerror">MediaError</a></code> object whose <code title="dom-MediaError-code"><a href="#dom-mediaerror-code">code</a></code> attribute is set to
<code title="dom-MediaError-MEDIA_ERR_NETWORK"><a href="#dom-mediaerror-media_err_network">MEDIA_ERR_NETWORK</a></code>.</li>
- <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-error"><a href="#event-media-error">error</a></code> at
- the <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> started by this instance
- of this algorithm.</li>
+ <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-error"><a href="#event-media-error">error</a></code>
+ at the <a href="#media-element">media element</a>.</li>
- <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code>
- at the <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> started by this instance
- of this algorithm.</li>
+ <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code> at the <a href="#media-element">media
+ element</a>.</li>
<li><p>Set the element's <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to
the <a href="#dom-media-network_empty" title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</a>
@@ -19908,15 +19895,13 @@
attribute to a new <code><a href="#mediaerror">MediaError</a></code> object whose <code title="dom-MediaError-code"><a href="#dom-mediaerror-code">code</a></code> attribute is set to
<code title="dom-MediaError-MEDIA_ERR_DECODE"><a href="#dom-mediaerror-media_err_decode">MEDIA_ERR_DECODE</a></code>.</li>
- <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-error"><a href="#event-media-error">error</a></code> at
- the <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> started by this instance
- of this algorithm.</li>
+ <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-error"><a href="#event-media-error">error</a></code>
+ at the <a href="#media-element">media element</a>.</li>
- <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code>
- at the <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> started by this instance
- of this algorithm.</li>
+ <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code> at the <a href="#media-element">media
+ element</a>.</li>
<li><p>Set the element's <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to
the <a href="#dom-media-network_empty" title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</a>
@@ -19953,15 +19938,13 @@
attribute to a new <code><a href="#mediaerror">MediaError</a></code> object whose <code title="dom-MediaError-code"><a href="#dom-mediaerror-code">code</a></code> attribute is set to
<code title="dom-MediaError-MEDIA_ERR_ABORT">MEDIA_ERR_ABORT</code>.</li>
- <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-abort"><a href="#event-media-abort">abort</a></code> at
- the <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> started by this instance
- of this algorithm.</li>
+ <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-abort"><a href="#event-media-abort">abort</a></code>
+ at the <a href="#media-element">media element</a>.</li>
- <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-progress-event">fire a progress
- event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code>
- at the <a href="#media-element">media element</a>, in the context of the <a href="#fetch" title="fetch">fetching process</a> started by this instance
- of this algorithm.</li>
+ <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+ event</a> named <code title="event-media-loadend"><a href="#event-media-loadend">loadend</a></code> at the <a href="#media-element">media
+ element</a>.</li>
<li><p>If the <a href="#media-element">media element</a>'s <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute has a
value equal to <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>, set the
@@ -21216,29 +21199,29 @@
<th>Preconditions
<tbody><tr><td><dfn id="event-media-loadstart" title="event-media-loadstart"><code>loadstart</code></dfn>
- <td><code>ProgressEvent</code> <a href="#refsPROGRESS">[PROGRESS]</a>
+ <td><code>Event</code>
<td>The user agent begins looking for <a href="#media-data">media data</a>, as part of the <a href="#concept-media-load-algorithm" title="concept-media-load-algorithm">resource selection algorithm</a>.
<td><code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> equals <code title="dom-media-NETWORK_LOADING"><a href="#dom-media-network_loading">NETWORK_LOADING</a></code>
<tr><td><dfn id="event-media-progress" title="event-media-progress"><code>progress</code></dfn>
- <td><code>ProgressEvent</code> <a href="#refsPROGRESS">[PROGRESS]</a>
+ <td><code>Event</code>
<td>The user agent is fetching <a href="#media-data">media data</a>.
<td><code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> equals <code title="dom-media-NETWORK_LOADING"><a href="#dom-media-network_loading">NETWORK_LOADING</a></code>
<tr><td><dfn id="event-media-suspend" title="event-media-suspend"><code>suspend</code></dfn>
- <td><code>ProgressEvent</code> <a href="#refsPROGRESS">[PROGRESS]</a>
+ <td><code>Event</code>
<td>The user agent is intentionally not currently fetching <a href="#media-data">media data</a>, but does not have the entire <a href="#media-resource">media resource</a> downloaded.
<td><code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> equals <code title="dom-media-NETWORK_IDLE"><a href="#dom-media-network_idle">NETWORK_IDLE</a></code>
<tr><td><dfn id="event-media-abort" title="event-media-abort"><code>abort</code></dfn>
- <td><code>ProgressEvent</code> <a href="#refsPROGRESS">[PROGRESS]</a>
+ <td><code>Event</code>
<td>The user agent stops fetching the <a href="#media-data">media data</a> before it is completely downloaded, but not due to an error.
<td><code title="dom-media-error"><a href="#dom-media-error">error</a></code> is an object with the code <code title="dom-MediaError-MEDIA_ERR_ABORTED"><a href="#dom-mediaerror-media_err_aborted">MEDIA_ERR_ABORTED</a></code>.
<code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> equals either <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> or <code title="dom-media-NETWORK_IDLE"><a href="#dom-media-network_idle">NETWORK_IDLE</a></code>, depending on when the download was aborted.
<tr><td><dfn id="event-media-error" title="event-media-error"><code>error</code></dfn>
- <td><code>ProgressEvent</code> <a href="#refsPROGRESS">[PROGRESS]</a>
+ <td><code>Event</code>
<td>An error occurs while fetching the <a href="#media-data">media data</a>.
<td><code title="dom-media-error"><a href="#dom-media-error">error</a></code> is an object with the code <code title="dom-MediaError-MEDIA_ERR_NETWORK"><a href="#dom-mediaerror-media_err_network">MEDIA_ERR_NETWORK</a></code> or higher.
<code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> equals either <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> or <code title="dom-media-NETWORK_IDLE"><a href="#dom-media-network_idle">NETWORK_IDLE</a></code>, depending on when the download was aborted.
<tr><td><dfn id="event-media-loadend" title="event-media-loadend"><code>loadend</code></dfn>
- <td><code>ProgressEvent</code> <a href="#refsPROGRESS">[PROGRESS]</a>
+ <td><code>Event</code>
<td>The user agent stops fetching the <a href="#media-data">media data</a>, for whatever reason.
<td>One of <code title="event-media-abort"><a href="#event-media-abort">abort</a></code> or <code title="event-media-error"><a href="#event-media-error">error</a></code> has just fired.
<tr><td><dfn id="event-media-emptied" title="event-media-emptied"><code>emptied</code></dfn>
@@ -43218,26 +43201,37 @@
otherwise stated), and which uses the <code>Event</code> interface,
must be dispatched at the given target.</p>
- <p><dfn id="fire-a-progress-event" title="fire a progress event">Firing a progress event named
+<!--
+ <p><dfn title="fire a progress event">Firing a progress event named
<var title="">e</var></dfn>, optionally in the context of a
- particular instance of the <a href="#fetch" title="fetch">fetching
- algorithm</a>, means that an event with the name <var title="">e</var>, with no namespace, which does not bubble (except
+ particular instance of the <span title="fetch">fetching
+ algorithm</span>, means that an event with the name <var
+ title="">e</var>, with no namespace, which does not bubble (except
where otherwise stated) and is not cancelable (except where
otherwise stated), and which uses the <code>ProgressEvent</code>
interface, must be dispatched at the given target element. If there
- is a <a href="#fetch" title="fetch">fetching algorithm</a>, and the
- <a href="#url">URL</a> being <a href="#fetch" title="fetch">fetched</a> has the
- <a href="#same-origin">same origin</a> as the <code>Document</code> of the target
- element, then the <code title="dom-ProgressEvents-lengthComputable">lengthComputable</code>
- attribute must be set to true if the <a href="#fetch" title="fetch">fetching
- algorithm</a>'s subject has a known <a href="#concept-fetch-total" title="concept-fetch-total">size</a>; the <code title="dom-ProgressEvents-total">total</code> attribute must be set
- to the subject's <a href="#concept-fetch-total" title="concept-fetch-total">size</a> if it
- is known and zero otherwise; and the <code title="dom-ProgressEvents-loaded">loaded</code> attribute must be
- set to the <a href="#concept-fetch-loaded" title="concept-fetch-loaded">number of bytes
- downloaded</a>, excluding HTTP headers <a href="#concept-http-equivalent-headers" title="concept-http-equivalent-headers">or
- equivalent</a>. Otherwise, the <code title="dom-ProgressEvents-lengthComputable">lengthComputable</code>
- attribute must be set to false, and the <code title="dom-ProgressEvents-total">total</code> and the <code title="dom-ProgressEvents-loaded">loaded</code> attributes must be
+ is a <span title="fetch">fetching algorithm</span>, and the
+ <span>URL</span> being <span title="fetch">fetched</span> has the
+ <span>same origin</span> as the <code>Document</code> of the target
+ element, then the <code
+ title="dom-ProgressEvents-lengthComputable">lengthComputable</code>
+ attribute must be set to true if the <span title="fetch">fetching
+ algorithm</span>'s subject has a known <span
+ title="concept-fetch-total">size</span>; the <code
+ title="dom-ProgressEvents-total">total</code> attribute must be set
+ to the subject's <span title="concept-fetch-total">size</span> if it
+ is known and zero otherwise; and the <code
+ title="dom-ProgressEvents-loaded">loaded</code> attribute must be
+ set to the <span title="concept-fetch-loaded">number of bytes
+ downloaded</span>, excluding HTTP headers <span
+ title="concept-http-equivalent-headers">or
+ equivalent</span>. Otherwise, the <code
+ title="dom-ProgressEvents-lengthComputable">lengthComputable</code>
+ attribute must be set to false, and the <code
+ title="dom-ProgressEvents-total">total</code> and the <code
+ title="dom-ProgressEvents-loaded">loaded</code> attributes must be
set to zero. <a href="#refsPROGRESS">[PROGRESS]</a></p>
+-->
<p>The default action of these event is to do nothing where where
otherwise stated.</p>
Received on Wednesday, 14 October 2009 09:56:44 UTC