Skip to content
Permalink
Browse files

[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 c5ec4f6203e199721a879a3267e63520e21a8f8f
Showing with 16 additions and 67 deletions.
  1. +5 −21 complete.html
  2. +5 −21 index
  3. +6 −25 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

</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>
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
<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>

<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>
<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>
26 index
<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

</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>
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
<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>

<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>
<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>
31 source
<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-->

</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
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>
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>

<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>

<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>

<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>

0 comments on commit c5ec4f6

Please sign in to comment.