[html5] r5326 - [e] (0) various clarifications for <video> and <source>.
whatwg at whatwg.org
whatwg at whatwg.org
Tue Aug 24 00:32:35 PDT 2010
Author: ianh
Date: 2010-08-24 00:32:33 -0700 (Tue, 24 Aug 2010)
New Revision: 5326
Modified:
complete.html
index
source
Log:
[e] (0) various clarifications for <video> and <source>.
Modified: complete.html
===================================================================
--- complete.html 2010-08-24 01:20:19 UTC (rev 5325)
+++ complete.html 2010-08-24 07:32:33 UTC (rev 5326)
@@ -23772,6 +23772,14 @@
be a <a href=#valid-non-empty-url-potentially-surrounded-by-spaces>valid non-empty URL potentially surrounded by
spaces</a>. This attribute must be present.</p>
+ <p class=note>Dynamically modifying a <code><a href=#the-source-element>source</a></code> element
+ and its attribute when the element is already inserted in a
+ <code><a href=#video>video</a></code> or <code><a href=#audio>audio</a></code> element will have no
+ effect. To change what is playing, either just use the <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute on the <a href=#media-element>media
+ element</a> directly, or call the <code title=dom-media-load><a href=#dom-media-load>load()</a></code> method on the <a href=#media-element>media
+ element</a> after manipulating the <code><a href=#the-source-element>source</a></code>
+ elements.</p>
+
<p>The <dfn id=attr-source-type title=attr-source-type><code>type</code></dfn>
attribute gives the type of the <a href=#media-resource>media resource</a>, to help
the user agent determine if it can play this <a href=#media-resource>media
@@ -24434,7 +24442,7 @@
<dt><dfn id=dom-media-network_no_source title=dom-media-NETWORK_NO_SOURCE><code>NETWORK_NO_SOURCE</code></dfn> (numeric value 3)</dt>
<dd>The element<span class=impl>'s <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection
- algorithm</a> is active, but it</span> has failed to find a
+ algorithm</a> is active, but it</span> has so not yet found a
<a href=#media-resource title="media resource">resource</a> to use.</dd>
</dl><div class=impl>
@@ -24527,7 +24535,7 @@
<p>Set the <a href=#current-playback-position>current playback position</a> to 0.</p>
<p>If this changed the <a href=#current-playback-position>current playback position</a>,
- then span>queue a task to <a href=#fire-a-simple-event>fire a simple
+ then <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-timeupdate><a href=#event-media-timeupdate>timeupdate</a></code> at the
<a href=#media-element>media element</a>.</p>
Modified: index
===================================================================
--- index 2010-08-24 01:20:19 UTC (rev 5325)
+++ index 2010-08-24 07:32:33 UTC (rev 5326)
@@ -23697,6 +23697,14 @@
be a <a href=#valid-non-empty-url-potentially-surrounded-by-spaces>valid non-empty URL potentially surrounded by
spaces</a>. This attribute must be present.</p>
+ <p class=note>Dynamically modifying a <code><a href=#the-source-element>source</a></code> element
+ and its attribute when the element is already inserted in a
+ <code><a href=#video>video</a></code> or <code><a href=#audio>audio</a></code> element will have no
+ effect. To change what is playing, either just use the <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute on the <a href=#media-element>media
+ element</a> directly, or call the <code title=dom-media-load><a href=#dom-media-load>load()</a></code> method on the <a href=#media-element>media
+ element</a> after manipulating the <code><a href=#the-source-element>source</a></code>
+ elements.</p>
+
<p>The <dfn id=attr-source-type title=attr-source-type><code>type</code></dfn>
attribute gives the type of the <a href=#media-resource>media resource</a>, to help
the user agent determine if it can play this <a href=#media-resource>media
@@ -24359,7 +24367,7 @@
<dt><dfn id=dom-media-network_no_source title=dom-media-NETWORK_NO_SOURCE><code>NETWORK_NO_SOURCE</code></dfn> (numeric value 3)</dt>
<dd>The element<span class=impl>'s <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection
- algorithm</a> is active, but it</span> has failed to find a
+ algorithm</a> is active, but it</span> has so not yet found a
<a href=#media-resource title="media resource">resource</a> to use.</dd>
</dl><div class=impl>
@@ -24452,7 +24460,7 @@
<p>Set the <a href=#current-playback-position>current playback position</a> to 0.</p>
<p>If this changed the <a href=#current-playback-position>current playback position</a>,
- then span>queue a task to <a href=#fire-a-simple-event>fire a simple
+ then <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-timeupdate><a href=#event-media-timeupdate>timeupdate</a></code> at the
<a href=#media-element>media element</a>.</p>
Modified: source
===================================================================
--- source 2010-08-24 01:20:19 UTC (rev 5325)
+++ source 2010-08-24 07:32:33 UTC (rev 5326)
@@ -25437,6 +25437,16 @@
be a <span>valid non-empty URL potentially surrounded by
spaces</span>. This attribute must be present.</p>
+ <p class="note">Dynamically modifying a <code>source</code> element
+ and its attribute when the element is already inserted in a
+ <code>video</code> or <code>audio</code> element will have no
+ effect. To change what is playing, either just use the <code
+ title="attr-media-src">src</code> attribute on the <span>media
+ element</span> directly, or call the <code
+ title="dom-media-load">load()</code> method on the <span>media
+ element</span> after manipulating the <code>source</code>
+ elements.</p>
+
<p>The <dfn title="attr-source-type"><code>type</code></dfn>
attribute gives the type of the <span>media resource</span>, to help
the user agent determine if it can play this <span>media
@@ -26192,7 +26202,7 @@
<dd>The element<span class="impl">'s <span
title="concept-media-load-algorithm">resource selection
- algorithm</span> is active, but it</span> has failed to find a
+ algorithm</span> is active, but it</span> has so not yet found a
<span title="media resource">resource</span> to use.</dd>
</dl>
@@ -26305,7 +26315,7 @@
<p>Set the <span>current playback position</span> to 0.</p>
<p>If this changed the <span>current playback position</span>,
- then span>queue a task</span> to <span>fire a simple
+ then <span>queue a task</span> to <span>fire a simple
event</span> named <code
title="event-media-timeupdate">timeupdate</code> at the
<span>media element</span>.</p>
More information about the Commit-Watchers
mailing list