Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[cgiow] (1) Drop <source media> since nobody uses it and it is mostly…
… useless anyway.

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=19619
Affected topics: DOM APIs, HTML, Video and Audio

git-svn-id: http://svn.whatwg.org/webapps@8472 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Feb 6, 2014
1 parent 455c031 commit c5ec4f6
Show file tree
Hide file tree
Showing 3 changed files with 16 additions and 67 deletions.
26 changes: 5 additions & 21 deletions complete.html
Expand Up @@ -24963,13 +24963,11 @@ <h4 id=the-source-element><span class=secno>4.7.8 </span>The <dfn><code>source</
<dd><a href=#global-attributes>Global attributes</a></dd>
<dd><code title=attr-source-src><a href=#attr-source-src>src</a></code> &mdash; Address of the resource</dd>
<dd><code title=attr-source-type><a href=#attr-source-type>type</a></code> &mdash; Type of embedded resource</dd>
<dd><code title=attr-source-media><a href=#attr-source-media>media</a></code> &mdash; Applicable media</dd>
<dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
<dd>
<pre class=idl>interface <dfn id=htmlsourceelement>HTMLSourceElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
attribute DOMString <a href=#dom-source-src title=dom-source-src>src</a>;
attribute DOMString <a href=#dom-source-type title=dom-source-type>type</a>;
attribute DOMString <a href=#dom-source-media title=dom-source-media>media</a>;
};</pre>
</dd>
</dl><!--TOPIC:HTML--><p>The <code><a href=#the-source-element>source</a></code> element allows authors to specify multiple alternative <a href=#media-resource title="media resource">media resources</a> for <a href=#media-element title="media element">media
Expand Down Expand Up @@ -25077,25 +25075,14 @@ <h4 id=the-source-element><span class=secno>4.7.8 </span>The <dfn><code>source</

</dl></div>

<p>The <dfn id=attr-source-media title=attr-source-media><code>media</code></dfn> attribute gives the intended media
type of the <a href=#media-resource>media resource</a>, to help the user agent determine if this <a href=#media-resource>media
resource</a> is useful to the user before fetching it. Its value must be a <a href=#valid-media-query>valid media
query</a>.</p>

<!-- for similar paragraphs, search for "The default, if the" -->
<p id=source-default-media class=note>The <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource
selection algorithm</a> is defined in such a way that when the <code title=attr-source-media><a href=#attr-source-media>media</a></code> attribute is omitted the user agent acts the same as if the
value was "<code title="">all</code>", i.e. by default the <a href=#media-resource>media resource</a> is suitable
for all media.</p>

<div class=impl>

<p>If a <code><a href=#the-source-element>source</a></code> element is inserted as a child of a <a href=#media-element>media element</a> that
has no <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute and whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> has the value <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code>, the user agent must invoke the <a href=#media-element>media
element</a>'s <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection
algorithm</a>.</p>

<p>The IDL attributes <dfn id=dom-source-src title=dom-source-src><code>src</code></dfn>, <dfn id=dom-source-type title=dom-source-type><code>type</code></dfn>, and <dfn id=dom-source-media title=dom-source-media><code>media</code></dfn> must <a href=#reflect>reflect</a> the respective content
<p>The IDL attributes <dfn id=dom-source-src title=dom-source-src><code>src</code></dfn> and <dfn id=dom-source-type title=dom-source-type><code>type</code></dfn> must <a href=#reflect>reflect</a> the respective content
attributes of the same name.</p>

</div>
Expand Down Expand Up @@ -26019,10 +26006,6 @@ <h5 id=loading-the-media-resource><span class=secno>4.7.10.5 </span>Loading the
types that define that parameter), represents <a href=#a-type-that-the-user-agent-knows-it-cannot-render>a type that the user agent knows it cannot
render</a>, then end the <a href=#synchronous-section>synchronous section</a>, and jump down to the <i title="">failed with elements</i> step below.</li>

<li><p>&#x231b; If <var title="">candidate</var> has a <code title=attr-source-media><a href=#attr-source-media>media</a></code> attribute whose value does not <a href=#matches-the-environment title="matches the
environment">match the environment</a>, then end the <a href=#synchronous-section>synchronous section</a>, and
jump down to the <i title="">failed with elements</i> step below.</li>

<li><p>&#x231b; Set the <code title=dom-media-currentSrc><a href=#dom-media-currentsrc>currentSrc</a></code> attribute to <var title="">absolute URL</var>.</li>

