- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 15 Oct 2010 21:29:03 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv7004
Modified Files:
Overview.html
Log Message:
Add <video audio=muted>. (whatwg r5636)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4511
retrieving revision 1.4512
diff -u -d -r1.4511 -r1.4512
--- Overview.html 15 Oct 2010 00:18:35 -0000 1.4511
+++ Overview.html 15 Oct 2010 21:28:59 -0000 1.4512
@@ -63,7 +63,8 @@
h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
h1 + h2, hr + h2.no-toc { page-break-before: auto; }
- p > span:not([title=""]):not([class="XXX"]):not([class="impl"]), li > span:not([title=""]):not([class="XXX"]):not([class="impl"]) { border-bottom: solid #9999CC; }
+ p > span:not([title=""]):not([class="XXX"]):not([class="impl"]):not([class="note"]),
+ li > span:not([title=""]):not([class="XXX"]):not([class="impl"]):not([class="note"]), { border-bottom: solid #9999CC; }
div.head { margin: 0 0 1em; padding: 1em 0 0 0; }
div.head p { margin: 0; }
@@ -20694,6 +20695,7 @@
<dd><code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code></dd>
<dd><code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code></dd>
<dd><code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code></dd>
+ <dd><code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code></dd>
<dd><code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code></dd>
<dd><code title="attr-dim-width"><a href="#attr-dim-width">width</a></code></dd>
<dd><code title="attr-dim-height"><a href="#attr-dim-height">height</a></code></dd>
@@ -20705,6 +20707,7 @@
readonly attribute unsigned long <a href="#dom-video-videowidth" title="dom-video-videoWidth">videoWidth</a>;
readonly attribute unsigned long <a href="#dom-video-videoheight" title="dom-video-videoHeight">videoHeight</a>;
attribute DOMString <a href="#dom-video-poster" title="dom-video-poster">poster</a>;
+ attribute boolean <a href="#dom-media-audio" title="dom-media-audio">audio</a>; <!-- attr-media-audio -->
};</pre>
</dd>
</dl><p>A <code><a href="#video">video</a></code> element is used for playing videos or
@@ -20722,7 +20725,9 @@
overlays) into their media streams.<p>The <code><a href="#video">video</a></code> element is a <a href="#media-element">media element</a>
whose <a href="#media-data">media data</a> is ostensibly video data, possibly
with associated audio data.<p>The <code title="attr-media-src"><a href="#attr-media-src">src</a></code>, <code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code>, <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code>, <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code>, and <code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code> attributes are <a href="#media-element-attributes" title="media element attributes">the attributes common to all media
- elements</a>.<p>The <dfn id="attr-video-poster" title="attr-video-poster"><code>poster</code></dfn>
+ elements</a>. The <code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code>
+ attribute <a href="#attr-media-audio" title="attr-media-audio">controls the audio
+ channel</a>.<p>The <dfn id="attr-video-poster" title="attr-video-poster"><code>poster</code></dfn>
attribute gives the address of an image file that the user agent can
show while no video data is available. The attribute, if present,
must contain a <a href="#valid-non-empty-url-potentially-surrounded-by-spaces">valid non-empty URL potentially surrounded by
@@ -20740,9 +20745,6 @@
(typically one of the first non-blank frames) that gives the user an
idea of what the video is like.<div class="impl">
- <p>The <dfn id="dom-video-poster" title="dom-video-poster"><code>poster</code></dfn> IDL
- attribute must <a href="#reflect">reflect</a> the <code title="attr-video-poster"><a href="#attr-video-poster">poster</a></code> content attribute.</p>
-
<hr><p>When no video data is available (the element's <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute is either
<code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>, or <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code> but no video
data has yet been obtained at all), the <code><a href="#video">video</a></code> element
@@ -20880,6 +20882,12 @@
agents could disable screensavers while video playback is in
progress.</p>
+ <hr><p>The <dfn id="dom-video-poster" title="dom-video-poster"><code>poster</code></dfn> IDL
+ attribute must <a href="#reflect">reflect</a> the <code title="attr-video-poster"><a href="#attr-video-poster">poster</a></code> content attribute.</p>
+
+ <p>The <dfn id="dom-media-audio" title="dom-media-audio"><code>audio</code></dfn> IDL
+ attribute must <a href="#reflect">reflect</a> the <code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code> content attribute.</p>
+
</div><div class="example">
<p>This example shows how to detect when a video has failed to play
@@ -21410,7 +21418,7 @@
<a href="#mutabletimedtrack">MutableTimedTrack</a> <a href="#dom-media-addtrack" title="dom-media-addTrack">addTrack</a>(in DOMString kind, in optional DOMString label, in optional DOMString language);
<!--KEEP-START w3c-html--><!--TT-->
};</pre><p>The <dfn id="media-element-attributes">media element attributes</dfn>, <code title="attr-media-src"><a href="#attr-media-src">src</a></code>, <code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code>, <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code>, <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code>, and <code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code>, apply to all <a href="#media-element" title="media element">media elements</a>. They are defined in
- this section.</p><!-- proposed v2 (actually v3!) features:
+ this section.</p><!-- attr-media-audio --><!-- proposed v2 (actually v3!) features:
* frame forward / backwards / step(n) while paused
* hasAudio, hasVideo, hasCaptions, etc
* per-frame control: get current frame; set current frame
@@ -25187,6 +25195,48 @@
event</a> named <code title="event-media-volumechange"><a href="#event-media-volumechange">volumechange</a></code> at the <a href="#media-element">media
element</a>.</p>
+ </div><p>The <dfn id="attr-media-audio" title="attr-media-audio"><code>audio</code></dfn>
+ attribute on the <code><a href="#video">video</a></code> element controls the default
+ state of the audio channel of the <a href="#media-resource">media resource</a>,
+ potentially overriding user preferences.<p>The <code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code> attribute, if
+ specified, must have a value that is an <a href="#unordered-set-of-unique-space-separated-tokens">unordered set of
+ unique space-separated tokens</a>, which are <a href="#ascii-case-insensitive">ASCII
+ case-insensitive</a>. The tokens must be from the following list
+ (currently, only one allowed token is defined):<dl><dt><dfn id="attr-media-audio-keyword-muted" 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.<div class="impl">
+
+ <p>When a <code><a href="#video">video</a></code> element is created, if it has an <code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code> attribute specified, the user
+ agent must <a href="#split-a-string-on-spaces" title="split a string on spaces">split the
+ attribute's value on spaces</a>; if any of the tokens are an
+ <a href="#ascii-case-insensitive">ASCII case-insensitive</a> match for the string <code title="attr-media-audio-keyword-muted"><a href="#attr-media-audio-keyword-muted">muted</a></code>, the user agent
+ must then set the <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></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).<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 id="time-ranges"><span class="secno">4.8.10.12 </span>Time ranges</h5><p>Objects implementing the <code><a href="#timeranges">TimeRanges</a></code> interface
represent a list of ranges (periods) of time.<pre class="idl">interface <dfn id="timeranges">TimeRanges</dfn> {
readonly attribute unsigned long <a href="#dom-timeranges-length" title="dom-TimeRanges-length">length</a>;
Received on Friday, 15 October 2010 21:29:05 UTC