Short URL: http://html5.org/r/5636
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 5636 | 10419 | 2010-10-15 21:28 |
Index: source
===================================================================
--- source (revision 5635)
+++ source (revision 5636)
@@ -25581,6 +25581,7 @@
<dd><code title="attr-media-preload">preload</code></dd>
<dd><code title="attr-media-autoplay">autoplay</code></dd>
<dd><code title="attr-media-loop">loop</code></dd>
+ <dd><code title="attr-media-audio">audio</code></dd>
<dd><code title="attr-media-controls">controls</code></dd>
<dd><code title="attr-dim-width">width</code></dd>
<dd><code title="attr-dim-height">height</code></dd>
@@ -25592,6 +25593,7 @@
readonly attribute unsigned long <span title="dom-video-videoWidth">videoWidth</span>;
readonly attribute unsigned long <span title="dom-video-videoHeight">videoHeight</span>;
attribute DOMString <span title="dom-video-poster">poster</span>;
+ attribute boolean <span title="dom-media-audio">audio</span>; <!-- attr-media-audio -->
};</pre>
</dd>
</dl>
@@ -25624,7 +25626,9 @@
title="attr-media-loop">loop</code>, and <code
title="attr-media-controls">controls</code> attributes are <span
title="media element attributes">the attributes common to all media
- elements</span>.</p>
+ elements</span>. The <code title="attr-media-audio">audio</code>
+ attribute <span title="attr-media-audio">controls the audio
+ channel</span>.</p>
<p>The <dfn title="attr-video-poster"><code>poster</code></dfn>
attribute gives the address of an image file that the user agent can
@@ -25651,10 +25655,6 @@
<div class="impl">
- <p>The <dfn title="dom-video-poster"><code>poster</code></dfn> IDL
- attribute must <span>reflect</span> the <code
- title="attr-video-poster">poster</code> content attribute.</p>
-
<hr>
<p>When no video data is available (the element's <code
@@ -25822,6 +25822,16 @@
agents could disable screensavers while video playback is in
progress.</p>
+ <hr>
+
+ <p>The <dfn title="dom-video-poster"><code>poster</code></dfn> IDL
+ attribute must <span>reflect</span> the <code
+ title="attr-video-poster">poster</code> content attribute.</p>
+
+ <p>The <dfn title="dom-media-audio"><code>audio</code></dfn> IDL
+ attribute must <span>reflect</span> the <code
+ title="attr-media-audio">audio</code> content attribute.</p>
+
</div>
<div class="example">
@@ -26534,7 +26544,7 @@
title="attr-media-loop">loop</code>, and <code
title="attr-media-controls">controls</code>, apply to all <span
title="media element">media elements</span>. They are defined in
- this section.</p>
+ this section.</p> <!-- attr-media-audio -->
<!-- proposed v2 (actually v3!) features:
* frame forward / backwards / step(n) while paused
@@ -32886,9 +32896,69 @@
</div>
+ <p>The <dfn title="attr-media-audio"><code>audio</code></dfn>
+ attribute on the <code>video</code> element controls the default
+ state of the audio channel of the <span>media resource</span>,
+ potentially overriding user preferences.</p>
+ <p>The <code title="attr-media-audio">audio</code> attribute, if
+ specified, must have a value that is an <span>unordered set of
+ unique space-separated tokens</span>, which are <span>ASCII
+ case-insensitive</span>. The tokens must be from the following list
+ (currently, only one allowed token is defined):</p>
+ <dl>
+ <dt><dfn title="attr-media-audio-keyword-muted"><code>muted</code></dfn></dt>
+
+ <dd>
+
+ <p>Causes the user agent to override the user's preferences, if
+ any, and always default the video to muted.</p>
+
+ </dd>
+
+ </dl>
+
+ <p class="note">A future version of this specification will probably
+ introduce new values here, e.g. to control the default volume, or to
+ select a default audio track.</p>
+
+ <div class="impl">
+
+ <p>When a <code>video</code> element is created, if it has an <code
+ title="attr-media-audio">audio</code> attribute specified, the user
+ agent must <span title="split a string on spaces">split the
+ attribute's value on spaces</span>; if any of the tokens are an
+ <span>ASCII case-insensitive</span> match for the string <code
+ title="attr-media-audio-keyword-muted">muted</code>, the user agent
+ must then set the <code title="dom-media-muted">muted</code>
+ attribute to true, overriding any user preference.</p>
+
+ <!-- attr-media-audio
+ <p>The <dfn title="dom-media-audio"><code>audio</code></dfn> IDL
+ attribute must <span>reflect</span> the content attribute of the
+ same name.</p>
+ -->
+
+ </div>
+
+ <p class="note">This attribute has no dynamic effect (it only
+ controls the default state of the element).</p>
+
+ <div class="example">
+
+ <p>This video (an advertisment) autoplays, but to avoid annoying
+ users, it does so without sound, and allows the user to turn the
+ sound on.</p>
+
+ <pre><video src="adverts.cgi?kind=video" controls autoplay loop audio=muted></video></pre>
+
+ </div>
+
+
+
+
<h5>Time ranges</h5>
<p>Objects implementing the <code>TimeRanges</code> interface