<li><p>End the <a href=#synchronous-section>synchronous section</a>, continuing the remaining steps
Expand Down Expand Up @@ -97302,6 +97285,9 @@ <h3 id=non-conforming-features><span class=secno>15.2 </span>Non-conforming feat
<dt><dfn id=attr-script-for title=attr-script-for><code>for</code></dfn> on <code><a href=#the-script-element>script</a></code> elements</dt>
<dd><p>Use DOM Events mechanisms to register event listeners. <a href=#refsDOM>[DOM]</a></dd>

<dt><dfn id=attr-source-media title=attr-source-media><code>media</code></dfn> on <code><a href=#the-source-element>source</a></code> elements</dt>
<dd><p>Use script to select the media resource(s) to use.</dd>

<dt><dfn id=attr-table-datapagesize title=attr-table-datapagesize><code>datapagesize</code></dfn> on <code><a href=#the-table-element>table</a></code> elements</dt>
<dd><p>Unnecessary. Omit it altogether.</dd>

Expand Down Expand Up @@ -100057,8 +100043,7 @@ <h3 class=no-num id=elements-1>Elements</h3>
<td>empty</td>
<td><a href=#global-attributes title="global attributes">globals</a>;
<code title=attr-source-src><a href=#attr-source-src>src</a></code>;
<code title=attr-source-type><a href=#attr-source-type>type</a></code>;
<code title=attr-source-media><a href=#attr-source-media>media</a></code></td>
<code title=attr-source-type><a href=#attr-source-type>type</a></code></td>
<td><code><a href=#htmlsourceelement>HTMLSourceElement</a></code></td>
<tr><th><code><a href=#the-span-element>span</a></code></th>
<td>Generic phrasing container</td>
Expand Down Expand Up @@ -101143,7 +101128,6 @@ <h3 class=no-num id=element-content-categories>Element content categories</h3>
<td> <a href=#valid-non-negative-integer>Valid non-negative integer</a>
<tr><th> <code title="">media</code>
<td> <code title=attr-link-media><a href=#attr-link-media>link</a></code>;
<code title=attr-source-media><a href=#attr-source-media>source</a></code>;
<code title=attr-style-media><a href=#attr-style-media>style</a></code>
<td> Applicable media
<td> <a href=#valid-media-query>Valid media query</a>
Expand Down
26 changes: 5 additions & 21 deletions index
Expand Up @@ -24963,13 +24963,11 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
<dd><a href=#global-attributes>Global attributes</a></dd>
<dd><code title=attr-source-src><a href=#attr-source-src>src</a></code> &mdash; Address of the resource</dd>
<dd><code title=attr-source-type><a href=#attr-source-type>type</a></code> &mdash; Type of embedded resource</dd>
<dd><code title=attr-source-media><a href=#attr-source-media>media</a></code> &mdash; Applicable media</dd>
<dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
<dd>
<pre class=idl>interface <dfn id=htmlsourceelement>HTMLSourceElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
attribute DOMString <a href=#dom-source-src title=dom-source-src>src</a>;
attribute DOMString <a href=#dom-source-type title=dom-source-type>type</a>;
attribute DOMString <a href=#dom-source-media title=dom-source-media>media</a>;
};</pre>
</dd>
</dl><!--TOPIC:HTML--><p>The <code><a href=#the-source-element>source</a></code> element allows authors to specify multiple alternative <a href=#media-resource title="media resource">media resources</a> for <a href=#media-element title="media element">media
Expand Down Expand Up @@ -25077,25 +25075,14 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael

</dl></div>

<p>The <dfn id=attr-source-media title=attr-source-media><code>media</code></dfn> attribute gives the intended media
type of the <a href=#media-resource>media resource</a>, to help the user agent determine if this <a href=#media-resource>media
resource</a> is useful to the user before fetching it. Its value must be a <a href=#valid-media-query>valid media
query</a>.</p>

<!-- for similar paragraphs, search for "The default, if the" -->
<p id=source-default-media class=note>The <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource
selection algorithm</a> is defined in such a way that when the <code title=attr-source-media><a href=#attr-source-media>media</a></code> attribute is omitted the user agent acts the same as if the
value was "<code title="">all</code>", i.e. by default the <a href=#media-resource>media resource</a> is suitable
for all media.</p>

<div class=impl>

