[e] (0) various clarifications for <video> and <source>.

git-svn-id: http://svn.whatwg.org/webapps@5326 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Aug 24, 2010 · 9ab9be2 · 9ab9be2
1 parent 96f9a07
commit 9ab9be2
Show file tree

Hide file tree

Showing 3 changed files with 32 additions and 6 deletions.
diff --git a/complete.html b/complete.html
@@ -23772,6 +23772,14 @@ <h4 id=the-source-element><span class=secno>4.8.8 </span>The <dfn><code>source</
   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 @@ <h5 id=network-states><span class=secno>4.8.10.4 </span>Network states</h5>
    <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 @@ <h5 id=loading-the-media-resource><span class=secno>4.8.10.5 </span>Loading the
       <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&gt;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>
 

diff --git a/index b/index
@@ -23697,6 +23697,14 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
   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 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
    <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 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
       <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&gt;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>
 

diff --git a/source b/source
@@ -25437,6 +25437,16 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
   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 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
 
    <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 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
       <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>