- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 16 Aug 2011 01:46:27 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv12484
Modified Files:
spec.html the-iframe-element.html
Log Message:
Revamp how .muted, .volume, and muted='' are defined (shouldn't impact implementations) (whatwg r6467)
[updated by splitter]
Index: the-iframe-element.html
===================================================================
RCS file: /sources/public/html5/spec/the-iframe-element.html,v
retrieving revision 1.97
retrieving revision 1.98
diff -u -d -r1.97 -r1.98
--- the-iframe-element.html 15 Aug 2011 21:46:28 -0000 1.97
+++ the-iframe-element.html 16 Aug 2011 01:46:25 -0000 1.98
@@ -7638,34 +7638,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="infrastructure.html#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="infrastructure.html#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="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#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="webappapis.html#queue-a-task">queue a task</a> to <a href="webappapis.html#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.</p></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.</p></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.</p></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
@@ -7673,8 +7679,9 @@
<a href="#effective-media-volume">effective media volume</a> is zero. Abort these
steps.</p></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.</p></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).</p></li>
<li><p>If the element has a <a href="#current-media-controller">current media controller</a>,
multiply <var title="">volume</var> by that
@@ -7691,12 +7698,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="common-microsyntaxes.html#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.</p><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="common-dom-interfaces.html#reflect">reflect</a> the <code title="attr-media-muted"><a href="#attr-media-muted">muted</a></code> content attribute.</p>
Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec/spec.html,v
retrieving revision 1.1628
retrieving revision 1.1629
diff -u -d -r1.1628 -r1.1629
--- spec.html 16 Aug 2011 00:46:43 -0000 1.1628
+++ spec.html 16 Aug 2011 01:46:25 -0000 1.1629
@@ -350,7 +350,7 @@
<a href="Overview.html">single page HTML</a>,
<a href="spec.html">multipage HTML</a>,
<a href="author/">web developer edition</a>.
-This is revision 1.5168.
+This is revision 1.5169.
</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2011 <a href="http://www.w3.org/"><abbr title="World Wide
Received on Tuesday, 16 August 2011 01:46:29 UTC