<p>If a <code><a href=#the-source-element>source</a></code> element is inserted as a child of a <a href=#media-element>media element</a> that
has no <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute and whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> has the value <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code>, the user agent must invoke the <a href=#media-element>media
element</a>'s <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection
algorithm</a>.</p>

<p>The IDL attributes <dfn id=dom-source-src title=dom-source-src><code>src</code></dfn>, <dfn id=dom-source-type title=dom-source-type><code>type</code></dfn>, and <dfn id=dom-source-media title=dom-source-media><code>media</code></dfn> must <a href=#reflect>reflect</a> the respective content
<p>The IDL attributes <dfn id=dom-source-src title=dom-source-src><code>src</code></dfn> and <dfn id=dom-source-type title=dom-source-type><code>type</code></dfn> must <a href=#reflect>reflect</a> the respective content
attributes of the same name.</p>

</div>
Expand Down Expand Up @@ -26019,10 +26006,6 @@ interface <dfn id=htmlmediaelement>HTMLMediaElement</dfn> : <a href=#htmlelement
types that define that parameter), represents <a href=#a-type-that-the-user-agent-knows-it-cannot-render>a type that the user agent knows it cannot
render</a>, then end the <a href=#synchronous-section>synchronous section</a>, and jump down to the <i title="">failed with elements</i> step below.</li>

<li><p>&#x231b; If <var title="">candidate</var> has a <code title=attr-source-media><a href=#attr-source-media>media</a></code> attribute whose value does not <a href=#matches-the-environment title="matches the
environment">match the environment</a>, then end the <a href=#synchronous-section>synchronous section</a>, and
jump down to the <i title="">failed with elements</i> step below.</li>

<li><p>&#x231b; Set the <code title=dom-media-currentSrc><a href=#dom-media-currentsrc>currentSrc</a></code> attribute to <var title="">absolute URL</var>.</li>

