- 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