- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 16 Aug 2011 01:29:22 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv10527
Modified Files:
Overview.html
Log Message:
Revamp how .muted, .volume, and muted='' are defined (shouldn't impact implementations) (whatwg r6467)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5168
retrieving revision 1.5169
diff -u -d -r1.5168 -r1.5169
--- Overview.html 16 Aug 2011 00:40:10 -0000 1.5168
+++ Overview.html 16 Aug 2011 01:29:18 -0000 1.5169
@@ -26945,34 +26945,40 @@
<p>The <dfn id="dom-media-volume" title="dom-media-volume"><code>volume</code></dfn>
attribute must return the playback volume of any audio portions of
the <a href="#media-element">media element</a>, in the range 0.0 (silent) to 1.0
- (loudest). Initially, the volume must be 1.0, but user agents may
+ (loudest). Initially, the volume should be 1.0, but user agents may
remember the last set value across sessions, on a per-site basis or
otherwise, so the volume may start at other values. On setting, if
- the new value is in the range 0.0 to 1.0 inclusive, the attribute
- must be set to the new value. If the new value is outside the range
- 0.0 to 1.0 inclusive, then, on setting, an
- <code><a href="#index_size_err">INDEX_SIZE_ERR</a></code> exception must be raised instead.</p>
+ the new value is in the range 0.0 to 1.0 inclusive, the playback
+ volume of any audio portions of the <a href="#media-element">media element</a> must
+ be set to the new value. If the new value is outside the range 0.0
+ to 1.0 inclusive, then, on setting, an <code><a href="#index_size_err">INDEX_SIZE_ERR</a></code>
+ exception must be raised instead.</p>
<p>The <dfn id="dom-media-muted" title="dom-media-muted"><code>muted</code></dfn>
- attribute must return true if the audio channels are muted and false
- otherwise. Initially, the audio channels should not be muted
- (false), but user agents may remember the last set value across
- sessions, on a per-site basis or otherwise, so the muted state may
- start as muted (true). On setting, the attribute must be set to the
- new value.</p>
+ attribute must return true if the audio output is muted and false
+ otherwise. Initially, the audio output should not be muted (false),
+ but user agents may remember the last set value across sessions, on
+ a per-site basis or otherwise, so the muted state may start as muted
+ (true). On setting, if the new value is true then the audio output
+ should be muted and if the new value is false it should be
+ unmuted.</p>
- <p>Whenever either the <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code> or
- <code title="dom-media-volume"><a href="#dom-media-volume">volume</a></code> attributes are changed,
- the user agent must <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-volumechange"><a href="#event-media-volumechange">volumechange</a></code> at the <a href="#media-element">media
- element</a>.</p>
+ <p>Whenever either of the values that would be returned by the <code title="dom-media-volume"><a href="#dom-media-volume">volume</a></code> and <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code> attributes change, the user
+ agent must <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-volumechange"><a href="#event-media-volumechange">volumechange</a></code> at the
+ <a href="#media-element">media element</a>.</p>
<p>An element's <dfn id="effective-media-volume">effective media volume</dfn> is determined as
follows:</p>
- <ol><li><p>If the element's <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code>
- attribute is true, the element's <a href="#effective-media-volume">effective media
- volume</a> is zero. Abort these steps.</li>
+ <ol><li><p>If the user has indicated that the user agent is to override
+ the volume of the element, then the element's <a href="#effective-media-volume">effective media
+ volume</a> is the volume desired by the user. Abort these
+ steps.</li>
+
+ <li><p>If the element's audio output is muted, the element's
+ <a href="#effective-media-volume">effective media volume</a> is zero. Abort these
+ steps.</li>
<li><p>If the element has a <a href="#current-media-controller">current media controller</a>
and that <code><a href="#mediacontroller">MediaController</a></code> object's <a href="#media-controller-mute-override">media
@@ -26980,8 +26986,9 @@
<a href="#effective-media-volume">effective media volume</a> is zero. Abort these
steps.</li>
- <li><p>Let <var title="">volume</var> be the value of the element's
- <code title="dom-media-volume"><a href="#dom-media-volume">volume</a></code> attribute.</li>
+ <li><p>Let <var title="">volume</var> be the playback volume of the
+ audio portions of the <a href="#media-element">media element</a>, in range 0.0
+ (silent) to 1.0 (loudest).</li>
<li><p>If the element has a <a href="#current-media-controller">current media controller</a>,
multiply <var title="">volume</var> by that
@@ -26998,12 +27005,12 @@
</ol></div><p>The <dfn id="attr-media-muted" title="attr-media-muted"><code>muted</code></dfn>
attribute on <a href="#media-element" title="media element">media elements</a> is a
<a href="#boolean-attribute">boolean attribute</a> that controls the default state of
- the audio channel of the <a href="#media-resource">media resource</a>, potentially
+ the audio output of the <a href="#media-resource">media resource</a>, potentially
overriding user preferences.<div class="impl">
<p>When a <a href="#media-element">media element</a> is created, if it has a <code title="attr-media-muted"><a href="#attr-media-muted">muted</a></code> attribute specified, the user
- agent must set the <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code> IDL
- attribute to true, overriding any user preference.</p>
+ agent must mute the <a href="#media-element">media element</a>'s audio output,
+ overriding any user preference.</p>
<p>The <dfn id="dom-media-defaultmuted" title="dom-media-defaultMuted"><code>defaultMuted</code></dfn> IDL
attribute must <a href="#reflect">reflect</a> the <code title="attr-media-muted"><a href="#attr-media-muted">muted</a></code> content attribute.</p>
Received on Tuesday, 16 August 2011 01:29:27 UTC