<li><p>End the <a href=#synchronous-section>synchronous section</a>, continuing the remaining steps
Expand Down Expand Up @@ -97302,6 +97285,9 @@ if (s = prompt('What is your name?')) {
<dt><dfn id=attr-script-for title=attr-script-for><code>for</code></dfn> on <code><a href=#the-script-element>script</a></code> elements</dt>
<dd><p>Use DOM Events mechanisms to register event listeners. <a href=#refsDOM>[DOM]</a></dd>

<dt><dfn id=attr-source-media title=attr-source-media><code>media</code></dfn> on <code><a href=#the-source-element>source</a></code> elements</dt>
<dd><p>Use script to select the media resource(s) to use.</dd>

<dt><dfn id=attr-table-datapagesize title=attr-table-datapagesize><code>datapagesize</code></dfn> on <code><a href=#the-table-element>table</a></code> elements</dt>
<dd><p>Unnecessary. Omit it altogether.</dd>

Expand Down Expand Up @@ -100057,8 +100043,7 @@ if (s = prompt('What is your name?')) {
<td>empty</td>
<td><a href=#global-attributes title="global attributes">globals</a>;
<code title=attr-source-src><a href=#attr-source-src>src</a></code>;
<code title=attr-source-type><a href=#attr-source-type>type</a></code>;
<code title=attr-source-media><a href=#attr-source-media>media</a></code></td>
<code title=attr-source-type><a href=#attr-source-type>type</a></code></td>
<td><code><a href=#htmlsourceelement>HTMLSourceElement</a></code></td>
<tr><th><code><a href=#the-span-element>span</a></code></th>
<td>Generic phrasing container</td>
Expand Down Expand Up @@ -101143,7 +101128,6 @@ if (s = prompt('What is your name?')) {
<td> <a href=#valid-non-negative-integer>Valid non-negative integer</a>
<tr><th> <code title="">media</code>
<td> <code title=attr-link-media><a href=#attr-link-media>link</a></code>;
<code title=attr-source-media><a href=#attr-source-media>source</a></code>;
<code title=attr-style-media><a href=#attr-style-media>style</a></code>
<td> Applicable media
<td> <a href=#valid-media-query>Valid media query</a>
Expand Down
31 changes: 6 additions & 25 deletions source
Expand Up @@ -26363,13 +26363,11 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
<dd><span>Global attributes</span></dd>
<dd><code data-x="attr-source-src">src</code></dd>
<dd><code data-x="attr-source-type">type</code></dd>
<dd><code data-x="attr-source-media">media</code></dd>
<dt><span data-x="element-dfn-dom">DOM interface</span>:</dt><!--TOPIC:DOM APIs-->
<dd>
<pre class="idl">interface <dfn>HTMLSourceElement</dfn> : <span>HTMLElement</span> {
attribute DOMString <span data-x="dom-source-src">src</span>;
attribute DOMString <span data-x="dom-source-type">type</span>;
attribute DOMString <span data-x="dom-source-media">media</span>;
};</pre>
</dd>
</dl><!--TOPIC:HTML-->
Expand Down Expand Up @@ -26485,18 +26483,6 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>

</div>

<p>The <dfn data-x="attr-source-media"><code>media</code></dfn> attribute gives the intended media
type of the <span>media resource</span>, to help the user agent determine if this <span>media
resource</span> is useful to the user before fetching it. Its value must be a <span>valid media
query</span>.</p>

<!-- for similar paragraphs, search for "The default, if the" -->
<p id="source-default-media" class="note">The <span data-x="concept-media-load-algorithm">resource
selection algorithm</span> is defined in such a way that when the <code
data-x="attr-source-media">media</code> attribute is omitted the user agent acts the same as if the
value was "<code data-x="">all</code>", i.e. by default the <span>media resource</span> is suitable
for all media.</p>

<div class="impl">

<p>If a <code>source</code> element is inserted as a child of a <span>media element</span> that
Expand All @@ -26506,9 +26492,8 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
element</span>'s <span data-x="concept-media-load-algorithm">resource selection
algorithm</span>.</p>

<p>The IDL attributes <dfn data-x="dom-source-src"><code>src</code></dfn>, <dfn
data-x="dom-source-type"><code>type</code></dfn>, and <dfn
data-x="dom-source-media"><code>media</code></dfn> must <span>reflect</span> the respective content
<p>The IDL attributes <dfn data-x="dom-source-src"><code>src</code></dfn> and <dfn
data-x="dom-source-type"><code>type</code></dfn> must <span>reflect</span> the respective content
attributes of the same name.</p>

</div>
Expand Down Expand Up @@ -27585,11 +27570,6 @@ interface <dfn>HTMLMediaElement</dfn> : <span>HTMLElement</span> {
render</span>, then end the <span>synchronous section</span>, and jump down to the <i
data-x="">failed with elements</i> step below.</p></li>

<li><p>&#x231B; If <var data-x="">candidate</var> has a <code
data-x="attr-source-media">media</code> attribute whose value does not <span data-x="matches the
environment">match the environment</span>, then end the <span>synchronous section</span>, and
jump down to the <i data-x="">failed with elements</i> step below.</p></li>

<li><p>&#x231B; Set the <code data-x="dom-media-currentSrc">currentSrc</code> attribute to <var
data-x="">absolute URL</var>.</p></li>

Expand Down Expand Up @@ -108267,6 +108247,9 @@ if (s = prompt('What is your name?')) {
<dt><dfn data-x="attr-script-for"><code>for</code></dfn> on <code>script</code> elements</dt>
<dd><p>Use DOM Events mechanisms to register event listeners. <a href="#refsDOM">[DOM]</a></p></dd>

<dt><dfn data-x="attr-source-media"><code>media</code></dfn> on <code>source</code> elements</dt>
<dd><p>Use script to select the media resource(s) to use.</p></dd>

<dt><dfn data-x="attr-table-datapagesize"><code>datapagesize</code></dfn> on <code>table</code> elements</dt>
<dd><p>Unnecessary. Omit it altogether.</p></dd>

Expand Down Expand Up @@ -111612,8 +111595,7 @@ if (s = prompt('What is your name?')) {
<td>empty</td>
<td><span data-x="global attributes">globals</span>;
<code data-x="attr-source-src">src</code>;
<code data-x="attr-source-type">type</code>;
<code data-x="attr-source-media">media</code></td>
<code data-x="attr-source-type">type</code></td>
<td><code>HTMLSourceElement</code></td>
</tr>

Expand Down Expand Up @@ -112879,7 +112861,6 @@ if (s = prompt('What is your name?')) {
<tr>
<th> <code data-x="">media</code>
<td> <code data-x="attr-link-media">link</code>;
<code data-x="attr-source-media">source</code>;
<code data-x="attr-style-media">style</code>
<td> Applicable media
<td> <span>Valid media query</span>
Expand Down

0 comments on commit c5ec4f6

Please sign in to comment.