[html5] r7807 - [e] (0) Various editorial fixes and cleanup. Affected topics: DOM APIs, HTML
whatwg at whatwg.org
whatwg at whatwg.org
Thu Apr 11 14:42:14 PDT 2013
Author: ianh
Date: 2013-04-11 14:42:13 -0700 (Thu, 11 Apr 2013)
New Revision: 7807
Modified:
complete.html
index
source
Log:
[e] (0) Various editorial fixes and cleanup.
Affected topics: DOM APIs, HTML
Modified: complete.html
===================================================================
--- complete.html 2013-04-11 21:33:47 UTC (rev 7806)
+++ complete.html 2013-04-11 21:42:13 UTC (rev 7807)
@@ -11082,15 +11082,14 @@
<h4 id=requirements-relating-to-bidirectional-algorithm-formatting-characters><span class=secno>3.2.6 </span>Requirements relating to bidirectional-algorithm formatting characters</h4>
-<!--CLEANUP-->
<p><a href=#text-content>Text content</a> in <a href=#html-elements>HTML elements</a> with child <code><a href=#text>Text</a></code> nodes, and
text in attributes of <a href=#html-elements>HTML elements</a> that allow free-form text, may contain characters
- in the ranges U+202A to U+202E and U+2066 to U+2069 (the bidirectional-algorithm formatting characters). However, the
- use of these characters is restricted so that any embedding or overrides generated by these
- characters do not start and end with different parent elements, and so that all such embeddings
- and overrides are explicitly terminated by a U+202C POP DIRECTIONAL FORMATTING character. This
- helps reduce incidences of text being reused in a manner that has unforeseen effects on the
- bidirectional algorithm. <a href=#refsBIDI>[BIDI]</a></p>
+ in the ranges U+202A to U+202E and U+2066 to U+2069 (the bidirectional-algorithm formatting
+ characters). However, the use of these characters is restricted so that any embedding or overrides
+ generated by these characters do not start and end with different parent elements, and so that all
+ such embeddings and overrides are explicitly terminated by a U+202C POP DIRECTIONAL FORMATTING
+ character. This helps reduce incidences of text being reused in a manner that has unforeseen
+ effects on the bidirectional algorithm. <a href=#refsBIDI>[BIDI]</a></p>
<p>The aforementioned restrictions are defined by specifying that certain parts of documents form
<a href=#bidirectional-algorithm-formatting-character-ranges>bidirectional-algorithm formatting character ranges</a>, and then imposing a requirement
@@ -11188,52 +11187,40 @@
<h4 id=wai-aria><span class=secno>3.2.7 </span><dfn>WAI-ARIA</dfn></h4>
- <p>Authors may use the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code>
- and <code title=attr-aria-*>aria-*</code> attributes on <a href=#html-elements>HTML
- elements</a>, in accordance with the requirements described in
- the ARIA specifications, except where these conflict with the
- <a href=#strong-native-semantics>strong native semantics</a> or are equal to the
- <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> described below. These
- exceptions are intended to prevent authors from making assistive
- technology products report nonsensical states that do not represent
- the actual state of the document. <a href=#refsARIA>[ARIA]</a></p>
+ <p>Authors may use the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code> attributes on <a href=#html-elements>HTML elements</a>, in accordance with the
+ requirements described in the ARIA specifications, except where these conflict with the
+ <a href=#strong-native-semantics>strong native semantics</a> or are equal to the <a href=#default-implicit-aria-semantics>default implicit ARIA
+ semantics</a> described below. These exceptions are intended to prevent authors from making
+ assistive technology products report nonsensical states that do not represent the actual state of
+ the document. <a href=#refsARIA>[ARIA]</a></p>
- <p>Authors must not set the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code> attributes in a manner that
- conflicts with the semantics described in the following table,
- except that the <code title=attr-aria-role-presentation>presentation</code> role may
- always be used. Authors must not set the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code> attributes to values that match
- the <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined in the
+ <p>Authors must not set the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code> attributes in a manner that conflicts with the semantics
+ described in the following table, except that the <code title=attr-aria-role-presentation>presentation</code> role may always be used. Authors must not
+ set the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code>
+ attributes to values that match the <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined in the
following two tables.</p>
<div class=impl>
- <p>User agents are required to implement ARIA semantics on all
- <a href=#html-elements>HTML elements</a>, as defined in the ARIA specifications.
- The <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below must
- be recognized by implementations for the purposes of ARIA
- processing. <a href=#refsARIAIMPL>[ARIAIMPL]</a></p>
+ <p>User agents are required to implement ARIA semantics on all <a href=#html-elements>HTML elements</a>, as
+ defined in the ARIA specifications. The <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below
+ must be recognized by implementations for the purposes of ARIA processing. <a href=#refsARIAIMPL>[ARIAIMPL]</a></p>
- <p class=note>The ARIA attributes defined in the ARIA
- specifications, and the <a href=#strong-native-semantics>strong native semantics</a> and
- <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below, do not
- have any effect on CSS pseudo-class matching, user interface
- modalities that don't use assistive technologies, or the default
- actions of user interaction events as described in this
- specification.</p> <!-- this is a truism, in that there are no
- requirements that require that those attributes have such an effect,
- and no requirements that relax the requirements on those effects
- such that they could be affected by those attributes -->
+ <p class=note>The ARIA attributes defined in the ARIA specifications, and the <a href=#strong-native-semantics>strong
+ native semantics</a> and <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below, do not
+ have any effect on CSS pseudo-class matching, user interface modalities that don't use assistive
+ technologies, or the default actions of user interaction events as described in this
+ specification.</p> <!-- this is a truism, in that there are no requirements that require that
+ those attributes have such an effect, and no requirements that relax the requirements on those
+ effects such that they could be affected by those attributes -->
</div>
- <p>The following table defines the <a href=#strong-native-semantics>strong native
- semantics</a> and corresponding <a href=#default-implicit-aria-semantics>default implicit ARIA
- semantics</a> that apply to <a href=#html-elements>HTML elements</a>. Each
- language feature (element or attribute) in a cell in the first
- column implies the ARIA semantics (any role, states, and properties)
- given in the cell in the second column of the same row. <span class=impl>When multiple rows apply to an element, the role from
- the last row to define a role must be applied, and the states and
- properties from all the rows must be combined.</span></p>
+ <p>The following table defines the <a href=#strong-native-semantics>strong native semantics</a> and corresponding
+ <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> that apply to <a href=#html-elements>HTML elements</a>. Each
+ language feature (element or attribute) in a cell in the first column implies the ARIA semantics
+ (any role, states, and properties) given in the cell in the second column of the same row. <span class=impl>When multiple rows apply to an element, the role from the last row to define a role
+ must be applied, and the states and properties from all the rows must be combined.</span></p>
<table id=table-aria-strong><thead><tr><th>Language feature
<th><a href=#strong-native-semantics>Strong native semantics</a> and <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a>
@@ -11588,36 +11575,28 @@
<td><code title=attr-aria-role-document>document</code> role
<td>Role must be either <code title=attr-aria-role-document>document</code> or <code title=attr-aria-role-application>application</code>
- </table><p>The entry "<dfn id=concept-role-none title=concept-role-none>no role</dfn>", when
- used as a <a href=#strong-native-semantics title="strong native semantics">strong native
- semantic</a>, means that no role other than <code title=attr-aria-role-presentation>presentation</code> can be used.
- When used as a <a href=#default-implicit-aria-semantics title="default implicit ARIA semantics">default
- implicit ARIA semantic</a>, it means the user agent has no default
- mapping to ARIA roles. (However, it probably will have its own
- mappings to the accessibility layer.)</p>
+ </table><p>The entry "<dfn id=concept-role-none title=concept-role-none>no role</dfn>", when used as a <a href=#strong-native-semantics title="strong
+ native semantics">strong native semantic</a>, means that no role other than <code title=attr-aria-role-presentation>presentation</code> can be used. When used as a <a href=#default-implicit-aria-semantics title="default implicit ARIA semantics">default implicit ARIA semantic</a>, it means the user
+ agent has no default mapping to ARIA roles. (However, it probably will have its own mappings to
+ the accessibility layer.)</p>
<div class=impl>
- <p>Conformance checkers are encouraged to phrase errors such that
- authors are encouraged to use more appropriate elements rather than
- remove accessibility annotations. For example, if an <code><a href=#the-a-element>a</a></code>
- element is marked as having the <code title=attr-aria-role-button>button</code> role, a conformance
- checker could say "Use a more appropriate element to represent a
- button, for example a <code><a href=#the-button-element>button</a></code> element or an
- <code><a href=#the-input-element>input</a></code> element" rather than "The <code title=attr-aria-role-button>button</code> role cannot be used with
- <code><a href=#the-a-element>a</a></code> elements".</p>
+ <p>Conformance checkers are encouraged to phrase errors such that authors are encouraged to use
+ more appropriate elements rather than remove accessibility annotations. For example, if an
+ <code><a href=#the-a-element>a</a></code> element is marked as having the <code title=attr-aria-role-button>button</code>
+ role, a conformance checker could say "Use a more appropriate element to represent a button, for
+ example a <code><a href=#the-button-element>button</a></code> element or an <code><a href=#the-input-element>input</a></code> element" rather than "The <code title=attr-aria-role-button>button</code> role cannot be used with <code><a href=#the-a-element>a</a></code> elements".</p>
</div>
<div class=example>
- <p>These features can be used to make accessibility tools render
- content to their users in more useful ways. For example, ASCII art,
- which is really an image, appears to be text, and in the absence of
- appropriate annotations would end up being rendered by screen
- readers as a very painful reading of lots of punctuation. Using the
- features described in this section, one can instead make the ATs
- skip the ASCII art and just read the caption:</p>
+ <p>These features can be used to make accessibility tools render content to their users in more
+ useful ways. For example, ASCII art, which is really an image, appears to be text, and in the
+ absence of appropriate annotations would end up being rendered by screen readers as a very
+ painful reading of lots of punctuation. Using the features described in this section, one can
+ instead make the ATs skip the ASCII art and just read the caption:</p>
<pre><figure <strong>role="img" aria-labelledby="fish-caption"</strong>> <!-- that's "labelled" with TWO "l"s -->
<pre>
@@ -50887,84 +50866,74 @@
readonly attribute long <a href=#dom-option-index title=dom-option-index>index</a>;
};</pre>
</dd>
- </dl><!--TOPIC:HTML--><!--CLEANUP--><p>The <code><a href=#the-option-element>option</a></code> element <a href=#represents>represents</a> an option
- in a <code><a href=#the-select-element>select</a></code> element or as part of a list of suggestions
- in a <code><a href=#the-datalist-element>datalist</a></code> element.</p>
+ </dl><!--TOPIC:HTML--><p>The <code><a href=#the-option-element>option</a></code> element <a href=#represents>represents</a> an option in a <code><a href=#the-select-element>select</a></code>
+ element or as part of a list of suggestions in a <code><a href=#the-datalist-element>datalist</a></code> element.</p>
- <p>In certain circumstances described in the definition of the
- <code><a href=#the-select-element>select</a></code> element, an <code><a href=#the-option-element>option</a></code> element can be a
- <code><a href=#the-select-element>select</a></code> element's <a href=#placeholder-label-option>placeholder label option</a>.
- A <a href=#placeholder-label-option>placeholder label option</a> does not represent an actual
- option, but instead represents a label for the <code><a href=#the-select-element>select</a></code>
- control.</p>
+ <p>In certain circumstances described in the definition of the <code><a href=#the-select-element>select</a></code> element, an
+ <code><a href=#the-option-element>option</a></code> element can be a <code><a href=#the-select-element>select</a></code> element's <a href=#placeholder-label-option>placeholder label
+ option</a>. A <a href=#placeholder-label-option>placeholder label option</a> does not represent an actual option, but
+ instead represents a label for the <code><a href=#the-select-element>select</a></code> control.</p>
- <p>The <dfn id=attr-option-disabled title=attr-option-disabled><code>disabled</code></dfn>
- attribute is a <a href=#boolean-attribute>boolean attribute</a>. An
- <code><a href=#the-option-element>option</a></code> element is <dfn id=concept-option-disabled title=concept-option-disabled>disabled</dfn> if its <code title=attr-option-disabled><a href=#attr-option-disabled>disabled</a></code> attribute is present or
- if it is a child of an <code><a href=#the-optgroup-element>optgroup</a></code> element whose <code title=attr-optgroup-disabled><a href=#attr-optgroup-disabled>disabled</a></code> attribute is
- present.</p>
+ <p>The <dfn id=attr-option-disabled title=attr-option-disabled><code>disabled</code></dfn> attribute is a <a href=#boolean-attribute>boolean
+ attribute</a>. An <code><a href=#the-option-element>option</a></code> element is <dfn id=concept-option-disabled title=concept-option-disabled>disabled</dfn> if its <code title=attr-option-disabled><a href=#attr-option-disabled>disabled</a></code> attribute is present or if it is a child of an
+ <code><a href=#the-optgroup-element>optgroup</a></code> element whose <code title=attr-optgroup-disabled><a href=#attr-optgroup-disabled>disabled</a></code> attribute
+ is present.</p>
<div class=impl>
- <p>An <code><a href=#the-option-element>option</a></code> element that is <a href=#attr-option-disabled title=attr-option-disabled>disabled</a> must prevent any <code title=event-click><a href=#event-click>click</a></code> events that are <a href=#queue-a-task title="queue
- a task">queued</a> on the <a href=#user-interaction-task-source>user interaction task
- source</a> from being dispatched on the element.</p>
+ <p>An <code><a href=#the-option-element>option</a></code> element that is <a href=#attr-option-disabled title=attr-option-disabled>disabled</a> must
+ prevent any <code title=event-click><a href=#event-click>click</a></code> events that are <a href=#queue-a-task title="queue a
+ task">queued</a> on the <a href=#user-interaction-task-source>user interaction task source</a> from being dispatched on the
+ element.</p>
</div>
- <p>The <dfn id=attr-option-label title=attr-option-label><code>label</code></dfn>
- attribute provides a label for element. The <dfn id=concept-option-label title=concept-option-label>label</dfn> of an <code><a href=#the-option-element>option</a></code>
- element is the value of the <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if there
- is one, or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL attribute.</p>
+ <p>The <dfn id=attr-option-label title=attr-option-label><code>label</code></dfn> attribute provides a label for
+ element. The <dfn id=concept-option-label title=concept-option-label>label</dfn> of an <code><a href=#the-option-element>option</a></code> element is
+ the value of the <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if there is one,
+ or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL
+ attribute.</p>
<p>The <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if specified, must not be
empty. If the attribute is not specified, then the element itself must not be empty.</p>
- <p>The <dfn id=attr-option-value title=attr-option-value><code>value</code></dfn>
- attribute provides a value for element. The <dfn id=concept-option-value title=concept-option-value>value</dfn> of an <code><a href=#the-option-element>option</a></code>
- element is the value of the <code title=attr-option-value><a href=#attr-option-value>value</a></code> content attribute, if there
- is one, or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL attribute.</p>
+ <p>The <dfn id=attr-option-value title=attr-option-value><code>value</code></dfn> attribute provides a value for
+ element. The <dfn id=concept-option-value title=concept-option-value>value</dfn> of an <code><a href=#the-option-element>option</a></code> element is
+ the value of the <code title=attr-option-value><a href=#attr-option-value>value</a></code> content attribute, if there is one,
+ or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL
+ attribute.</p>
- <p>The <dfn id=attr-option-selected title=attr-option-selected><code>selected</code></dfn>
- attribute is a <a href=#boolean-attribute>boolean attribute</a>. It represents the
- default <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the
- element.</p>
+ <p>The <dfn id=attr-option-selected title=attr-option-selected><code>selected</code></dfn> attribute is a <a href=#boolean-attribute>boolean
+ attribute</a>. It represents the default <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the element.</p>
<div class=impl>
- <p>The <dfn id=concept-option-selectedness title=concept-option-selectedness>selectedness</dfn>
- of an <code><a href=#the-option-element>option</a></code> element is a boolean state, initially
- false. Except where otherwise
- specified, when the element is created, its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set
- to true if the element has a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute. Whenever an
- <code><a href=#the-option-element>option</a></code> element's <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute is added, its
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must
- be set to true.</p>
+ <p>The <dfn id=concept-option-selectedness title=concept-option-selectedness>selectedness</dfn> of an <code><a href=#the-option-element>option</a></code>
+ element is a boolean state, initially false. Except where otherwise specified, when the element is
+ created, its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set to true if
+ the element has a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute. Whenever an
+ <code><a href=#the-option-element>option</a></code> element's <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute is
+ added, its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set to true.</p>
- <p class=note>The <code title=dom-option><a href=#dom-option>Option()</a></code>
- constructor, when called with three or fewer arguments, overrides the initial
- state of the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> state to
- always be false even if the third argument is true (implying that a
- <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute is to
- be set). The fourth argument can be used to explicitly set the
- initial <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> state when
- using the constructor.</p>
+ <p class=note>The <code title=dom-option><a href=#dom-option>Option()</a></code> constructor, when called with three
+ or fewer arguments, overrides the initial state of the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> state to always be false even if the third
+ argument is true (implying that a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute is
+ to be set). The fourth argument can be used to explicitly set the initial <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> state when using the constructor.</p>
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/604 -->
</div>
- <p>A <code><a href=#the-select-element>select</a></code> element whose <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is not
- specified must not have more than one descendant <code><a href=#the-option-element>option</a></code>
- element with its <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code>
- attribute set.</p>
+ <p>A <code><a href=#the-select-element>select</a></code> element whose <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
+ attribute is not specified must not have more than one descendant <code><a href=#the-option-element>option</a></code> element with
+ its <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute set.</p>
<div class=impl>
<p>An <code><a href=#the-option-element>option</a></code> element's <dfn id=concept-option-index title=concept-option-index>index</dfn> is the number of
- <code><a href=#the-option-element>option</a></code> element that are in the same <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> but that
- come before it in <a href=#tree-order>tree order</a>. If the
- <code><a href=#the-option-element>option</a></code> element is not in a <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, then the
+ <code><a href=#the-option-element>option</a></code> element that are in the same <a href=#concept-select-option-list title=concept-select-option-list>list of
+ options</a> but that come before it in <a href=#tree-order>tree order</a>. If the <code><a href=#the-option-element>option</a></code>
+ element is not in a <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, then the
<code><a href=#the-option-element>option</a></code> element's <a href=#concept-option-index title=concept-option-index>index</a> is zero.</p>
</div>
@@ -51060,20 +51029,17 @@
attribute must return the same value as the <code title=dom-fae-form><a href=#dom-fae-form>form</a></code> IDL attribute
on that <code><a href=#the-select-element>select</a></code> element. Otherwise, it must return null.</p>
-<!--CLEANUP-->
- <p>A constructor is provided for creating <code><a href=#htmloptionelement>HTMLOptionElement</a></code> objects (in
- addition to the factory methods from DOM such as <code title="">createElement()</code>):
- <dfn id=dom-option title=dom-option><code>Option(<var title="">text</var>, <var title="">value</var>, <var title="">defaultSelected</var>, <var title="">selected</var>)</code></dfn>. When invoked as a constructor, it must return a new
- <code><a href=#htmloptionelement>HTMLOptionElement</a></code> object (a new <code><a href=#the-option-element>option</a></code> element).
- If the first argument is not the empty string, the new object must have as its only child a
- <code><a href=#text>Text</a></code> node whose data is the value of that argument. Otherwise, it must have no children. If the <var title="">value</var>
- argument is present, the new object must have a <code title=attr-option-value><a href=#attr-option-value>value</a></code>
- attribute set with the value of the argument as its value. If the <var title="">defaultSelected</var> argument is true, the new object must have a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute set with no value. If the <var title="">selected</var> argument is true, the new object must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true; otherwise
- the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be
- set to false, even if the <var title="">defaultSelected</var> argument is true. The
- element's document must be the <a href=#active-document>active document</a> of the <a href=#browsing-context>browsing context</a>
- of the <code><a href=#window>Window</a></code> object on which the interface object of the invoked constructor is
- found.</p>
+ <p>A constructor is provided for creating <code><a href=#htmloptionelement>HTMLOptionElement</a></code> objects (in addition to
+ the factory methods from DOM such as <code title="">createElement()</code>): <dfn id=dom-option title=dom-option><code>Option(<var title="">text</var>, <var title="">value</var>, <var title="">defaultSelected</var>, <var title="">selected</var>)</code></dfn>. When invoked as a
+ constructor, it must return a new <code><a href=#htmloptionelement>HTMLOptionElement</a></code> object (a new <code><a href=#the-option-element>option</a></code>
+ element). If the first argument is not the empty string, the new object must have as its only
+ child a <code><a href=#text>Text</a></code> node whose data is the value of that argument. Otherwise, it must have
+ no children. If the <var title="">value</var> argument is present, the new object must have a
+ <code title=attr-option-value><a href=#attr-option-value>value</a></code> attribute set with the value of the argument as its
+ value. If the <var title="">defaultSelected</var> argument is true, the new object must have a
+ <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute set with no value. If the <var title="">selected</var> argument is true, the new object must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true; otherwise the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set to false, even if the <var title="">defaultSelected</var> argument is true. The element's document must be the <a href=#active-document>active
+ document</a> of the <a href=#browsing-context>browsing context</a> of the <code><a href=#window>Window</a></code> object on which
+ the interface object of the invoked constructor is found.</p>
</div>
<!--TOPIC:HTML-->
@@ -52197,59 +52163,47 @@
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
- </dl><!--TOPIC:HTML--><!--CLEANUP--><p>The <code><a href=#the-meter-element>meter</a></code> element <a href=#represents>represents</a> a scalar
- measurement within a known range, or a fractional value; for example
- disk usage, the relevance of a query result, or the fraction of a
- voting population to have selected a particular candidate.</p>
+ </dl><!--TOPIC:HTML--><p>The <code><a href=#the-meter-element>meter</a></code> element <a href=#represents>represents</a> a scalar measurement within a known
+ range, or a fractional value; for example disk usage, the relevance of a query result, or the
+ fraction of a voting population to have selected a particular candidate.</p>
<p>This is also known as a gauge.</p>
- <p class=note>The <code><a href=#the-meter-element>meter</a></code> element should not be used to
- indicate progress (as in a progress bar). For that role, HTML
- provides a separate <code><a href=#the-progress-element>progress</a></code> element.</p>
+ <p class=note>The <code><a href=#the-meter-element>meter</a></code> element should not be used to indicate progress (as in a
+ progress bar). For that role, HTML provides a separate <code><a href=#the-progress-element>progress</a></code> element.</p>
- <p class=note>The <code><a href=#the-meter-element>meter</a></code> element also does not
- represent a scalar value of arbitrary range — for example, it
- would be wrong to use this to report a weight, or height, unless
+ <p class=note>The <code><a href=#the-meter-element>meter</a></code> element also does not represent a scalar value of arbitrary
+ range — for example, it would be wrong to use this to report a weight, or height, unless
there is a known maximum value.</p>
- <p>There are six attributes that determine the semantics of the
- gauge represented by the element.</p>
+ <p>There are six attributes that determine the semantics of the gauge represented by the
+ element.</p>
- <p>The <dfn id=attr-meter-min title=attr-meter-min><code>min</code></dfn> attribute
- specifies the lower bound of the range, and the <dfn id=attr-meter-max title=attr-meter-max><code>max</code></dfn> attribute specifies
- the upper bound. The <dfn id=attr-meter-value title=attr-meter-value><code>value</code></dfn> attribute
- specifies the value to have the gauge indicate as the "measured"
- value.</p>
+ <p>The <dfn id=attr-meter-min title=attr-meter-min><code>min</code></dfn> attribute specifies the lower bound of
+ the range, and the <dfn id=attr-meter-max title=attr-meter-max><code>max</code></dfn> attribute specifies the
+ upper bound. The <dfn id=attr-meter-value title=attr-meter-value><code>value</code></dfn> attribute specifies the
+ value to have the gauge indicate as the "measured" value.</p>
- <p>The other three attributes can be used to segment the gauge's
- range into "low", "medium", and "high" parts, and to indicate which
- part of the gauge is the "optimum" part. The <dfn id=attr-meter-low title=attr-meter-low><code>low</code></dfn> attribute specifies
- the range that is considered to be the "low" part, and the <dfn id=attr-meter-high title=attr-meter-high><code>high</code></dfn> attribute specifies
- the range that is considered to be the "high" part. The <dfn id=attr-meter-optimum title=attr-meter-optimum><code>optimum</code></dfn> attribute
- gives the position that is "optimum"; if that is higher than the
- "high" value then this indicates that the higher the value, the
- better; if it's lower than the "low" mark then it indicates that
- lower values are better, and naturally if it is in between then it
- indicates that neither high nor low values are good.</p>
+ <p>The other three attributes can be used to segment the gauge's range into "low", "medium", and
+ "high" parts, and to indicate which part of the gauge is the "optimum" part. The <dfn id=attr-meter-low title=attr-meter-low><code>low</code></dfn> attribute specifies the range that is considered to
+ be the "low" part, and the <dfn id=attr-meter-high title=attr-meter-high><code>high</code></dfn> attribute
+ specifies the range that is considered to be the "high" part. The <dfn id=attr-meter-optimum title=attr-meter-optimum><code>optimum</code></dfn> attribute gives the position that is
+ "optimum"; if that is higher than the "high" value then this indicates that the higher the value,
+ the better; if it's lower than the "low" mark then it indicates that lower values are better, and
+ naturally if it is in between then it indicates that neither high nor low values are good.</p>
- <p><span class=impl><strong>Authoring
- requirements</strong>:</span> The <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute must be
- specified. The <code title=attr-meter-value><a href=#attr-meter-value>value</a></code>, <code title=attr-meter-min><a href=#attr-meter-min>min</a></code>, <code title=attr-meter-low><a href=#attr-meter-low>low</a></code>, <code title=attr-meter-high><a href=#attr-meter-high>high</a></code>, <code title=attr-meter-max><a href=#attr-meter-max>max</a></code>, and <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> attributes, when present,
- must have values that are <a href=#valid-floating-point-number title="valid floating-point
- number">valid floating-point numbers</a>.</p>
+ <p><span class=impl><strong>Authoring requirements</strong>:</span> The <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute must be specified. The <code title=attr-meter-value><a href=#attr-meter-value>value</a></code>, <code title=attr-meter-min><a href=#attr-meter-min>min</a></code>, <code title=attr-meter-low><a href=#attr-meter-low>low</a></code>, <code title=attr-meter-high><a href=#attr-meter-high>high</a></code>, <code title=attr-meter-max><a href=#attr-meter-max>max</a></code>, and <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> attributes,
+ when present, must have values that are <a href=#valid-floating-point-number title="valid floating-point number">valid
+ floating-point numbers</a>.</p>
<p>In addition, the attributes' values are further constrained:</p>
- <p>Let <var title="">value</var> be the <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute's number.</p>
+ <p>Let <var title="">value</var> be the <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute's
+ number.</p>
- <p>If the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code> attribute
- is specified, then let <var title="">minimum</var> be that
- attribute's value; otherwise, let it be zero.</p>
+ <p>If the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code> attribute is specified, then let <var title="">minimum</var> be that attribute's value; otherwise, let it be zero.</p>
- <p>If the <code title=attr-meter-max><a href=#attr-meter-max>max</a></code> attribute
- is specified, then let <var title="">maximum</var> be that
- attribute's value; otherwise, let it be 1.0.</p>
+ <p>If the <code title=attr-meter-max><a href=#attr-meter-max>max</a></code> attribute is specified, then let <var title="">maximum</var> be that attribute's value; otherwise, let it be 1.0.</p>
<p>The following inequalities must hold, as applicable:</p>
@@ -52258,13 +52212,12 @@
<li><var title="">minimum</var> ≤ <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> ≤ <var title="">maximum</var> (if <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> is specified)</li>
<li><var title="">minimum</var> ≤ <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> ≤ <var title="">maximum</var> (if <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> is specified)</li>
<li><code title=attr-meter-low><a href=#attr-meter-low>low</a></code> ≤ <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> (if both <code title=attr-meter-low><a href=#attr-meter-low>low</a></code> and <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> are specified)</li>
- </ul><p class=note>If no minimum or maximum is specified, then the
- range is assumed to be 0..1, and the value thus has to be within
- that range.</p>
+ </ul><p class=note>If no minimum or maximum is specified, then the range is assumed to be 0..1, and
+ the value thus has to be within that range.</p>
- <p>Authors are encouraged to include a textual representation of the
- gauge's state in the element's contents, for users of user agents
- that do not support the <code><a href=#the-meter-element>meter</a></code> element.</p>
+ <p>Authors are encouraged to include a textual representation of the gauge's state in the
+ element's contents, for users of user agents that do not support the <code><a href=#the-meter-element>meter</a></code>
+ element.</p>
<div class=example>
@@ -52275,16 +52228,14 @@
Voter turnout: <meter value=0.75><img alt="75%" src="graph75.png"></meter>
Tickets sold: <meter min="0" max="100" value="75"></meter></pre>
- <p>The following example is incorrect use of the element, because
- it doesn't give a range (and since the default maximum is 1, both
- of the gauges would end up looking maxed out):</p>
+ <p>The following example is incorrect use of the element, because it doesn't give a range (and
+ since the default maximum is 1, both of the gauges would end up looking maxed out):</p>
<pre class=bad><p>The grapefruit pie had a radius of <meter value=12>12cm</meter>
and a height of <meter value=2>2cm</meter>.</p> <!-- <strong>BAD!</strong> --></pre>
- <p>Instead, one would either not include the meter element, or use
- the meter element with a defined range to give the dimensions in
- context compared to other pies:</p>
+ <p>Instead, one would either not include the meter element, or use the meter element with a
+ defined range to give the dimensions in context compared to other pies:</p>
<pre><p>The grapefruit pie had a radius of 12cm and a height of
2cm.</p>
@@ -52295,9 +52246,8 @@
</div>
- <p>There is no explicit way to specify units in the
- <code><a href=#the-meter-element>meter</a></code> element, but the units may be specified in the
- <code title=attr-title><a href=#attr-title>title</a></code> attribute in free-form text.</p>
+ <p>There is no explicit way to specify units in the <code><a href=#the-meter-element>meter</a></code> element, but the units may
+ be specified in the <code title=attr-title><a href=#attr-title>title</a></code> attribute in free-form text.</p>
<div class=example>
@@ -52312,36 +52262,34 @@
<div class=impl>
- <p><strong>User agent requirements</strong>: User agents must parse
- the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code>, <code title=attr-meter-max><a href=#attr-meter-max>max</a></code>, <code title=attr-meter-value><a href=#attr-meter-value>value</a></code>, <code title=attr-meter-low><a href=#attr-meter-low>low</a></code>, <code title=attr-meter-high><a href=#attr-meter-high>high</a></code>, and <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> attributes using the
- <a href=#rules-for-parsing-floating-point-number-values>rules for parsing floating-point number values</a>.</p>
+ <p><strong>User agent requirements</strong>: User agents must parse the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code>, <code title=attr-meter-max><a href=#attr-meter-max>max</a></code>, <code title=attr-meter-value><a href=#attr-meter-value>value</a></code>, <code title=attr-meter-low><a href=#attr-meter-low>low</a></code>, <code title=attr-meter-high><a href=#attr-meter-high>high</a></code>, and <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code>
+ attributes using the <a href=#rules-for-parsing-floating-point-number-values>rules for parsing floating-point number values</a>.</p>
- <p>User agents must then use all these numbers to obtain values for
- six points on the gauge, as follows. (The order in which these are
- evaluated is important, as some of the values refer to earlier
- ones.)</p>
+ <p>User agents must then use all these numbers to obtain values for six points on the gauge, as
+ follows. (The order in which these are evaluated is important, as some of the values refer to
+ earlier ones.)</p>
<dl><dt>The <dfn id=concept-meter-minimum title=concept-meter-minimum>minimum value</dfn></dt>
<dd>
- <p>If the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code> attribute is
- specified and a value could be parsed out of it, then the minimum
- value is that value. Otherwise, the minimum value is zero.</p>
+
+ <p>If the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code> attribute is specified and a value could be
+ parsed out of it, then the minimum value is that value. Otherwise, the minimum value is
+ zero.</p>
+
</dd>
<dt>The <dfn id=concept-meter-maximum title=concept-meter-maximum>maximum value</dfn></dt>
<dd>
- <p>If the <code title=attr-meter-max><a href=#attr-meter-max>max</a></code> attribute is
- specified and a value could be parsed out of it, then the
- candidate maximum value is that value. Otherwise, the candidate
+ <p>If the <code title=attr-meter-max><a href=#attr-meter-max>max</a></code> attribute is specified and a value could be
+ parsed out of it, then the candidate maximum value is that value. Otherwise, the candidate
maximum value is 1.0.</p>
- <p>If the candidate maximum value is greater than or equal to the
- minimum value, then the maximum value is the candidate maximum
- value. Otherwise, the maximum value is the same as the minimum
- value.</p>
+ <p>If the candidate maximum value is greater than or equal to the minimum value, then the
+ maximum value is the candidate maximum value. Otherwise, the maximum value is the same as the
+ minimum value.</p>
</dd>
@@ -52349,16 +52297,15 @@
<dd>
- <p>If the <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute is
- specified and a value could be parsed out of it, then that value
- is the candidate actual value. Otherwise, the candidate actual
- value is zero.</p>
+ <p>If the <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute is specified and a value could
+ be parsed out of it, then that value is the candidate actual value. Otherwise, the candidate
+ actual value is zero.</p>
- <p>If the candidate actual value is less than the minimum value,
- then the actual value is the minimum value.</p>
+ <p>If the candidate actual value is less than the minimum value, then the actual value is the
+ minimum value.</p>
- <p>Otherwise, if the candidate actual value is greater than the
- maximum value, then the actual value is the maximum value.</p>
+ <p>Otherwise, if the candidate actual value is greater than the maximum value, then the actual
+ value is the maximum value.</p>
<p>Otherwise, the actual value is the candidate actual value.</p>
@@ -52368,16 +52315,15 @@
<dd>
- <p>If the <code title=attr-meter-low><a href=#attr-meter-low>low</a></code> attribute is
- specified and a value could be parsed out of it, then the
- candidate low boundary is that value. Otherwise, the candidate low
+ <p>If the <code title=attr-meter-low><a href=#attr-meter-low>low</a></code> attribute is specified and a value could be
+ parsed out of it, then the candidate low boundary is that value. Otherwise, the candidate low
boundary is the same as the minimum value.</p>
- <p>If the candidate low boundary is less than the minimum value,
- then the low boundary is the minimum value.</p>
+ <p>If the candidate low boundary is less than the minimum value, then the low boundary is the
+ minimum value.</p>
- <p>Otherwise, if the candidate low boundary is greater than the
- maximum value, then the low boundary is the maximum value.</p>
+ <p>Otherwise, if the candidate low boundary is greater than the maximum value, then the low
+ boundary is the maximum value.</p>
<p>Otherwise, the low boundary is the candidate low boundary.</p>
@@ -52387,16 +52333,15 @@
<dd>
- <p>If the <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> attribute is
- specified and a value could be parsed out of it, then the
- candidate high boundary is that value. Otherwise, the candidate
- high boundary is the same as the maximum value.</p>
+ <p>If the <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> attribute is specified and a value could be
+ parsed out of it, then the candidate high boundary is that value. Otherwise, the candidate high
+ boundary is the same as the maximum value.</p>
- <p>If the candidate high boundary is less than the low boundary,
- then the high boundary is the low boundary.</p>
+ <p>If the candidate high boundary is less than the low boundary, then the high boundary is the
+ low boundary.</p>
- <p>Otherwise, if the candidate high boundary is greater than the
- maximum value, then the high boundary is the maximum value.</p>
+ <p>Otherwise, if the candidate high boundary is greater than the maximum value, then the high
+ boundary is the maximum value.</p>
<p>Otherwise, the high boundary is the candidate high boundary.</p>
@@ -52406,51 +52351,41 @@
<dd>
- <p>If the <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code>
- attribute is specified and a value could be parsed out of it, then
- the candidate optimum point is that value. Otherwise, the
- candidate optimum point is the midpoint between the minimum value
- and the maximum value.</p>
+ <p>If the <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> attribute is specified and a value
+ could be parsed out of it, then the candidate optimum point is that value. Otherwise, the
+ candidate optimum point is the midpoint between the minimum value and the maximum value.</p>
- <p>If the candidate optimum point is less than the minimum value,
- then the optimum point is the minimum value.</p>
+ <p>If the candidate optimum point is less than the minimum value, then the optimum point is the
+ minimum value.</p>
- <p>Otherwise, if the candidate optimum point is greater than the
- maximum value, then the optimum point is the maximum value.</p>
+ <p>Otherwise, if the candidate optimum point is greater than the maximum value, then the optimum
+ point is the maximum value.</p>
- <p>Otherwise, the optimum point is the candidate optimum
- point.</p>
+ <p>Otherwise, the optimum point is the candidate optimum point.</p>
</dd>
- </dl><p>All of which will result in the following inequalities all being
- true:</p>
+ </dl><p>All of which will result in the following inequalities all being true:</p>
<ul class=brief><li>minimum value ≤ actual value ≤ maximum value</li>
<li>minimum value ≤ low boundary ≤ high boundary ≤ maximum value</li>
<li>minimum value ≤ optimum point ≤ maximum value</li>
- </ul><p><strong>UA requirements for regions of the gauge</strong>: If the
- optimum point is equal to the low boundary or the high boundary, or
- anywhere in between them, then the region between the low and high
- boundaries of the gauge must be treated as the optimum region, and
- the low and high parts, if any, must be treated as suboptimal.
- Otherwise, if the optimum point is less than the low boundary, then
- the region between the minimum value and the low boundary must be
- treated as the optimum region, the region from the low boundary up
- to the high boundary must be treated as a suboptimal region, and the
- remaining region must be treated as an even less good region.
- Finally, if the optimum point is higher than the high boundary, then
- the situation is reversed; the region between the high boundary and
- the maximum value must be treated as the optimum region, the region
- from the high boundary down to the low boundary must be treated as a
- suboptimal region, and the remaining region must be treated as an
- even less good region.</p>
+ </ul><p><strong>UA requirements for regions of the gauge</strong>: If the optimum point is equal to the
+ low boundary or the high boundary, or anywhere in between them, then the region between the low
+ and high boundaries of the gauge must be treated as the optimum region, and the low and high
+ parts, if any, must be treated as suboptimal. Otherwise, if the optimum point is less than the low
+ boundary, then the region between the minimum value and the low boundary must be treated as the
+ optimum region, the region from the low boundary up to the high boundary must be treated as a
+ suboptimal region, and the remaining region must be treated as an even less good region. Finally,
+ if the optimum point is higher than the high boundary, then the situation is reversed; the region
+ between the high boundary and the maximum value must be treated as the optimum region, the region
+ from the high boundary down to the low boundary must be treated as a suboptimal region, and the
+ remaining region must be treated as an even less good region.</p>
- <p><strong>UA requirements for showing the gauge</strong>: When
- representing a <code><a href=#the-meter-element>meter</a></code> element to the user, the UA should
- indicate the relative position of the actual value to the minimum
- and maximum values, and the relationship between the actual value
- and the three regions of the gauge.</p>
+ <p><strong>UA requirements for showing the gauge</strong>: When representing a <code><a href=#the-meter-element>meter</a></code>
+ element to the user, the UA should indicate the relative position of the actual value to the
+ minimum and maximum values, and the relationship between the actual value and the three regions of
+ the gauge.</p>
</div>
@@ -52483,10 +52418,8 @@
<p><img alt="With the <meter> elements rendered as inline green bars of varying lengths." height=178 src=http://images.whatwg.org/sample-meter.png width=332></p>
</div>
- <p>User agents <span class=impl>may</span> combine the value of
- the <code title=attr-title><a href=#attr-title>title</a></code> attribute and the other
- attributes to provide context-sensitive help or inline text
- detailing the actual values.</p>
+ <p>User agents <span class=impl>may</span> combine the value of the <code title=attr-title><a href=#attr-title>title</a></code> attribute and the other attributes to provide context-sensitive
+ help or inline text detailing the actual values.</p>
<div class=example>
<p>For example, the following snippet:</p>
@@ -52498,51 +52431,48 @@
<div class=impl>
- <p>The <dfn id=dom-meter-value title=dom-meter-value><code>value</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-actual title=concept-meter-actual>actual value</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-value><a href=#dom-meter-value>value</a></code> content attribute must be set
- to that string.</p>
+ <p>The <dfn id=dom-meter-value title=dom-meter-value><code>value</code></dfn> IDL attribute, on getting, must
+ return the <a href=#concept-meter-actual title=concept-meter-actual>actual value</a>. On setting, the given value
+ must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a>
+ and then the <code title=dom-meter-value><a href=#dom-meter-value>value</a></code> content attribute must be set to that
+ string.</p>
- <p>The <dfn id=dom-meter-min title=dom-meter-min><code>min</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-minimum title=concept-meter-minimum>minimum value</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-min><a href=#dom-meter-min>min</a></code> content attribute must be set to
- that string.</p>
+ <p>The <dfn id=dom-meter-min title=dom-meter-min><code>min</code></dfn> IDL attribute, on getting, must return
+ the <a href=#concept-meter-minimum title=concept-meter-minimum>minimum value</a>. On setting, the given value must be
+ converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a> and
+ then the <code title=dom-meter-min><a href=#dom-meter-min>min</a></code> content attribute must be set to that string.</p>
- <p>The <dfn id=dom-meter-max title=dom-meter-max><code>max</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-maximum title=concept-meter-maximum>maximum value</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-max><a href=#dom-meter-max>max</a></code> content attribute must be set to
- that string.</p>
+ <p>The <dfn id=dom-meter-max title=dom-meter-max><code>max</code></dfn> IDL attribute, on getting, must return
+ the <a href=#concept-meter-maximum title=concept-meter-maximum>maximum value</a>. On setting, the given value must be
+ converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a> and
+ then the <code title=dom-meter-max><a href=#dom-meter-max>max</a></code> content attribute must be set to that string.</p>
- <p>The <dfn id=dom-meter-low title=dom-meter-low><code>low</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-low title=concept-meter-low>low boundary</a>. On setting, the given
- value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the
- number as a floating-point number</a> and then the <code title=dom-meter-low><a href=#dom-meter-low>low</a></code> content attribute must be set to
- that string.</p>
+ <p>The <dfn id=dom-meter-low title=dom-meter-low><code>low</code></dfn> IDL attribute, on getting, must return
+ the <a href=#concept-meter-low title=concept-meter-low>low boundary</a>. On setting, the given value must be
+ converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a> and
+ then the <code title=dom-meter-low><a href=#dom-meter-low>low</a></code> content attribute must be set to that string.</p>
- <p>The <dfn id=dom-meter-high title=dom-meter-high><code>high</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-high title=concept-meter-high>high boundary</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-high><a href=#dom-meter-high>high</a></code> content attribute must be set to
- that string.</p>
+ <p>The <dfn id=dom-meter-high title=dom-meter-high><code>high</code></dfn> IDL attribute, on getting, must return
+ the <a href=#concept-meter-high title=concept-meter-high>high boundary</a>. On setting, the given value must be
+ converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a> and
+ then the <code title=dom-meter-high><a href=#dom-meter-high>high</a></code> content attribute must be set to that
+ string.</p>
- <p>The <dfn id=dom-meter-optimum title=dom-meter-optimum><code>optimum</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-optimum title=concept-meter-optimum>optimum value</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-optimum><a href=#dom-meter-optimum>optimum</a></code> content attribute must be
- set to that string.</p>
+ <p>The <dfn id=dom-meter-optimum title=dom-meter-optimum><code>optimum</code></dfn> IDL attribute, on getting, must
+ return the <a href=#concept-meter-optimum title=concept-meter-optimum>optimum value</a>. On setting, the given value
+ must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a>
+ and then the <code title=dom-meter-optimum><a href=#dom-meter-optimum>optimum</a></code> content attribute must be set to that
+ string.</p>
- <p>The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute
- provides a list of the element's <code><a href=#the-label-element>label</a></code>s.</p>
+ <p>The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a list of the element's
+ <code><a href=#the-label-element>label</a></code>s.</p>
</div>
<div class=example>
- <p>The following example shows how a gauge could fall back to
- localized or pretty-printed text.</p>
+ <p>The following example shows how a gauge could fall back to localized or pretty-printed
+ text.</p>
<pre><p>Disk usage: <meter min=0 value=170261928 max=233257824>170 261 928 bytes used
out of 233 257 824 bytes available</meter></p></pre>
@@ -68070,19 +68000,16 @@
</dl><div class=impl>
- <p>The <dfn id=dom-popstateevent-state title=dom-PopStateEvent-state><code>state</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents the context information for the event, or null, if the
- state represented is the initial state of the
- <code><a href=#document>Document</a></code>.</p>
+ <p>The <dfn id=dom-popstateevent-state title=dom-PopStateEvent-state><code>state</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents the context information for the event, or null, if the state represented is
+ the initial state of the <code><a href=#document>Document</a></code>.</p>
</div>
- <hr><p>The <dfn id=event-hashchange title=event-hashchange><code>hashchange</code></dfn>
- event is fired when navigating to a <a href=#session-history-entry>session history
- entry</a> whose <a href=#url>URL</a> differs from that of the
- previous one only in the fragment identifier.</p>
+ <hr><p>The <dfn id=event-hashchange title=event-hashchange><code>hashchange</code></dfn> event is fired when navigating
+ to a <a href=#session-history-entry>session history entry</a> whose <a href=#url>URL</a> differs from that of the previous
+ one only in the fragment identifier.</p>
<pre class=idl>[Constructor(DOMString type, optional <a href=#hashchangeeventinit>HashChangeEventInit</a> eventInitDict)]
interface <dfn id=hashchangeevent>HashChangeEvent</dfn> : <a href=#event>Event</a> {
@@ -68099,8 +68026,8 @@
<dd>
- <p>Returns the <a href=#url>URL</a> of the <a href=#session-history-entry>session history
- entry</a> that was previously current.</p>
+ <p>Returns the <a href=#url>URL</a> of the <a href=#session-history-entry>session history entry</a> that was previously
+ current.</p>
</dd>
@@ -68109,36 +68036,30 @@
<dd>
- <p>Returns the <a href=#url>URL</a> of the <a href=#session-history-entry>session history
- entry</a> that is now current.</p>
+ <p>Returns the <a href=#url>URL</a> of the <a href=#session-history-entry>session history entry</a> that is now
+ current.</p>
</dd>
</dl><div class=impl>
- <p>The <dfn id=dom-hashchangeevent-oldurl title=dom-HashChangeEvent-oldURL><code>oldURL</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents context information for the event, specifically the URL
- of the <a href=#session-history-entry>session history entry</a> that was traversed
- from.</p>
+ <p>The <dfn id=dom-hashchangeevent-oldurl title=dom-HashChangeEvent-oldURL><code>oldURL</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents context information for the event, specifically the URL of the <a href=#session-history-entry>session
+ history entry</a> that was traversed from.</p>
- <p>The <dfn id=dom-hashchangeevent-newurl title=dom-HashChangeEvent-newURL><code>newURL</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents context information for the event, specifically the URL
- of the <a href=#session-history-entry>session history entry</a> that was traversed to.</p>
+ <p>The <dfn id=dom-hashchangeevent-newurl title=dom-HashChangeEvent-newURL><code>newURL</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents context information for the event, specifically the URL of the <a href=#session-history-entry>session
+ history entry</a> that was traversed to.</p>
</div>
- <hr><p>The <dfn id=event-pageshow title=event-pageshow><code>pageshow</code></dfn> event
- is fired when traversing <em>to</em> a <a href=#session-history-entry>session history
- entry</a>. The <dfn id=event-pagehide title=event-pagehide><code>pagehide</code></dfn> event is fired
- when traversing <em>from</em> a <a href=#session-history-entry>session history entry</a>.
- The specification uses the <a href=#page-showing>page showing</a> flag to ensure
- that scripts receive these events in a consistent manner (e.g. that
- they never receive two <code title=event-pagehide><a href=#event-pagehide>pagehide</a></code>
- events in a row without an intervening <code title=event-pageshow><a href=#event-pageshow>pageshow</a></code>, or vice versa).</p>
+ <hr><p>The <dfn id=event-pageshow title=event-pageshow><code>pageshow</code></dfn> event is fired when traversing
+ <em>to</em> a <a href=#session-history-entry>session history entry</a>. The <dfn id=event-pagehide title=event-pagehide><code>pagehide</code></dfn> event is fired when traversing <em>from</em> a
+ <a href=#session-history-entry>session history entry</a>. The specification uses the <a href=#page-showing>page showing</a> flag to
+ ensure that scripts receive these events in a consistent manner (e.g. that they never receive two
+ <code title=event-pagehide><a href=#event-pagehide>pagehide</a></code> events in a row without an intervening <code title=event-pageshow><a href=#event-pageshow>pageshow</a></code>, or vice versa).</p>
<pre class=idl>[Constructor(DOMString type, optional <a href=#pagetransitioneventinit>PageTransitionEventInit</a> eventInitDict)]
interface <dfn id=pagetransitionevent>PageTransitionEvent</dfn> : <a href=#event>Event</a> {
@@ -68153,16 +68074,16 @@
<dd>
- <p>Returns false if the page is newly being loaded (and the <code title=event-load>load</code> event will fire). Otherwise, returns true.</p>
+ <p>Returns false if the page is newly being loaded (and the <code title=event-load>load</code>
+ event will fire). Otherwise, returns true.</p>
</dd>
</dl><div class=impl>
- <p>The <dfn id=dom-pagetransitionevent-persisted title=dom-PageTransitionEvent-persisted><code>persisted</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to false. It
- represents the context information for the event.</p>
+ <p>The <dfn id=dom-pagetransitionevent-persisted title=dom-PageTransitionEvent-persisted><code>persisted</code></dfn> attribute must
+ return the value it was initialized to. When the object is created, this attribute must be
+ initialized to false. It represents the context information for the event.</p>
</div>
@@ -68321,40 +68242,33 @@
</ol></li>
- <li><p>If <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> and <var title="">recycle</var> are both false, then the
- <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing context</a> must <a href=#discard-a-document title="discard a document">discard the
+ <li><p>If <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> and <var title="">recycle</var> are both false, then the <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing
+ context</a> must <a href=#discard-a-document title="discard a document">discard the
<code>Document</code></a>.</li>
- <li><p><i>End</i>: Decrease the <code><a href=#document>Document</a></code>'s
- <a href=#ignore-opens-during-unload-counter>ignore-opens-during-unload counter</a> by one.</li>
+ <li><p><i>End</i>: Decrease the <code><a href=#document>Document</a></code>'s <a href=#ignore-opens-during-unload-counter>ignore-opens-during-unload
+ counter</a> by one.</li>
- </ol><p>This specification defines the following <dfn id=unloading-document-cleanup-steps>unloading document
- cleanup steps</dfn>. Other specifications can define more.</p>
+ </ol><p>This specification defines the following <dfn id=unloading-document-cleanup-steps>unloading document cleanup steps</dfn>. Other
+ specifications can define more.</p>
<ol><li>
- <p><a href=#make-disappear>Make disappear</a> any <code><a href=#websocket>WebSocket</a></code> objects
- that were created by the <code title=dom-WebSocket><a href=#dom-websocket>WebSocket()</a></code> constructor whose global
- object is the <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object.
+ <p><a href=#make-disappear>Make disappear</a> any <code><a href=#websocket>WebSocket</a></code> objects that were created by the <code title=dom-WebSocket><a href=#dom-websocket>WebSocket()</a></code> constructor whose global object is the
+ <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object.</p>
+ <p>If this affected any <code><a href=#websocket>WebSocket</a></code> objects, then set <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> state to false.</p>
- </p>
-
- <p>If this affected any <code><a href=#websocket>WebSocket</a></code> objects, the set
- <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> state to
- false.</p>
-
</li>
- <li><p>If the <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> state is
- false, <a href=#concept-eventsource-forcibly-close title=concept-EventSource-forcibly-close>forcibly
- close</a> any <code><a href=#eventsource>EventSource</a></code> objects that whose
- constructor was invoked from the <code><a href=#document>Document</a></code>'s
- <code><a href=#window>Window</a></code> object.</li>
+ <li><p>If the <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var>
+ state is false, <a href=#concept-eventsource-forcibly-close title=concept-EventSource-forcibly-close>forcibly close</a> any
+ <code><a href=#eventsource>EventSource</a></code> objects that whose constructor was invoked from the
+ <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object.</li>
- <li><p>If the <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> state is
- false, empty the <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code>'s
- <a href=#list-of-active-timers>list of active timers</a>.</li>
+ <li><p>If the <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var>
+ state is false, empty the <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code>'s <a href=#list-of-active-timers>list of active
+ timers</a>.</li>
</ol><h5 id=event-definition><span class=secno>6.6.11.1 </span>Event definition</h5>
@@ -71991,13 +71905,9 @@
<div class=impl>
<h5 id=event-firing><span class=secno>7.1.6.3 </span>Event firing</h5>
-<!--CLEANUP-->
- <p>Certain operations and methods are defined as firing events on
- elements. For example, the <code title=dom-click><a href=#dom-click>click()</a></code>
- method on the <code><a href=#htmlelement>HTMLElement</a></code> interface is defined as
- firing a <code title=event-click><a href=#event-click>click</a></code> event on the
- element. <a href=#refsDOMEVENTS>[DOMEVENTS]</a></p>
+ <p>Certain operations and methods are defined as firing events on elements. For example, the <code title=dom-click><a href=#dom-click>click()</a></code> method on the <code><a href=#htmlelement>HTMLElement</a></code> interface is defined as
+ firing a <code title=event-click><a href=#event-click>click</a></code> event on the element. <a href=#refsDOMEVENTS>[DOMEVENTS]</a></p>
<p><dfn id=fire-a-simple-event title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means
that a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event with the name <var title="">e</var>, which does not bubble (except where otherwise stated) and is not cancelable
@@ -72011,14 +71921,14 @@
attributes initialized to 0, its <code title="">ctrlKey</code>, <code title="">shiftKey</code>,
<code title="">altKey</code>, and <code title="">metaKey</code> attributes initialized according
to the current state of the key input device, if any (false for any keys that are not available),
- its <code title="">detail</code> attribute initialized to 1, and its <code title="">relatedTarget</code> attribute initialized to null (except where otherwise stated). The <code title="">getModifierState()</code> method on the object must return values appropriately
+ its <code title="">detail</code> attribute initialized to 1, and its <code title="">relatedTarget</code> attribute initialized to null (except where otherwise stated). The
+ <code title="">getModifierState()</code> method on the object must return values appropriately
describing the state of the key input device at the time the event is created.</p>
<p><dfn id=fire-a-click-event title="fire a click event">Firing a <code title=event-click>click</code> event</dfn>
means <a href=#fire-a-synthetic-mouse-event title="fire a synthetic mouse event">firing a synthetic mouse event named <code title=event-click>click</code></a>, which bubbles and is cancelable.</p>
- <p>The default action of these events is to do nothing except where
- otherwise stated.</p>
+ <p>The default action of these events is to do nothing except where otherwise stated.</p>
</div>
@@ -72042,8 +71952,8 @@
<h3 id=atob><span class=secno>7.2 </span>Base64 utility methods</h3>
- <p>The <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> and <code title=dom-windowbase64-btoa><a href=#dom-windowbase64-btoa>btoa()</a></code> methods allow authors to
- transform content to and from the base64 encoding.</p>
+ <p>The <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> and <code title=dom-windowbase64-btoa><a href=#dom-windowbase64-btoa>btoa()</a></code> methods allow authors to transform content to and from
+ the base64 encoding.</p>
<!-- v2: actual binary support -->
@@ -72054,22 +71964,20 @@
};
<a href=#window>Window</a> implements <a href=#windowbase64>WindowBase64</a>;</pre>
- <p class=note>In these APIs, for mnemonic purposes, the "b" can be
- considered to stand for "binary", and the "a" for "ASCII". In
- practice, though, for primarily historical reasons, both the input
- and output of these functions are Unicode strings.</p>
+ <p class=note>In these APIs, for mnemonic purposes, the "b" can be considered to stand for
+ "binary", and the "a" for "ASCII". In practice, though, for primarily historical reasons, both the
+ input and output of these functions are Unicode strings.</p>
<dl class=domintro><dt><var title="">result</var> = <var title="">window</var> . <code title=dom-windowbase64-btoa><a href=#dom-windowbase64-btoa>btoa</a></code>( <var title="">data</var> )</dt>
<dd>
- <p>Takes the input data, in the form of a Unicode string
- containing only characters in the range U+0000 to U+00FF, each
- representing a binary byte with values 0x00 to 0xFF respectively,
- and converts it to its base64 representation, which it returns.</p>
+ <p>Takes the input data, in the form of a Unicode string containing only characters in the range
+ U+0000 to U+00FF, each representing a binary byte with values 0x00 to 0xFF respectively, and
+ converts it to its base64 representation, which it returns.</p>
- <p>Throws an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the
- input string contains any out-of-range characters.</p>
+ <p>Throws an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the input string contains any
+ out-of-range characters.</p>
</dd>
@@ -72077,91 +71985,77 @@
<dd>
- <p>Takes the input data, in the form of a Unicode string
- containing base64-encoded binary data, decodes it, and returns a
- string consisting of characters in the range U+0000 to U+00FF,
- each representing a binary byte with values 0x00 to 0xFF
- respectively, corresponding to that binary data.</p>
+ <p>Takes the input data, in the form of a Unicode string containing base64-encoded binary data,
+ decodes it, and returns a string consisting of characters in the range U+0000 to U+00FF, each
+ representing a binary byte with values 0x00 to 0xFF respectively, corresponding to that binary
+ data.</p>
- <p>Throws an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the
- input string is not valid base64 data.</p>
+ <p>Throws an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the input string is not valid
+ base64 data.</p>
</dd>
</dl><div class=impl>
- <p class=note>The <code><a href=#windowbase64>WindowBase64</a></code> interface adds to the
- <code><a href=#window>Window</a></code> interface and the <code><a href=#workerglobalscope>WorkerGlobalScope</a></code>
- interface (part of Web Workers).</p>
+ <p class=note>The <code><a href=#windowbase64>WindowBase64</a></code> interface adds to the <code><a href=#window>Window</a></code> interface
+ and the <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> interface (part of Web Workers).</p>
- <p>The <dfn id=dom-windowbase64-btoa title=dom-windowbase64-btoa><code>btoa()</code></dfn>
- method must throw an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if
- the method's first argument contains any character whose code point
- is greater than U+00FF. Otherwise, the user agent must convert that
- argument to a sequence of octets whose <var title="">n</var>th octet
- is the eight-bit representation of the code point of the <var title="">n</var>th character of the argument, and then must apply
- the base64 algorithm to that sequence of octets, and return the
- result. <a href=#refsRFC4648>[RFC4648]</a><!--base64--></p>
- <!-- Aryeh says: This seems to be what all browsers do as of January
- 2011 (except IE, which doesn't support these functions at all). -->
+ <p>The <dfn id=dom-windowbase64-btoa title=dom-windowbase64-btoa><code>btoa()</code></dfn> method must throw an
+ <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the method's first argument contains any character
+ whose code point is greater than U+00FF. Otherwise, the user agent must convert that argument to a
+ sequence of octets whose <var title="">n</var>th octet is the eight-bit representation of the code
+ point of the <var title="">n</var>th character of the argument, and then must apply the base64
+ algorithm to that sequence of octets, and return the result. <a href=#refsRFC4648>[RFC4648]</a><!--base64--></p> <!-- Aryeh says: This seems to be what all
+ browsers do as of January 2011 (except IE, which doesn't support these functions at all). -->
- <p>The <dfn id=dom-windowbase64-atob title=dom-windowbase64-atob><code>atob()</code></dfn>
- method must run the following steps to parse the string passed in
- the method's first argument:</p>
+ <p>The <dfn id=dom-windowbase64-atob title=dom-windowbase64-atob><code>atob()</code></dfn> method must run the following
+ steps to parse the string passed in the method's first argument:</p>
- <ol><!-- Aryeh says: Copies Firefox behavior as of January 2011
- (4.0b8). WebKit is somewhat laxer, and Opera throws no exceptions
- at all. gsnedders reports Opera's behavior causes site-compat
- problems, and I figure most sites depend on Firefox if on anything,
- so go with that. --><!-- Since updated to drop whitespace, based on the arguments here:
+ <ol><!-- Aryeh says: Copies Firefox behavior as of January 2011 (4.0b8). WebKit is somewhat laxer,
+ and Opera throws no exceptions at all. gsnedders reports Opera's behavior causes site-compat
+ problems, and I figure most sites depend on Firefox if on anything, so go with that. --><!-- Since updated to drop whitespace, based on the arguments here:
http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2011-May/031613.html
- --><li><p>Let <var title="">input</var> be the string being
- parsed.</li>
+ --><li><p>Let <var title="">input</var> be the string being parsed.</li>
- <li><p>Let <var title="">position</var> be a pointer into <var title="">input</var>, initially pointing at the start of the
- string.</li>
+ <li><p>Let <var title="">position</var> be a pointer into <var title="">input</var>, initially
+ pointing at the start of the string.</li>
- <li><p>Remove all <a href=#space-character title="space character">space
- characters</a> from <var title="">input</var>.</li>
+ <li><p>Remove all <a href=#space-character title="space character">space characters</a> from <var title="">input</var>.</li>
- <li><p>If the length of <var title="">input</var> divides by 4
- leaving no remainder, then: if <var title="">input</var> ends with
- one or two U+003D EQUALS SIGN (=) characters, remove them from <var title="">input</var>.</li>
+ <li><p>If the length of <var title="">input</var> divides by 4 leaving no remainder, then: if
+ <var title="">input</var> ends with one or two U+003D EQUALS SIGN (=) characters, remove them
+ from <var title="">input</var>.</li>
- <li><p>If the length of <var title="">input</var> divides by 4
- leaving a remainder of 1, throw an
- <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception and abort these
- steps.</p>
+ <li><p>If the length of <var title="">input</var> divides by 4 leaving a remainder of 1, throw an
+ <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception and abort these steps.</p>
<li>
- <p>If <var title="">input</var> contains a character that is not
- in the following list of characters and character ranges, throw an
- <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception and abort these
- steps:</p>
+ <p>If <var title="">input</var> contains a character that is not in the following list of
+ characters and character ranges, throw an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception and abort
+ these steps:</p>
<ul class=brief><li>U+002B PLUS SIGN (+)
<li>U+002F SOLIDUS (/)
<li><a href=#alphanumeric-ascii-characters>Alphanumeric ASCII characters</a>
</ul></li>
- <li><p>Let <var title="">output</var> be a string, initially
+ <li><p>Let <var title="">output</var> be a string, initially empty.</li>
+
+ <li><p>Let <var title="">buffer</var> be a buffer that can have bits appended to it, initially
empty.</li>
- <li><p>Let <var title="">buffer</var> be a buffer that can have
- bits appended to it, initially empty.</li>
-
<li>
- <p>While <var title="">position</var> does not point past the end
- of <var title="">input</var>, run these substeps:</p>
+ <p>While <var title="">position</var> does not point past the end of <var title="">input</var>,
+ run these substeps:</p>
<ol><li>
- <p>Find the character pointed to by <var title="">position</var>
- in the first column of the following table. Let <var title="">n</var> be the number given in the second cell of the
- same row.</p>
+ <p>Find the character pointed to by <var title="">position</var> in the first column of the
+ following table. Let <var title="">n</var> be the number given in the second cell of the same
+ row.</p>
<div id=base64-table>
<table><thead><tr><th>Character
@@ -72234,47 +72128,36 @@
</li>
- <li><p>Append to <var title="">buffer</var> the six bits
- corresponding to <var title="">number</var>, most significant bit
- first.</li>
+ <li><p>Append to <var title="">buffer</var> the six bits corresponding to <var title="">number</var>, most significant bit first.</li>
- <li><p>If <var title="">buffer</var> has accumulated 24 bits,
- interpret them as three 8-bit big-endian numbers. Append the
- three characters with code points equal to those numbers to <var title="">output</var>, in the same order, and then empty <var title="">buffer</var>.</li>
+ <li><p>If <var title="">buffer</var> has accumulated 24 bits, interpret them as three 8-bit
+ big-endian numbers. Append the three characters with code points equal to those numbers to <var title="">output</var>, in the same order, and then empty <var title="">buffer</var>.</li>
- <li><p>Advance <var title="">position</var> by one
- character.</li>
+ <li><p>Advance <var title="">position</var> by one character.</li>
</ol></li>
<li>
- <p>If <var title="">buffer</var> is not empty, it contains either
- 12 or 18 bits. If it contains 12 bits, discard the last four and
- interpret the remaining eight as an 8-bit big-endian number. If it
- contains 18 bits, discard the last two and interpret the remaining
- 16 as two 8-bit big-endian numbers. Append the one or two
- characters with code points equal to those one or two numbers to
- <var title="">output</var>, in the same order.</p>
+ <p>If <var title="">buffer</var> is not empty, it contains either 12 or 18 bits. If it contains
+ 12 bits, discard the last four and interpret the remaining eight as an 8-bit big-endian number.
+ If it contains 18 bits, discard the last two and interpret the remaining 16 as two 8-bit
+ big-endian numbers. Append the one or two characters with code points equal to those one or two
+ numbers to <var title="">output</var>, in the same order.</p>
- <p class=note>The discarded bits mean that, for instance, <code title="">atob("YQ")</code> and <code title="">atob("YR")</code>
- both return "<code title="">a</code>".</p>
+ <p class=note>The discarded bits mean that, for instance, <code title="">atob("YQ")</code> and
+ <code title="">atob("YR")</code> both return "<code title="">a</code>".</p>
</li>
<li><p>Return <var title="">output</var>.</li>
- </ol><!-- Note: this function is defined explicitly here because RFC4648
- does not specify how to handle erroneous input, and no preexisting
- browser implementation simply throws an exception on all erroneous
- input. --></div>
+ </ol><!-- Note: this function is defined explicitly here because RFC4648 does not specify how to handle
+ erroneous input, and no preexisting browser implementation simply throws an exception on all
+ erroneous input. --></div>
- <p class=note>Some base64 encoders add newlines or other
- whitespace to their output. The <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> method throws an
- exception if its input contains characters other than those
- described by the regular expression bracket expression <code title="">[+/=0-9A-Za-z]</code>, so other characters need to be
- removed before <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> is
- used for decoding.</p>
+ <p class=note>Some base64 encoders add newlines or other whitespace to their output. The <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> method throws an exception if its input contains
+ characters other than those described by the regular expression bracket expression <code title="">[+/=0-9A-Za-z]</code>, so other characters need to be removed before <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> is used for decoding.</p>
Modified: index
===================================================================
--- index 2013-04-11 21:33:47 UTC (rev 7806)
+++ index 2013-04-11 21:42:13 UTC (rev 7807)
@@ -11082,15 +11082,14 @@
<h4 id=requirements-relating-to-bidirectional-algorithm-formatting-characters><span class=secno>3.2.6 </span>Requirements relating to bidirectional-algorithm formatting characters</h4>
-<!--CLEANUP-->
<p><a href=#text-content>Text content</a> in <a href=#html-elements>HTML elements</a> with child <code><a href=#text>Text</a></code> nodes, and
text in attributes of <a href=#html-elements>HTML elements</a> that allow free-form text, may contain characters
- in the ranges U+202A to U+202E and U+2066 to U+2069 (the bidirectional-algorithm formatting characters). However, the
- use of these characters is restricted so that any embedding or overrides generated by these
- characters do not start and end with different parent elements, and so that all such embeddings
- and overrides are explicitly terminated by a U+202C POP DIRECTIONAL FORMATTING character. This
- helps reduce incidences of text being reused in a manner that has unforeseen effects on the
- bidirectional algorithm. <a href=#refsBIDI>[BIDI]</a></p>
+ in the ranges U+202A to U+202E and U+2066 to U+2069 (the bidirectional-algorithm formatting
+ characters). However, the use of these characters is restricted so that any embedding or overrides
+ generated by these characters do not start and end with different parent elements, and so that all
+ such embeddings and overrides are explicitly terminated by a U+202C POP DIRECTIONAL FORMATTING
+ character. This helps reduce incidences of text being reused in a manner that has unforeseen
+ effects on the bidirectional algorithm. <a href=#refsBIDI>[BIDI]</a></p>
<p>The aforementioned restrictions are defined by specifying that certain parts of documents form
<a href=#bidirectional-algorithm-formatting-character-ranges>bidirectional-algorithm formatting character ranges</a>, and then imposing a requirement
@@ -11188,52 +11187,40 @@
<h4 id=wai-aria><span class=secno>3.2.7 </span><dfn>WAI-ARIA</dfn></h4>
- <p>Authors may use the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code>
- and <code title=attr-aria-*>aria-*</code> attributes on <a href=#html-elements>HTML
- elements</a>, in accordance with the requirements described in
- the ARIA specifications, except where these conflict with the
- <a href=#strong-native-semantics>strong native semantics</a> or are equal to the
- <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> described below. These
- exceptions are intended to prevent authors from making assistive
- technology products report nonsensical states that do not represent
- the actual state of the document. <a href=#refsARIA>[ARIA]</a></p>
+ <p>Authors may use the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code> attributes on <a href=#html-elements>HTML elements</a>, in accordance with the
+ requirements described in the ARIA specifications, except where these conflict with the
+ <a href=#strong-native-semantics>strong native semantics</a> or are equal to the <a href=#default-implicit-aria-semantics>default implicit ARIA
+ semantics</a> described below. These exceptions are intended to prevent authors from making
+ assistive technology products report nonsensical states that do not represent the actual state of
+ the document. <a href=#refsARIA>[ARIA]</a></p>
- <p>Authors must not set the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code> attributes in a manner that
- conflicts with the semantics described in the following table,
- except that the <code title=attr-aria-role-presentation>presentation</code> role may
- always be used. Authors must not set the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code> attributes to values that match
- the <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined in the
+ <p>Authors must not set the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code> attributes in a manner that conflicts with the semantics
+ described in the following table, except that the <code title=attr-aria-role-presentation>presentation</code> role may always be used. Authors must not
+ set the ARIA <code title=attr-aria-role><a href=#attr-aria-role>role</a></code> and <code title=attr-aria-*>aria-*</code>
+ attributes to values that match the <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined in the
following two tables.</p>
<div class=impl>
- <p>User agents are required to implement ARIA semantics on all
- <a href=#html-elements>HTML elements</a>, as defined in the ARIA specifications.
- The <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below must
- be recognized by implementations for the purposes of ARIA
- processing. <a href=#refsARIAIMPL>[ARIAIMPL]</a></p>
+ <p>User agents are required to implement ARIA semantics on all <a href=#html-elements>HTML elements</a>, as
+ defined in the ARIA specifications. The <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below
+ must be recognized by implementations for the purposes of ARIA processing. <a href=#refsARIAIMPL>[ARIAIMPL]</a></p>
- <p class=note>The ARIA attributes defined in the ARIA
- specifications, and the <a href=#strong-native-semantics>strong native semantics</a> and
- <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below, do not
- have any effect on CSS pseudo-class matching, user interface
- modalities that don't use assistive technologies, or the default
- actions of user interaction events as described in this
- specification.</p> <!-- this is a truism, in that there are no
- requirements that require that those attributes have such an effect,
- and no requirements that relax the requirements on those effects
- such that they could be affected by those attributes -->
+ <p class=note>The ARIA attributes defined in the ARIA specifications, and the <a href=#strong-native-semantics>strong
+ native semantics</a> and <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below, do not
+ have any effect on CSS pseudo-class matching, user interface modalities that don't use assistive
+ technologies, or the default actions of user interaction events as described in this
+ specification.</p> <!-- this is a truism, in that there are no requirements that require that
+ those attributes have such an effect, and no requirements that relax the requirements on those
+ effects such that they could be affected by those attributes -->
</div>
- <p>The following table defines the <a href=#strong-native-semantics>strong native
- semantics</a> and corresponding <a href=#default-implicit-aria-semantics>default implicit ARIA
- semantics</a> that apply to <a href=#html-elements>HTML elements</a>. Each
- language feature (element or attribute) in a cell in the first
- column implies the ARIA semantics (any role, states, and properties)
- given in the cell in the second column of the same row. <span class=impl>When multiple rows apply to an element, the role from
- the last row to define a role must be applied, and the states and
- properties from all the rows must be combined.</span></p>
+ <p>The following table defines the <a href=#strong-native-semantics>strong native semantics</a> and corresponding
+ <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> that apply to <a href=#html-elements>HTML elements</a>. Each
+ language feature (element or attribute) in a cell in the first column implies the ARIA semantics
+ (any role, states, and properties) given in the cell in the second column of the same row. <span class=impl>When multiple rows apply to an element, the role from the last row to define a role
+ must be applied, and the states and properties from all the rows must be combined.</span></p>
<table id=table-aria-strong><thead><tr><th>Language feature
<th><a href=#strong-native-semantics>Strong native semantics</a> and <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a>
@@ -11588,36 +11575,28 @@
<td><code title=attr-aria-role-document>document</code> role
<td>Role must be either <code title=attr-aria-role-document>document</code> or <code title=attr-aria-role-application>application</code>
- </table><p>The entry "<dfn id=concept-role-none title=concept-role-none>no role</dfn>", when
- used as a <a href=#strong-native-semantics title="strong native semantics">strong native
- semantic</a>, means that no role other than <code title=attr-aria-role-presentation>presentation</code> can be used.
- When used as a <a href=#default-implicit-aria-semantics title="default implicit ARIA semantics">default
- implicit ARIA semantic</a>, it means the user agent has no default
- mapping to ARIA roles. (However, it probably will have its own
- mappings to the accessibility layer.)</p>
+ </table><p>The entry "<dfn id=concept-role-none title=concept-role-none>no role</dfn>", when used as a <a href=#strong-native-semantics title="strong
+ native semantics">strong native semantic</a>, means that no role other than <code title=attr-aria-role-presentation>presentation</code> can be used. When used as a <a href=#default-implicit-aria-semantics title="default implicit ARIA semantics">default implicit ARIA semantic</a>, it means the user
+ agent has no default mapping to ARIA roles. (However, it probably will have its own mappings to
+ the accessibility layer.)</p>
<div class=impl>
- <p>Conformance checkers are encouraged to phrase errors such that
- authors are encouraged to use more appropriate elements rather than
- remove accessibility annotations. For example, if an <code><a href=#the-a-element>a</a></code>
- element is marked as having the <code title=attr-aria-role-button>button</code> role, a conformance
- checker could say "Use a more appropriate element to represent a
- button, for example a <code><a href=#the-button-element>button</a></code> element or an
- <code><a href=#the-input-element>input</a></code> element" rather than "The <code title=attr-aria-role-button>button</code> role cannot be used with
- <code><a href=#the-a-element>a</a></code> elements".</p>
+ <p>Conformance checkers are encouraged to phrase errors such that authors are encouraged to use
+ more appropriate elements rather than remove accessibility annotations. For example, if an
+ <code><a href=#the-a-element>a</a></code> element is marked as having the <code title=attr-aria-role-button>button</code>
+ role, a conformance checker could say "Use a more appropriate element to represent a button, for
+ example a <code><a href=#the-button-element>button</a></code> element or an <code><a href=#the-input-element>input</a></code> element" rather than "The <code title=attr-aria-role-button>button</code> role cannot be used with <code><a href=#the-a-element>a</a></code> elements".</p>
</div>
<div class=example>
- <p>These features can be used to make accessibility tools render
- content to their users in more useful ways. For example, ASCII art,
- which is really an image, appears to be text, and in the absence of
- appropriate annotations would end up being rendered by screen
- readers as a very painful reading of lots of punctuation. Using the
- features described in this section, one can instead make the ATs
- skip the ASCII art and just read the caption:</p>
+ <p>These features can be used to make accessibility tools render content to their users in more
+ useful ways. For example, ASCII art, which is really an image, appears to be text, and in the
+ absence of appropriate annotations would end up being rendered by screen readers as a very
+ painful reading of lots of punctuation. Using the features described in this section, one can
+ instead make the ATs skip the ASCII art and just read the caption:</p>
<pre><figure <strong>role="img" aria-labelledby="fish-caption"</strong>> <!-- that's "labelled" with TWO "l"s -->
<pre>
@@ -50887,84 +50866,74 @@
readonly attribute long <a href=#dom-option-index title=dom-option-index>index</a>;
};</pre>
</dd>
- </dl><!--TOPIC:HTML--><!--CLEANUP--><p>The <code><a href=#the-option-element>option</a></code> element <a href=#represents>represents</a> an option
- in a <code><a href=#the-select-element>select</a></code> element or as part of a list of suggestions
- in a <code><a href=#the-datalist-element>datalist</a></code> element.</p>
+ </dl><!--TOPIC:HTML--><p>The <code><a href=#the-option-element>option</a></code> element <a href=#represents>represents</a> an option in a <code><a href=#the-select-element>select</a></code>
+ element or as part of a list of suggestions in a <code><a href=#the-datalist-element>datalist</a></code> element.</p>
- <p>In certain circumstances described in the definition of the
- <code><a href=#the-select-element>select</a></code> element, an <code><a href=#the-option-element>option</a></code> element can be a
- <code><a href=#the-select-element>select</a></code> element's <a href=#placeholder-label-option>placeholder label option</a>.
- A <a href=#placeholder-label-option>placeholder label option</a> does not represent an actual
- option, but instead represents a label for the <code><a href=#the-select-element>select</a></code>
- control.</p>
+ <p>In certain circumstances described in the definition of the <code><a href=#the-select-element>select</a></code> element, an
+ <code><a href=#the-option-element>option</a></code> element can be a <code><a href=#the-select-element>select</a></code> element's <a href=#placeholder-label-option>placeholder label
+ option</a>. A <a href=#placeholder-label-option>placeholder label option</a> does not represent an actual option, but
+ instead represents a label for the <code><a href=#the-select-element>select</a></code> control.</p>
- <p>The <dfn id=attr-option-disabled title=attr-option-disabled><code>disabled</code></dfn>
- attribute is a <a href=#boolean-attribute>boolean attribute</a>. An
- <code><a href=#the-option-element>option</a></code> element is <dfn id=concept-option-disabled title=concept-option-disabled>disabled</dfn> if its <code title=attr-option-disabled><a href=#attr-option-disabled>disabled</a></code> attribute is present or
- if it is a child of an <code><a href=#the-optgroup-element>optgroup</a></code> element whose <code title=attr-optgroup-disabled><a href=#attr-optgroup-disabled>disabled</a></code> attribute is
- present.</p>
+ <p>The <dfn id=attr-option-disabled title=attr-option-disabled><code>disabled</code></dfn> attribute is a <a href=#boolean-attribute>boolean
+ attribute</a>. An <code><a href=#the-option-element>option</a></code> element is <dfn id=concept-option-disabled title=concept-option-disabled>disabled</dfn> if its <code title=attr-option-disabled><a href=#attr-option-disabled>disabled</a></code> attribute is present or if it is a child of an
+ <code><a href=#the-optgroup-element>optgroup</a></code> element whose <code title=attr-optgroup-disabled><a href=#attr-optgroup-disabled>disabled</a></code> attribute
+ is present.</p>
<div class=impl>
- <p>An <code><a href=#the-option-element>option</a></code> element that is <a href=#attr-option-disabled title=attr-option-disabled>disabled</a> must prevent any <code title=event-click><a href=#event-click>click</a></code> events that are <a href=#queue-a-task title="queue
- a task">queued</a> on the <a href=#user-interaction-task-source>user interaction task
- source</a> from being dispatched on the element.</p>
+ <p>An <code><a href=#the-option-element>option</a></code> element that is <a href=#attr-option-disabled title=attr-option-disabled>disabled</a> must
+ prevent any <code title=event-click><a href=#event-click>click</a></code> events that are <a href=#queue-a-task title="queue a
+ task">queued</a> on the <a href=#user-interaction-task-source>user interaction task source</a> from being dispatched on the
+ element.</p>
</div>
- <p>The <dfn id=attr-option-label title=attr-option-label><code>label</code></dfn>
- attribute provides a label for element. The <dfn id=concept-option-label title=concept-option-label>label</dfn> of an <code><a href=#the-option-element>option</a></code>
- element is the value of the <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if there
- is one, or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL attribute.</p>
+ <p>The <dfn id=attr-option-label title=attr-option-label><code>label</code></dfn> attribute provides a label for
+ element. The <dfn id=concept-option-label title=concept-option-label>label</dfn> of an <code><a href=#the-option-element>option</a></code> element is
+ the value of the <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if there is one,
+ or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL
+ attribute.</p>
<p>The <code title=attr-option-label><a href=#attr-option-label>label</a></code> content attribute, if specified, must not be
empty. If the attribute is not specified, then the element itself must not be empty.</p>
- <p>The <dfn id=attr-option-value title=attr-option-value><code>value</code></dfn>
- attribute provides a value for element. The <dfn id=concept-option-value title=concept-option-value>value</dfn> of an <code><a href=#the-option-element>option</a></code>
- element is the value of the <code title=attr-option-value><a href=#attr-option-value>value</a></code> content attribute, if there
- is one, or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL attribute.</p>
+ <p>The <dfn id=attr-option-value title=attr-option-value><code>value</code></dfn> attribute provides a value for
+ element. The <dfn id=concept-option-value title=concept-option-value>value</dfn> of an <code><a href=#the-option-element>option</a></code> element is
+ the value of the <code title=attr-option-value><a href=#attr-option-value>value</a></code> content attribute, if there is one,
+ or, if there is not, the value of the element's <code title=dom-option-text><a href=#dom-option-text>text</a></code> IDL
+ attribute.</p>
- <p>The <dfn id=attr-option-selected title=attr-option-selected><code>selected</code></dfn>
- attribute is a <a href=#boolean-attribute>boolean attribute</a>. It represents the
- default <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the
- element.</p>
+ <p>The <dfn id=attr-option-selected title=attr-option-selected><code>selected</code></dfn> attribute is a <a href=#boolean-attribute>boolean
+ attribute</a>. It represents the default <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the element.</p>
<div class=impl>
- <p>The <dfn id=concept-option-selectedness title=concept-option-selectedness>selectedness</dfn>
- of an <code><a href=#the-option-element>option</a></code> element is a boolean state, initially
- false. Except where otherwise
- specified, when the element is created, its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set
- to true if the element has a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute. Whenever an
- <code><a href=#the-option-element>option</a></code> element's <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute is added, its
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must
- be set to true.</p>
+ <p>The <dfn id=concept-option-selectedness title=concept-option-selectedness>selectedness</dfn> of an <code><a href=#the-option-element>option</a></code>
+ element is a boolean state, initially false. Except where otherwise specified, when the element is
+ created, its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set to true if
+ the element has a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute. Whenever an
+ <code><a href=#the-option-element>option</a></code> element's <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute is
+ added, its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set to true.</p>
- <p class=note>The <code title=dom-option><a href=#dom-option>Option()</a></code>
- constructor, when called with three or fewer arguments, overrides the initial
- state of the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> state to
- always be false even if the third argument is true (implying that a
- <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute is to
- be set). The fourth argument can be used to explicitly set the
- initial <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> state when
- using the constructor.</p>
+ <p class=note>The <code title=dom-option><a href=#dom-option>Option()</a></code> constructor, when called with three
+ or fewer arguments, overrides the initial state of the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> state to always be false even if the third
+ argument is true (implying that a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute is
+ to be set). The fourth argument can be used to explicitly set the initial <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> state when using the constructor.</p>
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/604 -->
</div>
- <p>A <code><a href=#the-select-element>select</a></code> element whose <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is not
- specified must not have more than one descendant <code><a href=#the-option-element>option</a></code>
- element with its <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code>
- attribute set.</p>
+ <p>A <code><a href=#the-select-element>select</a></code> element whose <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
+ attribute is not specified must not have more than one descendant <code><a href=#the-option-element>option</a></code> element with
+ its <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute set.</p>
<div class=impl>
<p>An <code><a href=#the-option-element>option</a></code> element's <dfn id=concept-option-index title=concept-option-index>index</dfn> is the number of
- <code><a href=#the-option-element>option</a></code> element that are in the same <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> but that
- come before it in <a href=#tree-order>tree order</a>. If the
- <code><a href=#the-option-element>option</a></code> element is not in a <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, then the
+ <code><a href=#the-option-element>option</a></code> element that are in the same <a href=#concept-select-option-list title=concept-select-option-list>list of
+ options</a> but that come before it in <a href=#tree-order>tree order</a>. If the <code><a href=#the-option-element>option</a></code>
+ element is not in a <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, then the
<code><a href=#the-option-element>option</a></code> element's <a href=#concept-option-index title=concept-option-index>index</a> is zero.</p>
</div>
@@ -51060,20 +51029,17 @@
attribute must return the same value as the <code title=dom-fae-form><a href=#dom-fae-form>form</a></code> IDL attribute
on that <code><a href=#the-select-element>select</a></code> element. Otherwise, it must return null.</p>
-<!--CLEANUP-->
- <p>A constructor is provided for creating <code><a href=#htmloptionelement>HTMLOptionElement</a></code> objects (in
- addition to the factory methods from DOM such as <code title="">createElement()</code>):
- <dfn id=dom-option title=dom-option><code>Option(<var title="">text</var>, <var title="">value</var>, <var title="">defaultSelected</var>, <var title="">selected</var>)</code></dfn>. When invoked as a constructor, it must return a new
- <code><a href=#htmloptionelement>HTMLOptionElement</a></code> object (a new <code><a href=#the-option-element>option</a></code> element).
- If the first argument is not the empty string, the new object must have as its only child a
- <code><a href=#text>Text</a></code> node whose data is the value of that argument. Otherwise, it must have no children. If the <var title="">value</var>
- argument is present, the new object must have a <code title=attr-option-value><a href=#attr-option-value>value</a></code>
- attribute set with the value of the argument as its value. If the <var title="">defaultSelected</var> argument is true, the new object must have a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute set with no value. If the <var title="">selected</var> argument is true, the new object must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true; otherwise
- the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be
- set to false, even if the <var title="">defaultSelected</var> argument is true. The
- element's document must be the <a href=#active-document>active document</a> of the <a href=#browsing-context>browsing context</a>
- of the <code><a href=#window>Window</a></code> object on which the interface object of the invoked constructor is
- found.</p>
+ <p>A constructor is provided for creating <code><a href=#htmloptionelement>HTMLOptionElement</a></code> objects (in addition to
+ the factory methods from DOM such as <code title="">createElement()</code>): <dfn id=dom-option title=dom-option><code>Option(<var title="">text</var>, <var title="">value</var>, <var title="">defaultSelected</var>, <var title="">selected</var>)</code></dfn>. When invoked as a
+ constructor, it must return a new <code><a href=#htmloptionelement>HTMLOptionElement</a></code> object (a new <code><a href=#the-option-element>option</a></code>
+ element). If the first argument is not the empty string, the new object must have as its only
+ child a <code><a href=#text>Text</a></code> node whose data is the value of that argument. Otherwise, it must have
+ no children. If the <var title="">value</var> argument is present, the new object must have a
+ <code title=attr-option-value><a href=#attr-option-value>value</a></code> attribute set with the value of the argument as its
+ value. If the <var title="">defaultSelected</var> argument is true, the new object must have a
+ <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute set with no value. If the <var title="">selected</var> argument is true, the new object must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true; otherwise the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> must be set to false, even if the <var title="">defaultSelected</var> argument is true. The element's document must be the <a href=#active-document>active
+ document</a> of the <a href=#browsing-context>browsing context</a> of the <code><a href=#window>Window</a></code> object on which
+ the interface object of the invoked constructor is found.</p>
</div>
<!--TOPIC:HTML-->
@@ -52197,59 +52163,47 @@
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
- </dl><!--TOPIC:HTML--><!--CLEANUP--><p>The <code><a href=#the-meter-element>meter</a></code> element <a href=#represents>represents</a> a scalar
- measurement within a known range, or a fractional value; for example
- disk usage, the relevance of a query result, or the fraction of a
- voting population to have selected a particular candidate.</p>
+ </dl><!--TOPIC:HTML--><p>The <code><a href=#the-meter-element>meter</a></code> element <a href=#represents>represents</a> a scalar measurement within a known
+ range, or a fractional value; for example disk usage, the relevance of a query result, or the
+ fraction of a voting population to have selected a particular candidate.</p>
<p>This is also known as a gauge.</p>
- <p class=note>The <code><a href=#the-meter-element>meter</a></code> element should not be used to
- indicate progress (as in a progress bar). For that role, HTML
- provides a separate <code><a href=#the-progress-element>progress</a></code> element.</p>
+ <p class=note>The <code><a href=#the-meter-element>meter</a></code> element should not be used to indicate progress (as in a
+ progress bar). For that role, HTML provides a separate <code><a href=#the-progress-element>progress</a></code> element.</p>
- <p class=note>The <code><a href=#the-meter-element>meter</a></code> element also does not
- represent a scalar value of arbitrary range — for example, it
- would be wrong to use this to report a weight, or height, unless
+ <p class=note>The <code><a href=#the-meter-element>meter</a></code> element also does not represent a scalar value of arbitrary
+ range — for example, it would be wrong to use this to report a weight, or height, unless
there is a known maximum value.</p>
- <p>There are six attributes that determine the semantics of the
- gauge represented by the element.</p>
+ <p>There are six attributes that determine the semantics of the gauge represented by the
+ element.</p>
- <p>The <dfn id=attr-meter-min title=attr-meter-min><code>min</code></dfn> attribute
- specifies the lower bound of the range, and the <dfn id=attr-meter-max title=attr-meter-max><code>max</code></dfn> attribute specifies
- the upper bound. The <dfn id=attr-meter-value title=attr-meter-value><code>value</code></dfn> attribute
- specifies the value to have the gauge indicate as the "measured"
- value.</p>
+ <p>The <dfn id=attr-meter-min title=attr-meter-min><code>min</code></dfn> attribute specifies the lower bound of
+ the range, and the <dfn id=attr-meter-max title=attr-meter-max><code>max</code></dfn> attribute specifies the
+ upper bound. The <dfn id=attr-meter-value title=attr-meter-value><code>value</code></dfn> attribute specifies the
+ value to have the gauge indicate as the "measured" value.</p>
- <p>The other three attributes can be used to segment the gauge's
- range into "low", "medium", and "high" parts, and to indicate which
- part of the gauge is the "optimum" part. The <dfn id=attr-meter-low title=attr-meter-low><code>low</code></dfn> attribute specifies
- the range that is considered to be the "low" part, and the <dfn id=attr-meter-high title=attr-meter-high><code>high</code></dfn> attribute specifies
- the range that is considered to be the "high" part. The <dfn id=attr-meter-optimum title=attr-meter-optimum><code>optimum</code></dfn> attribute
- gives the position that is "optimum"; if that is higher than the
- "high" value then this indicates that the higher the value, the
- better; if it's lower than the "low" mark then it indicates that
- lower values are better, and naturally if it is in between then it
- indicates that neither high nor low values are good.</p>
+ <p>The other three attributes can be used to segment the gauge's range into "low", "medium", and
+ "high" parts, and to indicate which part of the gauge is the "optimum" part. The <dfn id=attr-meter-low title=attr-meter-low><code>low</code></dfn> attribute specifies the range that is considered to
+ be the "low" part, and the <dfn id=attr-meter-high title=attr-meter-high><code>high</code></dfn> attribute
+ specifies the range that is considered to be the "high" part. The <dfn id=attr-meter-optimum title=attr-meter-optimum><code>optimum</code></dfn> attribute gives the position that is
+ "optimum"; if that is higher than the "high" value then this indicates that the higher the value,
+ the better; if it's lower than the "low" mark then it indicates that lower values are better, and
+ naturally if it is in between then it indicates that neither high nor low values are good.</p>
- <p><span class=impl><strong>Authoring
- requirements</strong>:</span> The <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute must be
- specified. The <code title=attr-meter-value><a href=#attr-meter-value>value</a></code>, <code title=attr-meter-min><a href=#attr-meter-min>min</a></code>, <code title=attr-meter-low><a href=#attr-meter-low>low</a></code>, <code title=attr-meter-high><a href=#attr-meter-high>high</a></code>, <code title=attr-meter-max><a href=#attr-meter-max>max</a></code>, and <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> attributes, when present,
- must have values that are <a href=#valid-floating-point-number title="valid floating-point
- number">valid floating-point numbers</a>.</p>
+ <p><span class=impl><strong>Authoring requirements</strong>:</span> The <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute must be specified. The <code title=attr-meter-value><a href=#attr-meter-value>value</a></code>, <code title=attr-meter-min><a href=#attr-meter-min>min</a></code>, <code title=attr-meter-low><a href=#attr-meter-low>low</a></code>, <code title=attr-meter-high><a href=#attr-meter-high>high</a></code>, <code title=attr-meter-max><a href=#attr-meter-max>max</a></code>, and <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> attributes,
+ when present, must have values that are <a href=#valid-floating-point-number title="valid floating-point number">valid
+ floating-point numbers</a>.</p>
<p>In addition, the attributes' values are further constrained:</p>
- <p>Let <var title="">value</var> be the <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute's number.</p>
+ <p>Let <var title="">value</var> be the <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute's
+ number.</p>
- <p>If the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code> attribute
- is specified, then let <var title="">minimum</var> be that
- attribute's value; otherwise, let it be zero.</p>
+ <p>If the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code> attribute is specified, then let <var title="">minimum</var> be that attribute's value; otherwise, let it be zero.</p>
- <p>If the <code title=attr-meter-max><a href=#attr-meter-max>max</a></code> attribute
- is specified, then let <var title="">maximum</var> be that
- attribute's value; otherwise, let it be 1.0.</p>
+ <p>If the <code title=attr-meter-max><a href=#attr-meter-max>max</a></code> attribute is specified, then let <var title="">maximum</var> be that attribute's value; otherwise, let it be 1.0.</p>
<p>The following inequalities must hold, as applicable:</p>
@@ -52258,13 +52212,12 @@
<li><var title="">minimum</var> ≤ <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> ≤ <var title="">maximum</var> (if <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> is specified)</li>
<li><var title="">minimum</var> ≤ <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> ≤ <var title="">maximum</var> (if <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> is specified)</li>
<li><code title=attr-meter-low><a href=#attr-meter-low>low</a></code> ≤ <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> (if both <code title=attr-meter-low><a href=#attr-meter-low>low</a></code> and <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> are specified)</li>
- </ul><p class=note>If no minimum or maximum is specified, then the
- range is assumed to be 0..1, and the value thus has to be within
- that range.</p>
+ </ul><p class=note>If no minimum or maximum is specified, then the range is assumed to be 0..1, and
+ the value thus has to be within that range.</p>
- <p>Authors are encouraged to include a textual representation of the
- gauge's state in the element's contents, for users of user agents
- that do not support the <code><a href=#the-meter-element>meter</a></code> element.</p>
+ <p>Authors are encouraged to include a textual representation of the gauge's state in the
+ element's contents, for users of user agents that do not support the <code><a href=#the-meter-element>meter</a></code>
+ element.</p>
<div class=example>
@@ -52275,16 +52228,14 @@
Voter turnout: <meter value=0.75><img alt="75%" src="graph75.png"></meter>
Tickets sold: <meter min="0" max="100" value="75"></meter></pre>
- <p>The following example is incorrect use of the element, because
- it doesn't give a range (and since the default maximum is 1, both
- of the gauges would end up looking maxed out):</p>
+ <p>The following example is incorrect use of the element, because it doesn't give a range (and
+ since the default maximum is 1, both of the gauges would end up looking maxed out):</p>
<pre class=bad><p>The grapefruit pie had a radius of <meter value=12>12cm</meter>
and a height of <meter value=2>2cm</meter>.</p> <!-- <strong>BAD!</strong> --></pre>
- <p>Instead, one would either not include the meter element, or use
- the meter element with a defined range to give the dimensions in
- context compared to other pies:</p>
+ <p>Instead, one would either not include the meter element, or use the meter element with a
+ defined range to give the dimensions in context compared to other pies:</p>
<pre><p>The grapefruit pie had a radius of 12cm and a height of
2cm.</p>
@@ -52295,9 +52246,8 @@
</div>
- <p>There is no explicit way to specify units in the
- <code><a href=#the-meter-element>meter</a></code> element, but the units may be specified in the
- <code title=attr-title><a href=#attr-title>title</a></code> attribute in free-form text.</p>
+ <p>There is no explicit way to specify units in the <code><a href=#the-meter-element>meter</a></code> element, but the units may
+ be specified in the <code title=attr-title><a href=#attr-title>title</a></code> attribute in free-form text.</p>
<div class=example>
@@ -52312,36 +52262,34 @@
<div class=impl>
- <p><strong>User agent requirements</strong>: User agents must parse
- the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code>, <code title=attr-meter-max><a href=#attr-meter-max>max</a></code>, <code title=attr-meter-value><a href=#attr-meter-value>value</a></code>, <code title=attr-meter-low><a href=#attr-meter-low>low</a></code>, <code title=attr-meter-high><a href=#attr-meter-high>high</a></code>, and <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> attributes using the
- <a href=#rules-for-parsing-floating-point-number-values>rules for parsing floating-point number values</a>.</p>
+ <p><strong>User agent requirements</strong>: User agents must parse the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code>, <code title=attr-meter-max><a href=#attr-meter-max>max</a></code>, <code title=attr-meter-value><a href=#attr-meter-value>value</a></code>, <code title=attr-meter-low><a href=#attr-meter-low>low</a></code>, <code title=attr-meter-high><a href=#attr-meter-high>high</a></code>, and <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code>
+ attributes using the <a href=#rules-for-parsing-floating-point-number-values>rules for parsing floating-point number values</a>.</p>
- <p>User agents must then use all these numbers to obtain values for
- six points on the gauge, as follows. (The order in which these are
- evaluated is important, as some of the values refer to earlier
- ones.)</p>
+ <p>User agents must then use all these numbers to obtain values for six points on the gauge, as
+ follows. (The order in which these are evaluated is important, as some of the values refer to
+ earlier ones.)</p>
<dl><dt>The <dfn id=concept-meter-minimum title=concept-meter-minimum>minimum value</dfn></dt>
<dd>
- <p>If the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code> attribute is
- specified and a value could be parsed out of it, then the minimum
- value is that value. Otherwise, the minimum value is zero.</p>
+
+ <p>If the <code title=attr-meter-min><a href=#attr-meter-min>min</a></code> attribute is specified and a value could be
+ parsed out of it, then the minimum value is that value. Otherwise, the minimum value is
+ zero.</p>
+
</dd>
<dt>The <dfn id=concept-meter-maximum title=concept-meter-maximum>maximum value</dfn></dt>
<dd>
- <p>If the <code title=attr-meter-max><a href=#attr-meter-max>max</a></code> attribute is
- specified and a value could be parsed out of it, then the
- candidate maximum value is that value. Otherwise, the candidate
+ <p>If the <code title=attr-meter-max><a href=#attr-meter-max>max</a></code> attribute is specified and a value could be
+ parsed out of it, then the candidate maximum value is that value. Otherwise, the candidate
maximum value is 1.0.</p>
- <p>If the candidate maximum value is greater than or equal to the
- minimum value, then the maximum value is the candidate maximum
- value. Otherwise, the maximum value is the same as the minimum
- value.</p>
+ <p>If the candidate maximum value is greater than or equal to the minimum value, then the
+ maximum value is the candidate maximum value. Otherwise, the maximum value is the same as the
+ minimum value.</p>
</dd>
@@ -52349,16 +52297,15 @@
<dd>
- <p>If the <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute is
- specified and a value could be parsed out of it, then that value
- is the candidate actual value. Otherwise, the candidate actual
- value is zero.</p>
+ <p>If the <code title=attr-meter-value><a href=#attr-meter-value>value</a></code> attribute is specified and a value could
+ be parsed out of it, then that value is the candidate actual value. Otherwise, the candidate
+ actual value is zero.</p>
- <p>If the candidate actual value is less than the minimum value,
- then the actual value is the minimum value.</p>
+ <p>If the candidate actual value is less than the minimum value, then the actual value is the
+ minimum value.</p>
- <p>Otherwise, if the candidate actual value is greater than the
- maximum value, then the actual value is the maximum value.</p>
+ <p>Otherwise, if the candidate actual value is greater than the maximum value, then the actual
+ value is the maximum value.</p>
<p>Otherwise, the actual value is the candidate actual value.</p>
@@ -52368,16 +52315,15 @@
<dd>
- <p>If the <code title=attr-meter-low><a href=#attr-meter-low>low</a></code> attribute is
- specified and a value could be parsed out of it, then the
- candidate low boundary is that value. Otherwise, the candidate low
+ <p>If the <code title=attr-meter-low><a href=#attr-meter-low>low</a></code> attribute is specified and a value could be
+ parsed out of it, then the candidate low boundary is that value. Otherwise, the candidate low
boundary is the same as the minimum value.</p>
- <p>If the candidate low boundary is less than the minimum value,
- then the low boundary is the minimum value.</p>
+ <p>If the candidate low boundary is less than the minimum value, then the low boundary is the
+ minimum value.</p>
- <p>Otherwise, if the candidate low boundary is greater than the
- maximum value, then the low boundary is the maximum value.</p>
+ <p>Otherwise, if the candidate low boundary is greater than the maximum value, then the low
+ boundary is the maximum value.</p>
<p>Otherwise, the low boundary is the candidate low boundary.</p>
@@ -52387,16 +52333,15 @@
<dd>
- <p>If the <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> attribute is
- specified and a value could be parsed out of it, then the
- candidate high boundary is that value. Otherwise, the candidate
- high boundary is the same as the maximum value.</p>
+ <p>If the <code title=attr-meter-high><a href=#attr-meter-high>high</a></code> attribute is specified and a value could be
+ parsed out of it, then the candidate high boundary is that value. Otherwise, the candidate high
+ boundary is the same as the maximum value.</p>
- <p>If the candidate high boundary is less than the low boundary,
- then the high boundary is the low boundary.</p>
+ <p>If the candidate high boundary is less than the low boundary, then the high boundary is the
+ low boundary.</p>
- <p>Otherwise, if the candidate high boundary is greater than the
- maximum value, then the high boundary is the maximum value.</p>
+ <p>Otherwise, if the candidate high boundary is greater than the maximum value, then the high
+ boundary is the maximum value.</p>
<p>Otherwise, the high boundary is the candidate high boundary.</p>
@@ -52406,51 +52351,41 @@
<dd>
- <p>If the <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code>
- attribute is specified and a value could be parsed out of it, then
- the candidate optimum point is that value. Otherwise, the
- candidate optimum point is the midpoint between the minimum value
- and the maximum value.</p>
+ <p>If the <code title=attr-meter-optimum><a href=#attr-meter-optimum>optimum</a></code> attribute is specified and a value
+ could be parsed out of it, then the candidate optimum point is that value. Otherwise, the
+ candidate optimum point is the midpoint between the minimum value and the maximum value.</p>
- <p>If the candidate optimum point is less than the minimum value,
- then the optimum point is the minimum value.</p>
+ <p>If the candidate optimum point is less than the minimum value, then the optimum point is the
+ minimum value.</p>
- <p>Otherwise, if the candidate optimum point is greater than the
- maximum value, then the optimum point is the maximum value.</p>
+ <p>Otherwise, if the candidate optimum point is greater than the maximum value, then the optimum
+ point is the maximum value.</p>
- <p>Otherwise, the optimum point is the candidate optimum
- point.</p>
+ <p>Otherwise, the optimum point is the candidate optimum point.</p>
</dd>
- </dl><p>All of which will result in the following inequalities all being
- true:</p>
+ </dl><p>All of which will result in the following inequalities all being true:</p>
<ul class=brief><li>minimum value ≤ actual value ≤ maximum value</li>
<li>minimum value ≤ low boundary ≤ high boundary ≤ maximum value</li>
<li>minimum value ≤ optimum point ≤ maximum value</li>
- </ul><p><strong>UA requirements for regions of the gauge</strong>: If the
- optimum point is equal to the low boundary or the high boundary, or
- anywhere in between them, then the region between the low and high
- boundaries of the gauge must be treated as the optimum region, and
- the low and high parts, if any, must be treated as suboptimal.
- Otherwise, if the optimum point is less than the low boundary, then
- the region between the minimum value and the low boundary must be
- treated as the optimum region, the region from the low boundary up
- to the high boundary must be treated as a suboptimal region, and the
- remaining region must be treated as an even less good region.
- Finally, if the optimum point is higher than the high boundary, then
- the situation is reversed; the region between the high boundary and
- the maximum value must be treated as the optimum region, the region
- from the high boundary down to the low boundary must be treated as a
- suboptimal region, and the remaining region must be treated as an
- even less good region.</p>
+ </ul><p><strong>UA requirements for regions of the gauge</strong>: If the optimum point is equal to the
+ low boundary or the high boundary, or anywhere in between them, then the region between the low
+ and high boundaries of the gauge must be treated as the optimum region, and the low and high
+ parts, if any, must be treated as suboptimal. Otherwise, if the optimum point is less than the low
+ boundary, then the region between the minimum value and the low boundary must be treated as the
+ optimum region, the region from the low boundary up to the high boundary must be treated as a
+ suboptimal region, and the remaining region must be treated as an even less good region. Finally,
+ if the optimum point is higher than the high boundary, then the situation is reversed; the region
+ between the high boundary and the maximum value must be treated as the optimum region, the region
+ from the high boundary down to the low boundary must be treated as a suboptimal region, and the
+ remaining region must be treated as an even less good region.</p>
- <p><strong>UA requirements for showing the gauge</strong>: When
- representing a <code><a href=#the-meter-element>meter</a></code> element to the user, the UA should
- indicate the relative position of the actual value to the minimum
- and maximum values, and the relationship between the actual value
- and the three regions of the gauge.</p>
+ <p><strong>UA requirements for showing the gauge</strong>: When representing a <code><a href=#the-meter-element>meter</a></code>
+ element to the user, the UA should indicate the relative position of the actual value to the
+ minimum and maximum values, and the relationship between the actual value and the three regions of
+ the gauge.</p>
</div>
@@ -52483,10 +52418,8 @@
<p><img alt="With the <meter> elements rendered as inline green bars of varying lengths." height=178 src=http://images.whatwg.org/sample-meter.png width=332></p>
</div>
- <p>User agents <span class=impl>may</span> combine the value of
- the <code title=attr-title><a href=#attr-title>title</a></code> attribute and the other
- attributes to provide context-sensitive help or inline text
- detailing the actual values.</p>
+ <p>User agents <span class=impl>may</span> combine the value of the <code title=attr-title><a href=#attr-title>title</a></code> attribute and the other attributes to provide context-sensitive
+ help or inline text detailing the actual values.</p>
<div class=example>
<p>For example, the following snippet:</p>
@@ -52498,51 +52431,48 @@
<div class=impl>
- <p>The <dfn id=dom-meter-value title=dom-meter-value><code>value</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-actual title=concept-meter-actual>actual value</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-value><a href=#dom-meter-value>value</a></code> content attribute must be set
- to that string.</p>
+ <p>The <dfn id=dom-meter-value title=dom-meter-value><code>value</code></dfn> IDL attribute, on getting, must
+ return the <a href=#concept-meter-actual title=concept-meter-actual>actual value</a>. On setting, the given value
+ must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a>
+ and then the <code title=dom-meter-value><a href=#dom-meter-value>value</a></code> content attribute must be set to that
+ string.</p>
- <p>The <dfn id=dom-meter-min title=dom-meter-min><code>min</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-minimum title=concept-meter-minimum>minimum value</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-min><a href=#dom-meter-min>min</a></code> content attribute must be set to
- that string.</p>
+ <p>The <dfn id=dom-meter-min title=dom-meter-min><code>min</code></dfn> IDL attribute, on getting, must return
+ the <a href=#concept-meter-minimum title=concept-meter-minimum>minimum value</a>. On setting, the given value must be
+ converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a> and
+ then the <code title=dom-meter-min><a href=#dom-meter-min>min</a></code> content attribute must be set to that string.</p>
- <p>The <dfn id=dom-meter-max title=dom-meter-max><code>max</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-maximum title=concept-meter-maximum>maximum value</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-max><a href=#dom-meter-max>max</a></code> content attribute must be set to
- that string.</p>
+ <p>The <dfn id=dom-meter-max title=dom-meter-max><code>max</code></dfn> IDL attribute, on getting, must return
+ the <a href=#concept-meter-maximum title=concept-meter-maximum>maximum value</a>. On setting, the given value must be
+ converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a> and
+ then the <code title=dom-meter-max><a href=#dom-meter-max>max</a></code> content attribute must be set to that string.</p>
- <p>The <dfn id=dom-meter-low title=dom-meter-low><code>low</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-low title=concept-meter-low>low boundary</a>. On setting, the given
- value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the
- number as a floating-point number</a> and then the <code title=dom-meter-low><a href=#dom-meter-low>low</a></code> content attribute must be set to
- that string.</p>
+ <p>The <dfn id=dom-meter-low title=dom-meter-low><code>low</code></dfn> IDL attribute, on getting, must return
+ the <a href=#concept-meter-low title=concept-meter-low>low boundary</a>. On setting, the given value must be
+ converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a> and
+ then the <code title=dom-meter-low><a href=#dom-meter-low>low</a></code> content attribute must be set to that string.</p>
- <p>The <dfn id=dom-meter-high title=dom-meter-high><code>high</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-high title=concept-meter-high>high boundary</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-high><a href=#dom-meter-high>high</a></code> content attribute must be set to
- that string.</p>
+ <p>The <dfn id=dom-meter-high title=dom-meter-high><code>high</code></dfn> IDL attribute, on getting, must return
+ the <a href=#concept-meter-high title=concept-meter-high>high boundary</a>. On setting, the given value must be
+ converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a> and
+ then the <code title=dom-meter-high><a href=#dom-meter-high>high</a></code> content attribute must be set to that
+ string.</p>
- <p>The <dfn id=dom-meter-optimum title=dom-meter-optimum><code>optimum</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-meter-optimum title=concept-meter-optimum>optimum value</a>. On setting, the
- given value must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of
- the number as a floating-point number</a> and then the <code title=dom-meter-optimum><a href=#dom-meter-optimum>optimum</a></code> content attribute must be
- set to that string.</p>
+ <p>The <dfn id=dom-meter-optimum title=dom-meter-optimum><code>optimum</code></dfn> IDL attribute, on getting, must
+ return the <a href=#concept-meter-optimum title=concept-meter-optimum>optimum value</a>. On setting, the given value
+ must be converted to the <a href=#best-representation-of-the-number-as-a-floating-point-number>best representation of the number as a floating-point number</a>
+ and then the <code title=dom-meter-optimum><a href=#dom-meter-optimum>optimum</a></code> content attribute must be set to that
+ string.</p>
- <p>The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute
- provides a list of the element's <code><a href=#the-label-element>label</a></code>s.</p>
+ <p>The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a list of the element's
+ <code><a href=#the-label-element>label</a></code>s.</p>
</div>
<div class=example>
- <p>The following example shows how a gauge could fall back to
- localized or pretty-printed text.</p>
+ <p>The following example shows how a gauge could fall back to localized or pretty-printed
+ text.</p>
<pre><p>Disk usage: <meter min=0 value=170261928 max=233257824>170 261 928 bytes used
out of 233 257 824 bytes available</meter></p></pre>
@@ -68070,19 +68000,16 @@
</dl><div class=impl>
- <p>The <dfn id=dom-popstateevent-state title=dom-PopStateEvent-state><code>state</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents the context information for the event, or null, if the
- state represented is the initial state of the
- <code><a href=#document>Document</a></code>.</p>
+ <p>The <dfn id=dom-popstateevent-state title=dom-PopStateEvent-state><code>state</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents the context information for the event, or null, if the state represented is
+ the initial state of the <code><a href=#document>Document</a></code>.</p>
</div>
- <hr><p>The <dfn id=event-hashchange title=event-hashchange><code>hashchange</code></dfn>
- event is fired when navigating to a <a href=#session-history-entry>session history
- entry</a> whose <a href=#url>URL</a> differs from that of the
- previous one only in the fragment identifier.</p>
+ <hr><p>The <dfn id=event-hashchange title=event-hashchange><code>hashchange</code></dfn> event is fired when navigating
+ to a <a href=#session-history-entry>session history entry</a> whose <a href=#url>URL</a> differs from that of the previous
+ one only in the fragment identifier.</p>
<pre class=idl>[Constructor(DOMString type, optional <a href=#hashchangeeventinit>HashChangeEventInit</a> eventInitDict)]
interface <dfn id=hashchangeevent>HashChangeEvent</dfn> : <a href=#event>Event</a> {
@@ -68099,8 +68026,8 @@
<dd>
- <p>Returns the <a href=#url>URL</a> of the <a href=#session-history-entry>session history
- entry</a> that was previously current.</p>
+ <p>Returns the <a href=#url>URL</a> of the <a href=#session-history-entry>session history entry</a> that was previously
+ current.</p>
</dd>
@@ -68109,36 +68036,30 @@
<dd>
- <p>Returns the <a href=#url>URL</a> of the <a href=#session-history-entry>session history
- entry</a> that is now current.</p>
+ <p>Returns the <a href=#url>URL</a> of the <a href=#session-history-entry>session history entry</a> that is now
+ current.</p>
</dd>
</dl><div class=impl>
- <p>The <dfn id=dom-hashchangeevent-oldurl title=dom-HashChangeEvent-oldURL><code>oldURL</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents context information for the event, specifically the URL
- of the <a href=#session-history-entry>session history entry</a> that was traversed
- from.</p>
+ <p>The <dfn id=dom-hashchangeevent-oldurl title=dom-HashChangeEvent-oldURL><code>oldURL</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents context information for the event, specifically the URL of the <a href=#session-history-entry>session
+ history entry</a> that was traversed from.</p>
- <p>The <dfn id=dom-hashchangeevent-newurl title=dom-HashChangeEvent-newURL><code>newURL</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents context information for the event, specifically the URL
- of the <a href=#session-history-entry>session history entry</a> that was traversed to.</p>
+ <p>The <dfn id=dom-hashchangeevent-newurl title=dom-HashChangeEvent-newURL><code>newURL</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents context information for the event, specifically the URL of the <a href=#session-history-entry>session
+ history entry</a> that was traversed to.</p>
</div>
- <hr><p>The <dfn id=event-pageshow title=event-pageshow><code>pageshow</code></dfn> event
- is fired when traversing <em>to</em> a <a href=#session-history-entry>session history
- entry</a>. The <dfn id=event-pagehide title=event-pagehide><code>pagehide</code></dfn> event is fired
- when traversing <em>from</em> a <a href=#session-history-entry>session history entry</a>.
- The specification uses the <a href=#page-showing>page showing</a> flag to ensure
- that scripts receive these events in a consistent manner (e.g. that
- they never receive two <code title=event-pagehide><a href=#event-pagehide>pagehide</a></code>
- events in a row without an intervening <code title=event-pageshow><a href=#event-pageshow>pageshow</a></code>, or vice versa).</p>
+ <hr><p>The <dfn id=event-pageshow title=event-pageshow><code>pageshow</code></dfn> event is fired when traversing
+ <em>to</em> a <a href=#session-history-entry>session history entry</a>. The <dfn id=event-pagehide title=event-pagehide><code>pagehide</code></dfn> event is fired when traversing <em>from</em> a
+ <a href=#session-history-entry>session history entry</a>. The specification uses the <a href=#page-showing>page showing</a> flag to
+ ensure that scripts receive these events in a consistent manner (e.g. that they never receive two
+ <code title=event-pagehide><a href=#event-pagehide>pagehide</a></code> events in a row without an intervening <code title=event-pageshow><a href=#event-pageshow>pageshow</a></code>, or vice versa).</p>
<pre class=idl>[Constructor(DOMString type, optional <a href=#pagetransitioneventinit>PageTransitionEventInit</a> eventInitDict)]
interface <dfn id=pagetransitionevent>PageTransitionEvent</dfn> : <a href=#event>Event</a> {
@@ -68153,16 +68074,16 @@
<dd>
- <p>Returns false if the page is newly being loaded (and the <code title=event-load>load</code> event will fire). Otherwise, returns true.</p>
+ <p>Returns false if the page is newly being loaded (and the <code title=event-load>load</code>
+ event will fire). Otherwise, returns true.</p>
</dd>
</dl><div class=impl>
- <p>The <dfn id=dom-pagetransitionevent-persisted title=dom-PageTransitionEvent-persisted><code>persisted</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to false. It
- represents the context information for the event.</p>
+ <p>The <dfn id=dom-pagetransitionevent-persisted title=dom-PageTransitionEvent-persisted><code>persisted</code></dfn> attribute must
+ return the value it was initialized to. When the object is created, this attribute must be
+ initialized to false. It represents the context information for the event.</p>
</div>
@@ -68321,40 +68242,33 @@
</ol></li>
- <li><p>If <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> and <var title="">recycle</var> are both false, then the
- <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing context</a> must <a href=#discard-a-document title="discard a document">discard the
+ <li><p>If <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> and <var title="">recycle</var> are both false, then the <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing
+ context</a> must <a href=#discard-a-document title="discard a document">discard the
<code>Document</code></a>.</li>
- <li><p><i>End</i>: Decrease the <code><a href=#document>Document</a></code>'s
- <a href=#ignore-opens-during-unload-counter>ignore-opens-during-unload counter</a> by one.</li>
+ <li><p><i>End</i>: Decrease the <code><a href=#document>Document</a></code>'s <a href=#ignore-opens-during-unload-counter>ignore-opens-during-unload
+ counter</a> by one.</li>
- </ol><p>This specification defines the following <dfn id=unloading-document-cleanup-steps>unloading document
- cleanup steps</dfn>. Other specifications can define more.</p>
+ </ol><p>This specification defines the following <dfn id=unloading-document-cleanup-steps>unloading document cleanup steps</dfn>. Other
+ specifications can define more.</p>
<ol><li>
- <p><a href=#make-disappear>Make disappear</a> any <code><a href=#websocket>WebSocket</a></code> objects
- that were created by the <code title=dom-WebSocket><a href=#dom-websocket>WebSocket()</a></code> constructor whose global
- object is the <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object.
+ <p><a href=#make-disappear>Make disappear</a> any <code><a href=#websocket>WebSocket</a></code> objects that were created by the <code title=dom-WebSocket><a href=#dom-websocket>WebSocket()</a></code> constructor whose global object is the
+ <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object.</p>
+ <p>If this affected any <code><a href=#websocket>WebSocket</a></code> objects, then set <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> state to false.</p>
- </p>
-
- <p>If this affected any <code><a href=#websocket>WebSocket</a></code> objects, the set
- <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> state to
- false.</p>
-
</li>
- <li><p>If the <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> state is
- false, <a href=#concept-eventsource-forcibly-close title=concept-EventSource-forcibly-close>forcibly
- close</a> any <code><a href=#eventsource>EventSource</a></code> objects that whose
- constructor was invoked from the <code><a href=#document>Document</a></code>'s
- <code><a href=#window>Window</a></code> object.</li>
+ <li><p>If the <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var>
+ state is false, <a href=#concept-eventsource-forcibly-close title=concept-EventSource-forcibly-close>forcibly close</a> any
+ <code><a href=#eventsource>EventSource</a></code> objects that whose constructor was invoked from the
+ <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object.</li>
- <li><p>If the <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var> state is
- false, empty the <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code>'s
- <a href=#list-of-active-timers>list of active timers</a>.</li>
+ <li><p>If the <code><a href=#document>Document</a></code>'s <var title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></var>
+ state is false, empty the <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code>'s <a href=#list-of-active-timers>list of active
+ timers</a>.</li>
</ol><h5 id=event-definition><span class=secno>6.6.11.1 </span>Event definition</h5>
@@ -71991,13 +71905,9 @@
<div class=impl>
<h5 id=event-firing><span class=secno>7.1.6.3 </span>Event firing</h5>
-<!--CLEANUP-->
- <p>Certain operations and methods are defined as firing events on
- elements. For example, the <code title=dom-click><a href=#dom-click>click()</a></code>
- method on the <code><a href=#htmlelement>HTMLElement</a></code> interface is defined as
- firing a <code title=event-click><a href=#event-click>click</a></code> event on the
- element. <a href=#refsDOMEVENTS>[DOMEVENTS]</a></p>
+ <p>Certain operations and methods are defined as firing events on elements. For example, the <code title=dom-click><a href=#dom-click>click()</a></code> method on the <code><a href=#htmlelement>HTMLElement</a></code> interface is defined as
+ firing a <code title=event-click><a href=#event-click>click</a></code> event on the element. <a href=#refsDOMEVENTS>[DOMEVENTS]</a></p>
<p><dfn id=fire-a-simple-event title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means
that a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event with the name <var title="">e</var>, which does not bubble (except where otherwise stated) and is not cancelable
@@ -72011,14 +71921,14 @@
attributes initialized to 0, its <code title="">ctrlKey</code>, <code title="">shiftKey</code>,
<code title="">altKey</code>, and <code title="">metaKey</code> attributes initialized according
to the current state of the key input device, if any (false for any keys that are not available),
- its <code title="">detail</code> attribute initialized to 1, and its <code title="">relatedTarget</code> attribute initialized to null (except where otherwise stated). The <code title="">getModifierState()</code> method on the object must return values appropriately
+ its <code title="">detail</code> attribute initialized to 1, and its <code title="">relatedTarget</code> attribute initialized to null (except where otherwise stated). The
+ <code title="">getModifierState()</code> method on the object must return values appropriately
describing the state of the key input device at the time the event is created.</p>
<p><dfn id=fire-a-click-event title="fire a click event">Firing a <code title=event-click>click</code> event</dfn>
means <a href=#fire-a-synthetic-mouse-event title="fire a synthetic mouse event">firing a synthetic mouse event named <code title=event-click>click</code></a>, which bubbles and is cancelable.</p>
- <p>The default action of these events is to do nothing except where
- otherwise stated.</p>
+ <p>The default action of these events is to do nothing except where otherwise stated.</p>
</div>
@@ -72042,8 +71952,8 @@
<h3 id=atob><span class=secno>7.2 </span>Base64 utility methods</h3>
- <p>The <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> and <code title=dom-windowbase64-btoa><a href=#dom-windowbase64-btoa>btoa()</a></code> methods allow authors to
- transform content to and from the base64 encoding.</p>
+ <p>The <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> and <code title=dom-windowbase64-btoa><a href=#dom-windowbase64-btoa>btoa()</a></code> methods allow authors to transform content to and from
+ the base64 encoding.</p>
<!-- v2: actual binary support -->
@@ -72054,22 +71964,20 @@
};
<a href=#window>Window</a> implements <a href=#windowbase64>WindowBase64</a>;</pre>
- <p class=note>In these APIs, for mnemonic purposes, the "b" can be
- considered to stand for "binary", and the "a" for "ASCII". In
- practice, though, for primarily historical reasons, both the input
- and output of these functions are Unicode strings.</p>
+ <p class=note>In these APIs, for mnemonic purposes, the "b" can be considered to stand for
+ "binary", and the "a" for "ASCII". In practice, though, for primarily historical reasons, both the
+ input and output of these functions are Unicode strings.</p>
<dl class=domintro><dt><var title="">result</var> = <var title="">window</var> . <code title=dom-windowbase64-btoa><a href=#dom-windowbase64-btoa>btoa</a></code>( <var title="">data</var> )</dt>
<dd>
- <p>Takes the input data, in the form of a Unicode string
- containing only characters in the range U+0000 to U+00FF, each
- representing a binary byte with values 0x00 to 0xFF respectively,
- and converts it to its base64 representation, which it returns.</p>
+ <p>Takes the input data, in the form of a Unicode string containing only characters in the range
+ U+0000 to U+00FF, each representing a binary byte with values 0x00 to 0xFF respectively, and
+ converts it to its base64 representation, which it returns.</p>
- <p>Throws an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the
- input string contains any out-of-range characters.</p>
+ <p>Throws an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the input string contains any
+ out-of-range characters.</p>
</dd>
@@ -72077,91 +71985,77 @@
<dd>
- <p>Takes the input data, in the form of a Unicode string
- containing base64-encoded binary data, decodes it, and returns a
- string consisting of characters in the range U+0000 to U+00FF,
- each representing a binary byte with values 0x00 to 0xFF
- respectively, corresponding to that binary data.</p>
+ <p>Takes the input data, in the form of a Unicode string containing base64-encoded binary data,
+ decodes it, and returns a string consisting of characters in the range U+0000 to U+00FF, each
+ representing a binary byte with values 0x00 to 0xFF respectively, corresponding to that binary
+ data.</p>
- <p>Throws an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the
- input string is not valid base64 data.</p>
+ <p>Throws an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the input string is not valid
+ base64 data.</p>
</dd>
</dl><div class=impl>
- <p class=note>The <code><a href=#windowbase64>WindowBase64</a></code> interface adds to the
- <code><a href=#window>Window</a></code> interface and the <code><a href=#workerglobalscope>WorkerGlobalScope</a></code>
- interface (part of Web Workers).</p>
+ <p class=note>The <code><a href=#windowbase64>WindowBase64</a></code> interface adds to the <code><a href=#window>Window</a></code> interface
+ and the <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> interface (part of Web Workers).</p>
- <p>The <dfn id=dom-windowbase64-btoa title=dom-windowbase64-btoa><code>btoa()</code></dfn>
- method must throw an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if
- the method's first argument contains any character whose code point
- is greater than U+00FF. Otherwise, the user agent must convert that
- argument to a sequence of octets whose <var title="">n</var>th octet
- is the eight-bit representation of the code point of the <var title="">n</var>th character of the argument, and then must apply
- the base64 algorithm to that sequence of octets, and return the
- result. <a href=#refsRFC4648>[RFC4648]</a><!--base64--></p>
- <!-- Aryeh says: This seems to be what all browsers do as of January
- 2011 (except IE, which doesn't support these functions at all). -->
+ <p>The <dfn id=dom-windowbase64-btoa title=dom-windowbase64-btoa><code>btoa()</code></dfn> method must throw an
+ <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception if the method's first argument contains any character
+ whose code point is greater than U+00FF. Otherwise, the user agent must convert that argument to a
+ sequence of octets whose <var title="">n</var>th octet is the eight-bit representation of the code
+ point of the <var title="">n</var>th character of the argument, and then must apply the base64
+ algorithm to that sequence of octets, and return the result. <a href=#refsRFC4648>[RFC4648]</a><!--base64--></p> <!-- Aryeh says: This seems to be what all
+ browsers do as of January 2011 (except IE, which doesn't support these functions at all). -->
- <p>The <dfn id=dom-windowbase64-atob title=dom-windowbase64-atob><code>atob()</code></dfn>
- method must run the following steps to parse the string passed in
- the method's first argument:</p>
+ <p>The <dfn id=dom-windowbase64-atob title=dom-windowbase64-atob><code>atob()</code></dfn> method must run the following
+ steps to parse the string passed in the method's first argument:</p>
- <ol><!-- Aryeh says: Copies Firefox behavior as of January 2011
- (4.0b8). WebKit is somewhat laxer, and Opera throws no exceptions
- at all. gsnedders reports Opera's behavior causes site-compat
- problems, and I figure most sites depend on Firefox if on anything,
- so go with that. --><!-- Since updated to drop whitespace, based on the arguments here:
+ <ol><!-- Aryeh says: Copies Firefox behavior as of January 2011 (4.0b8). WebKit is somewhat laxer,
+ and Opera throws no exceptions at all. gsnedders reports Opera's behavior causes site-compat
+ problems, and I figure most sites depend on Firefox if on anything, so go with that. --><!-- Since updated to drop whitespace, based on the arguments here:
http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2011-May/031613.html
- --><li><p>Let <var title="">input</var> be the string being
- parsed.</li>
+ --><li><p>Let <var title="">input</var> be the string being parsed.</li>
- <li><p>Let <var title="">position</var> be a pointer into <var title="">input</var>, initially pointing at the start of the
- string.</li>
+ <li><p>Let <var title="">position</var> be a pointer into <var title="">input</var>, initially
+ pointing at the start of the string.</li>
- <li><p>Remove all <a href=#space-character title="space character">space
- characters</a> from <var title="">input</var>.</li>
+ <li><p>Remove all <a href=#space-character title="space character">space characters</a> from <var title="">input</var>.</li>
- <li><p>If the length of <var title="">input</var> divides by 4
- leaving no remainder, then: if <var title="">input</var> ends with
- one or two U+003D EQUALS SIGN (=) characters, remove them from <var title="">input</var>.</li>
+ <li><p>If the length of <var title="">input</var> divides by 4 leaving no remainder, then: if
+ <var title="">input</var> ends with one or two U+003D EQUALS SIGN (=) characters, remove them
+ from <var title="">input</var>.</li>
- <li><p>If the length of <var title="">input</var> divides by 4
- leaving a remainder of 1, throw an
- <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception and abort these
- steps.</p>
+ <li><p>If the length of <var title="">input</var> divides by 4 leaving a remainder of 1, throw an
+ <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception and abort these steps.</p>
<li>
- <p>If <var title="">input</var> contains a character that is not
- in the following list of characters and character ranges, throw an
- <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception and abort these
- steps:</p>
+ <p>If <var title="">input</var> contains a character that is not in the following list of
+ characters and character ranges, throw an <code><a href=#invalidcharactererror>InvalidCharacterError</a></code> exception and abort
+ these steps:</p>
<ul class=brief><li>U+002B PLUS SIGN (+)
<li>U+002F SOLIDUS (/)
<li><a href=#alphanumeric-ascii-characters>Alphanumeric ASCII characters</a>
</ul></li>
- <li><p>Let <var title="">output</var> be a string, initially
+ <li><p>Let <var title="">output</var> be a string, initially empty.</li>
+
+ <li><p>Let <var title="">buffer</var> be a buffer that can have bits appended to it, initially
empty.</li>
- <li><p>Let <var title="">buffer</var> be a buffer that can have
- bits appended to it, initially empty.</li>
-
<li>
- <p>While <var title="">position</var> does not point past the end
- of <var title="">input</var>, run these substeps:</p>
+ <p>While <var title="">position</var> does not point past the end of <var title="">input</var>,
+ run these substeps:</p>
<ol><li>
- <p>Find the character pointed to by <var title="">position</var>
- in the first column of the following table. Let <var title="">n</var> be the number given in the second cell of the
- same row.</p>
+ <p>Find the character pointed to by <var title="">position</var> in the first column of the
+ following table. Let <var title="">n</var> be the number given in the second cell of the same
+ row.</p>
<div id=base64-table>
<table><thead><tr><th>Character
@@ -72234,47 +72128,36 @@
</li>
- <li><p>Append to <var title="">buffer</var> the six bits
- corresponding to <var title="">number</var>, most significant bit
- first.</li>
+ <li><p>Append to <var title="">buffer</var> the six bits corresponding to <var title="">number</var>, most significant bit first.</li>
- <li><p>If <var title="">buffer</var> has accumulated 24 bits,
- interpret them as three 8-bit big-endian numbers. Append the
- three characters with code points equal to those numbers to <var title="">output</var>, in the same order, and then empty <var title="">buffer</var>.</li>
+ <li><p>If <var title="">buffer</var> has accumulated 24 bits, interpret them as three 8-bit
+ big-endian numbers. Append the three characters with code points equal to those numbers to <var title="">output</var>, in the same order, and then empty <var title="">buffer</var>.</li>
- <li><p>Advance <var title="">position</var> by one
- character.</li>
+ <li><p>Advance <var title="">position</var> by one character.</li>
</ol></li>
<li>
- <p>If <var title="">buffer</var> is not empty, it contains either
- 12 or 18 bits. If it contains 12 bits, discard the last four and
- interpret the remaining eight as an 8-bit big-endian number. If it
- contains 18 bits, discard the last two and interpret the remaining
- 16 as two 8-bit big-endian numbers. Append the one or two
- characters with code points equal to those one or two numbers to
- <var title="">output</var>, in the same order.</p>
+ <p>If <var title="">buffer</var> is not empty, it contains either 12 or 18 bits. If it contains
+ 12 bits, discard the last four and interpret the remaining eight as an 8-bit big-endian number.
+ If it contains 18 bits, discard the last two and interpret the remaining 16 as two 8-bit
+ big-endian numbers. Append the one or two characters with code points equal to those one or two
+ numbers to <var title="">output</var>, in the same order.</p>
- <p class=note>The discarded bits mean that, for instance, <code title="">atob("YQ")</code> and <code title="">atob("YR")</code>
- both return "<code title="">a</code>".</p>
+ <p class=note>The discarded bits mean that, for instance, <code title="">atob("YQ")</code> and
+ <code title="">atob("YR")</code> both return "<code title="">a</code>".</p>
</li>
<li><p>Return <var title="">output</var>.</li>
- </ol><!-- Note: this function is defined explicitly here because RFC4648
- does not specify how to handle erroneous input, and no preexisting
- browser implementation simply throws an exception on all erroneous
- input. --></div>
+ </ol><!-- Note: this function is defined explicitly here because RFC4648 does not specify how to handle
+ erroneous input, and no preexisting browser implementation simply throws an exception on all
+ erroneous input. --></div>
- <p class=note>Some base64 encoders add newlines or other
- whitespace to their output. The <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> method throws an
- exception if its input contains characters other than those
- described by the regular expression bracket expression <code title="">[+/=0-9A-Za-z]</code>, so other characters need to be
- removed before <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> is
- used for decoding.</p>
+ <p class=note>Some base64 encoders add newlines or other whitespace to their output. The <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> method throws an exception if its input contains
+ characters other than those described by the regular expression bracket expression <code title="">[+/=0-9A-Za-z]</code>, so other characters need to be removed before <code title=dom-windowbase64-atob><a href=#dom-windowbase64-atob>atob()</a></code> is used for decoding.</p>
Modified: source
===================================================================
--- source 2013-04-11 21:33:47 UTC (rev 7806)
+++ source 2013-04-11 21:42:13 UTC (rev 7807)
@@ -11152,15 +11152,14 @@
<h4>Requirements relating to bidirectional-algorithm formatting characters</h4>
-<!--CLEANUP-->
<p><span>Text content</span> in <span>HTML elements</span> with child <code>Text</code> nodes, and
text in attributes of <span>HTML elements</span> that allow free-form text, may contain characters
- in the ranges U+202A to U+202E and U+2066 to U+2069 (the bidirectional-algorithm formatting characters). However, the
- use of these characters is restricted so that any embedding or overrides generated by these
- characters do not start and end with different parent elements, and so that all such embeddings
- and overrides are explicitly terminated by a U+202C POP DIRECTIONAL FORMATTING character. This
- helps reduce incidences of text being reused in a manner that has unforeseen effects on the
- bidirectional algorithm. <a href="#refsBIDI">[BIDI]</a></p>
+ in the ranges U+202A to U+202E and U+2066 to U+2069 (the bidirectional-algorithm formatting
+ characters). However, the use of these characters is restricted so that any embedding or overrides
+ generated by these characters do not start and end with different parent elements, and so that all
+ such embeddings and overrides are explicitly terminated by a U+202C POP DIRECTIONAL FORMATTING
+ character. This helps reduce incidences of text being reused in a manner that has unforeseen
+ effects on the bidirectional algorithm. <a href="#refsBIDI">[BIDI]</a></p>
<p>The aforementioned restrictions are defined by specifying that certain parts of documents form
<span>bidirectional-algorithm formatting character ranges</span>, and then imposing a requirement
@@ -11267,58 +11266,45 @@
<h4><dfn>WAI-ARIA</dfn></h4>
- <p>Authors may use the ARIA <code title="attr-aria-role">role</code>
- and <code title="attr-aria-*">aria-*</code> attributes on <span>HTML
- elements</span>, in accordance with the requirements described in
- the ARIA specifications, except where these conflict with the
- <span>strong native semantics</span> or are equal to the
- <span>default implicit ARIA semantics</span> described below. These
- exceptions are intended to prevent authors from making assistive
- technology products report nonsensical states that do not represent
- the actual state of the document. <a href="#refsARIA">[ARIA]</a></p>
+ <p>Authors may use the ARIA <code title="attr-aria-role">role</code> and <code
+ title="attr-aria-*">aria-*</code> attributes on <span>HTML elements</span>, in accordance with the
+ requirements described in the ARIA specifications, except where these conflict with the
+ <span>strong native semantics</span> or are equal to the <span>default implicit ARIA
+ semantics</span> described below. These exceptions are intended to prevent authors from making
+ assistive technology products report nonsensical states that do not represent the actual state of
+ the document. <a href="#refsARIA">[ARIA]</a></p>
- <p>Authors must not set the ARIA <code
- title="attr-aria-role">role</code> and <code
- title="attr-aria-*">aria-*</code> attributes in a manner that
- conflicts with the semantics described in the following table,
- except that the <code
- title="attr-aria-role-presentation">presentation</code> role may
- always be used. Authors must not set the ARIA <code
- title="attr-aria-role">role</code> and <code
- title="attr-aria-*">aria-*</code> attributes to values that match
- the <span>default implicit ARIA semantics</span> defined in the
+ <p>Authors must not set the ARIA <code title="attr-aria-role">role</code> and <code
+ title="attr-aria-*">aria-*</code> attributes in a manner that conflicts with the semantics
+ described in the following table, except that the <code
+ title="attr-aria-role-presentation">presentation</code> role may always be used. Authors must not
+ set the ARIA <code title="attr-aria-role">role</code> and <code title="attr-aria-*">aria-*</code>
+ attributes to values that match the <span>default implicit ARIA semantics</span> defined in the
following two tables.</p>
<div class="impl">
- <p>User agents are required to implement ARIA semantics on all
- <span>HTML elements</span>, as defined in the ARIA specifications.
- The <span>default implicit ARIA semantics</span> defined below must
- be recognized by implementations for the purposes of ARIA
- processing. <a href="#refsARIAIMPL">[ARIAIMPL]</a></p>
+ <p>User agents are required to implement ARIA semantics on all <span>HTML elements</span>, as
+ defined in the ARIA specifications. The <span>default implicit ARIA semantics</span> defined below
+ must be recognized by implementations for the purposes of ARIA processing. <a
+ href="#refsARIAIMPL">[ARIAIMPL]</a></p>
- <p class="note">The ARIA attributes defined in the ARIA
- specifications, and the <span>strong native semantics</span> and
- <span>default implicit ARIA semantics</span> defined below, do not
- have any effect on CSS pseudo-class matching, user interface
- modalities that don't use assistive technologies, or the default
- actions of user interaction events as described in this
- specification.</p> <!-- this is a truism, in that there are no
- requirements that require that those attributes have such an effect,
- and no requirements that relax the requirements on those effects
- such that they could be affected by those attributes -->
+ <p class="note">The ARIA attributes defined in the ARIA specifications, and the <span>strong
+ native semantics</span> and <span>default implicit ARIA semantics</span> defined below, do not
+ have any effect on CSS pseudo-class matching, user interface modalities that don't use assistive
+ technologies, or the default actions of user interaction events as described in this
+ specification.</p> <!-- this is a truism, in that there are no requirements that require that
+ those attributes have such an effect, and no requirements that relax the requirements on those
+ effects such that they could be affected by those attributes -->
</div>
- <p>The following table defines the <span>strong native
- semantics</span> and corresponding <span>default implicit ARIA
- semantics</span> that apply to <span>HTML elements</span>. Each
- language feature (element or attribute) in a cell in the first
- column implies the ARIA semantics (any role, states, and properties)
- given in the cell in the second column of the same row. <span
- class="impl">When multiple rows apply to an element, the role from
- the last row to define a role must be applied, and the states and
- properties from all the rows must be combined.</span></p>
+ <p>The following table defines the <span>strong native semantics</span> and corresponding
+ <span>default implicit ARIA semantics</span> that apply to <span>HTML elements</span>. Each
+ language feature (element or attribute) in a cell in the first column implies the ARIA semantics
+ (any role, states, and properties) given in the cell in the second column of the same row. <span
+ class="impl">When multiple rows apply to an element, the role from the last row to define a role
+ must be applied, and the states and properties from all the rows must be combined.</span></p>
<table id="table-aria-strong">
<thead>
@@ -11780,39 +11766,31 @@
</table>
- <p>The entry "<dfn title="concept-role-none">no role</dfn>", when
- used as a <span title="strong native semantics">strong native
- semantic</span>, means that no role other than <code
- title="attr-aria-role-presentation">presentation</code> can be used.
- When used as a <span title="default implicit ARIA semantics">default
- implicit ARIA semantic</span>, it means the user agent has no default
- mapping to ARIA roles. (However, it probably will have its own
- mappings to the accessibility layer.)</p>
+ <p>The entry "<dfn title="concept-role-none">no role</dfn>", when used as a <span title="strong
+ native semantics">strong native semantic</span>, means that no role other than <code
+ title="attr-aria-role-presentation">presentation</code> can be used. When used as a <span
+ title="default implicit ARIA semantics">default implicit ARIA semantic</span>, it means the user
+ agent has no default mapping to ARIA roles. (However, it probably will have its own mappings to
+ the accessibility layer.)</p>
<div class="impl">
- <p>Conformance checkers are encouraged to phrase errors such that
- authors are encouraged to use more appropriate elements rather than
- remove accessibility annotations. For example, if an <code>a</code>
- element is marked as having the <code
- title="attr-aria-role-button">button</code> role, a conformance
- checker could say "Use a more appropriate element to represent a
- button, for example a <code>button</code> element or an
- <code>input</code> element" rather than "The <code
- title="attr-aria-role-button">button</code> role cannot be used with
- <code>a</code> elements".</p>
+ <p>Conformance checkers are encouraged to phrase errors such that authors are encouraged to use
+ more appropriate elements rather than remove accessibility annotations. For example, if an
+ <code>a</code> element is marked as having the <code title="attr-aria-role-button">button</code>
+ role, a conformance checker could say "Use a more appropriate element to represent a button, for
+ example a <code>button</code> element or an <code>input</code> element" rather than "The <code
+ title="attr-aria-role-button">button</code> role cannot be used with <code>a</code> elements".</p>
</div>
<div class="example">
- <p>These features can be used to make accessibility tools render
- content to their users in more useful ways. For example, ASCII art,
- which is really an image, appears to be text, and in the absence of
- appropriate annotations would end up being rendered by screen
- readers as a very painful reading of lots of punctuation. Using the
- features described in this section, one can instead make the ATs
- skip the ASCII art and just read the caption:</p>
+ <p>These features can be used to make accessibility tools render content to their users in more
+ useful ways. For example, ASCII art, which is really an image, appears to be text, and in the
+ absence of appropriate annotations would end up being rendered by screen readers as a very
+ painful reading of lots of punctuation. Using the features described in this section, one can
+ instead make the ATs skip the ASCII art and just read the caption:</p>
<pre><figure <strong>role="img" aria-labelledby="fish-caption"</strong>> <!-- that's "labelled" with TWO "l"s -->
<pre>
@@ -60385,109 +60363,81 @@
};</pre>
</dd>
</dl><!--TOPIC:HTML-->
-<!--CLEANUP-->
- <p>The <code>option</code> element <span>represents</span> an option
- in a <code>select</code> element or as part of a list of suggestions
- in a <code>datalist</code> element.</p>
+ <p>The <code>option</code> element <span>represents</span> an option in a <code>select</code>
+ element or as part of a list of suggestions in a <code>datalist</code> element.</p>
- <p>In certain circumstances described in the definition of the
- <code>select</code> element, an <code>option</code> element can be a
- <code>select</code> element's <span>placeholder label option</span>.
- A <span>placeholder label option</span> does not represent an actual
- option, but instead represents a label for the <code>select</code>
- control.</p>
+ <p>In certain circumstances described in the definition of the <code>select</code> element, an
+ <code>option</code> element can be a <code>select</code> element's <span>placeholder label
+ option</span>. A <span>placeholder label option</span> does not represent an actual option, but
+ instead represents a label for the <code>select</code> control.</p>
- <p>The <dfn title="attr-option-disabled"><code>disabled</code></dfn>
- attribute is a <span>boolean attribute</span>. An
- <code>option</code> element is <dfn
+ <p>The <dfn title="attr-option-disabled"><code>disabled</code></dfn> attribute is a <span>boolean
+ attribute</span>. An <code>option</code> element is <dfn
title="concept-option-disabled">disabled</dfn> if its <code
- title="attr-option-disabled">disabled</code> attribute is present or
- if it is a child of an <code>optgroup</code> element whose <code
- title="attr-optgroup-disabled">disabled</code> attribute is
- present.</p>
+ title="attr-option-disabled">disabled</code> attribute is present or if it is a child of an
+ <code>optgroup</code> element whose <code title="attr-optgroup-disabled">disabled</code> attribute
+ is present.</p>
<div class="impl">
- <p>An <code>option</code> element that is <span
- title="attr-option-disabled">disabled</span> must prevent any <code
- title="event-click">click</code> events that are <span title="queue
- a task">queued</span> on the <span>user interaction task
- source</span> from being dispatched on the element.</p>
+ <p>An <code>option</code> element that is <span title="attr-option-disabled">disabled</span> must
+ prevent any <code title="event-click">click</code> events that are <span title="queue a
+ task">queued</span> on the <span>user interaction task source</span> from being dispatched on the
+ element.</p>
</div>
- <p>The <dfn title="attr-option-label"><code>label</code></dfn>
- attribute provides a label for element. The <dfn
- title="concept-option-label">label</dfn> of an <code>option</code>
- element is the value of the <code
- title="attr-option-label">label</code> content attribute, if there
- is one, or, if there is not, the value of the element's <code
- title="dom-option-text">text</code> IDL attribute.</p>
+ <p>The <dfn title="attr-option-label"><code>label</code></dfn> attribute provides a label for
+ element. The <dfn title="concept-option-label">label</dfn> of an <code>option</code> element is
+ the value of the <code title="attr-option-label">label</code> content attribute, if there is one,
+ or, if there is not, the value of the element's <code title="dom-option-text">text</code> IDL
+ attribute.</p>
<p>The <code title="attr-option-label">label</code> content attribute, if specified, must not be
empty. If the attribute is not specified, then the element itself must not be empty.</p>
- <p>The <dfn title="attr-option-value"><code>value</code></dfn>
- attribute provides a value for element. The <dfn
- title="concept-option-value">value</dfn> of an <code>option</code>
- element is the value of the <code
- title="attr-option-value">value</code> content attribute, if there
- is one, or, if there is not, the value of the element's <code
- title="dom-option-text">text</code> IDL attribute.</p>
+ <p>The <dfn title="attr-option-value"><code>value</code></dfn> attribute provides a value for
+ element. The <dfn title="concept-option-value">value</dfn> of an <code>option</code> element is
+ the value of the <code title="attr-option-value">value</code> content attribute, if there is one,
+ or, if there is not, the value of the element's <code title="dom-option-text">text</code> IDL
+ attribute.</p>
- <p>The <dfn title="attr-option-selected"><code>selected</code></dfn>
- attribute is a <span>boolean attribute</span>. It represents the
- default <span
- title="concept-option-selectedness">selectedness</span> of the
- element.</p>
+ <p>The <dfn title="attr-option-selected"><code>selected</code></dfn> attribute is a <span>boolean
+ attribute</span>. It represents the default <span
+ title="concept-option-selectedness">selectedness</span> of the element.</p>
<div class="impl">
- <p>The <dfn title="concept-option-selectedness">selectedness</dfn>
- of an <code>option</code> element is a boolean state, initially
- false. Except where otherwise
- specified, when the element is created, its <span
- title="concept-option-selectedness">selectedness</span> must be set
- to true if the element has a <code
- title="attr-option-selected">selected</code> attribute. Whenever an
- <code>option</code> element's <code
- title="attr-option-selected">selected</code> attribute is added, its
- <span title="concept-option-selectedness">selectedness</span> must
- be set to true.</p>
+ <p>The <dfn title="concept-option-selectedness">selectedness</dfn> of an <code>option</code>
+ element is a boolean state, initially false. Except where otherwise specified, when the element is
+ created, its <span title="concept-option-selectedness">selectedness</span> must be set to true if
+ the element has a <code title="attr-option-selected">selected</code> attribute. Whenever an
+ <code>option</code> element's <code title="attr-option-selected">selected</code> attribute is
+ added, its <span title="concept-option-selectedness">selectedness</span> must be set to true.</p>
- <p class="note">The <code title="dom-option">Option()</code>
- constructor, when called with three or fewer arguments, overrides the initial
- state of the <span
- title="concept-option-selectedness">selectedness</span> state to
- always be false even if the third argument is true (implying that a
- <code title="attr-option-selected">selected</code> attribute is to
- be set). The fourth argument can be used to explicitly set the
- initial <span
- title="concept-option-selectedness">selectedness</span> state when
- using the constructor.</p>
+ <p class="note">The <code title="dom-option">Option()</code> constructor, when called with three
+ or fewer arguments, overrides the initial state of the <span
+ title="concept-option-selectedness">selectedness</span> state to always be false even if the third
+ argument is true (implying that a <code title="attr-option-selected">selected</code> attribute is
+ to be set). The fourth argument can be used to explicitly set the initial <span
+ title="concept-option-selectedness">selectedness</span> state when using the constructor.</p>
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/604 -->
</div>
- <p>A <code>select</code> element whose <code
- title="attr-select-multiple">multiple</code> attribute is not
- specified must not have more than one descendant <code>option</code>
- element with its <code title="attr-option-selected">selected</code>
- attribute set.</p>
+ <p>A <code>select</code> element whose <code title="attr-select-multiple">multiple</code>
+ attribute is not specified must not have more than one descendant <code>option</code> element with
+ its <code title="attr-option-selected">selected</code> attribute set.</p>
<div class="impl">
- <p>An <code>option</code> element's <dfn
- title="concept-option-index">index</dfn> is the number of
- <code>option</code> element that are in the same <span
- title="concept-select-option-list">list of options</span> but that
- come before it in <span>tree order</span>. If the
- <code>option</code> element is not in a <span
- title="concept-select-option-list">list of options</span>, then the
- <code>option</code> element's <span
- title="concept-option-index">index</span> is zero.</p>
+ <p>An <code>option</code> element's <dfn title="concept-option-index">index</dfn> is the number of
+ <code>option</code> element that are in the same <span title="concept-select-option-list">list of
+ options</span> but that come before it in <span>tree order</span>. If the <code>option</code>
+ element is not in a <span title="concept-select-option-list">list of options</span>, then the
+ <code>option</code> element's <span title="concept-option-index">index</span> is zero.</p>
</div>
@@ -60589,26 +60539,23 @@
attribute must return the same value as the <code title="dom-fae-form">form</code> IDL attribute
on that <code>select</code> element. Otherwise, it must return null.</p>
-<!--CLEANUP-->
- <p>A constructor is provided for creating <code>HTMLOptionElement</code> objects (in
- addition to the factory methods from DOM such as <code title="">createElement()</code>):
- <dfn title="dom-option"><code>Option(<var
- title="">text</var>, <var title="">value</var>, <var title="">defaultSelected</var>, <var
- title="">selected</var>)</code></dfn>. When invoked as a constructor, it must return a new
- <code>HTMLOptionElement</code> object (a new <code>option</code> element).
- If the first argument is not the empty string, the new object must have as its only child a
- <code>Text</code> node whose data is the value of that argument. Otherwise, it must have no children. If the <var title="">value</var>
- argument is present, the new object must have a <code title="attr-option-value">value</code>
- attribute set with the value of the argument as its value. If the <var
- title="">defaultSelected</var> argument is true, the new object must have a <code
- title="attr-option-selected">selected</code> attribute set with no value. If the <var
+ <p>A constructor is provided for creating <code>HTMLOptionElement</code> objects (in addition to
+ the factory methods from DOM such as <code title="">createElement()</code>): <dfn
+ title="dom-option"><code>Option(<var title="">text</var>, <var title="">value</var>, <var
+ title="">defaultSelected</var>, <var title="">selected</var>)</code></dfn>. When invoked as a
+ constructor, it must return a new <code>HTMLOptionElement</code> object (a new <code>option</code>
+ element). If the first argument is not the empty string, the new object must have as its only
+ child a <code>Text</code> node whose data is the value of that argument. Otherwise, it must have
+ no children. If the <var title="">value</var> argument is present, the new object must have a
+ <code title="attr-option-value">value</code> attribute set with the value of the argument as its
+ value. If the <var title="">defaultSelected</var> argument is true, the new object must have a
+ <code title="attr-option-selected">selected</code> attribute set with no value. If the <var
title="">selected</var> argument is true, the new object must have its <span
- title="concept-option-selectedness">selectedness</span> set to true; otherwise
- the <span title="concept-option-selectedness">selectedness</span> must be
- set to false, even if the <var title="">defaultSelected</var> argument is true. The
- element's document must be the <span>active document</span> of the <span>browsing context</span>
- of the <code>Window</code> object on which the interface object of the invoked constructor is
- found.</p>
+ title="concept-option-selectedness">selectedness</span> set to true; otherwise the <span
+ title="concept-option-selectedness">selectedness</span> must be set to false, even if the <var
+ title="">defaultSelected</var> argument is true. The element's document must be the <span>active
+ document</span> of the <span>browsing context</span> of the <code>Window</code> object on which
+ the interface object of the invoked constructor is found.</p>
</div>
<!--TOPIC:HTML-->
@@ -61930,72 +61877,55 @@
</dd>
</dl><!--TOPIC:HTML-->
-<!--CLEANUP-->
- <p>The <code>meter</code> element <span>represents</span> a scalar
- measurement within a known range, or a fractional value; for example
- disk usage, the relevance of a query result, or the fraction of a
- voting population to have selected a particular candidate.</p>
+ <p>The <code>meter</code> element <span>represents</span> a scalar measurement within a known
+ range, or a fractional value; for example disk usage, the relevance of a query result, or the
+ fraction of a voting population to have selected a particular candidate.</p>
<p>This is also known as a gauge.</p>
- <p class="note">The <code>meter</code> element should not be used to
- indicate progress (as in a progress bar). For that role, HTML
- provides a separate <code>progress</code> element.</p>
+ <p class="note">The <code>meter</code> element should not be used to indicate progress (as in a
+ progress bar). For that role, HTML provides a separate <code>progress</code> element.</p>
- <p class="note">The <code>meter</code> element also does not
- represent a scalar value of arbitrary range — for example, it
- would be wrong to use this to report a weight, or height, unless
+ <p class="note">The <code>meter</code> element also does not represent a scalar value of arbitrary
+ range — for example, it would be wrong to use this to report a weight, or height, unless
there is a known maximum value.</p>
- <p>There are six attributes that determine the semantics of the
- gauge represented by the element.</p>
+ <p>There are six attributes that determine the semantics of the gauge represented by the
+ element.</p>
- <p>The <dfn title="attr-meter-min"><code>min</code></dfn> attribute
- specifies the lower bound of the range, and the <dfn
- title="attr-meter-max"><code>max</code></dfn> attribute specifies
- the upper bound. The <dfn
- title="attr-meter-value"><code>value</code></dfn> attribute
- specifies the value to have the gauge indicate as the "measured"
- value.</p>
+ <p>The <dfn title="attr-meter-min"><code>min</code></dfn> attribute specifies the lower bound of
+ the range, and the <dfn title="attr-meter-max"><code>max</code></dfn> attribute specifies the
+ upper bound. The <dfn title="attr-meter-value"><code>value</code></dfn> attribute specifies the
+ value to have the gauge indicate as the "measured" value.</p>
- <p>The other three attributes can be used to segment the gauge's
- range into "low", "medium", and "high" parts, and to indicate which
- part of the gauge is the "optimum" part. The <dfn
- title="attr-meter-low"><code>low</code></dfn> attribute specifies
- the range that is considered to be the "low" part, and the <dfn
- title="attr-meter-high"><code>high</code></dfn> attribute specifies
- the range that is considered to be the "high" part. The <dfn
- title="attr-meter-optimum"><code>optimum</code></dfn> attribute
- gives the position that is "optimum"; if that is higher than the
- "high" value then this indicates that the higher the value, the
- better; if it's lower than the "low" mark then it indicates that
- lower values are better, and naturally if it is in between then it
- indicates that neither high nor low values are good.</p>
+ <p>The other three attributes can be used to segment the gauge's range into "low", "medium", and
+ "high" parts, and to indicate which part of the gauge is the "optimum" part. The <dfn
+ title="attr-meter-low"><code>low</code></dfn> attribute specifies the range that is considered to
+ be the "low" part, and the <dfn title="attr-meter-high"><code>high</code></dfn> attribute
+ specifies the range that is considered to be the "high" part. The <dfn
+ title="attr-meter-optimum"><code>optimum</code></dfn> attribute gives the position that is
+ "optimum"; if that is higher than the "high" value then this indicates that the higher the value,
+ the better; if it's lower than the "low" mark then it indicates that lower values are better, and
+ naturally if it is in between then it indicates that neither high nor low values are good.</p>
- <p><span class="impl"><strong>Authoring
- requirements</strong>:</span> The <code
- title="attr-meter-value">value</code> attribute must be
- specified. The <code title="attr-meter-value">value</code>, <code
- title="attr-meter-min">min</code>, <code
- title="attr-meter-low">low</code>, <code
- title="attr-meter-high">high</code>, <code
- title="attr-meter-max">max</code>, and <code
- title="attr-meter-optimum">optimum</code> attributes, when present,
- must have values that are <span title="valid floating-point
- number">valid floating-point numbers</span>.</p>
+ <p><span class="impl"><strong>Authoring requirements</strong>:</span> The <code
+ title="attr-meter-value">value</code> attribute must be specified. The <code
+ title="attr-meter-value">value</code>, <code title="attr-meter-min">min</code>, <code
+ title="attr-meter-low">low</code>, <code title="attr-meter-high">high</code>, <code
+ title="attr-meter-max">max</code>, and <code title="attr-meter-optimum">optimum</code> attributes,
+ when present, must have values that are <span title="valid floating-point number">valid
+ floating-point numbers</span>.</p>
<p>In addition, the attributes' values are further constrained:</p>
- <p>Let <var title="">value</var> be the <code
- title="attr-meter-value">value</code> attribute's number.</p>
+ <p>Let <var title="">value</var> be the <code title="attr-meter-value">value</code> attribute's
+ number.</p>
- <p>If the <code title="attr-meter-min">min</code> attribute
- is specified, then let <var title="">minimum</var> be that
- attribute's value; otherwise, let it be zero.</p>
+ <p>If the <code title="attr-meter-min">min</code> attribute is specified, then let <var
+ title="">minimum</var> be that attribute's value; otherwise, let it be zero.</p>
- <p>If the <code title="attr-meter-max">max</code> attribute
- is specified, then let <var title="">maximum</var> be that
- attribute's value; otherwise, let it be 1.0.</p>
+ <p>If the <code title="attr-meter-max">max</code> attribute is specified, then let <var
+ title="">maximum</var> be that attribute's value; otherwise, let it be 1.0.</p>
<p>The following inequalities must hold, as applicable:</p>
@@ -62007,13 +61937,12 @@
<li><code title="attr-meter-low">low</code> ≤ <code title="attr-meter-high">high</code> (if both <code title="attr-meter-low">low</code> and <code title="attr-meter-high">high</code> are specified)</li>
</ul>
- <p class="note">If no minimum or maximum is specified, then the
- range is assumed to be 0..1, and the value thus has to be within
- that range.</p>
+ <p class="note">If no minimum or maximum is specified, then the range is assumed to be 0..1, and
+ the value thus has to be within that range.</p>
- <p>Authors are encouraged to include a textual representation of the
- gauge's state in the element's contents, for users of user agents
- that do not support the <code>meter</code> element.</p>
+ <p>Authors are encouraged to include a textual representation of the gauge's state in the
+ element's contents, for users of user agents that do not support the <code>meter</code>
+ element.</p>
<div class="example">
@@ -62024,16 +61953,14 @@
Voter turnout: <meter value=0.75><img alt="75%" src="graph75.png"></meter>
Tickets sold: <meter min="0" max="100" value="75"></meter></pre>
- <p>The following example is incorrect use of the element, because
- it doesn't give a range (and since the default maximum is 1, both
- of the gauges would end up looking maxed out):</p>
+ <p>The following example is incorrect use of the element, because it doesn't give a range (and
+ since the default maximum is 1, both of the gauges would end up looking maxed out):</p>
<pre class="bad"><p>The grapefruit pie had a radius of <meter value=12>12cm</meter>
and a height of <meter value=2>2cm</meter>.</p> <!-- <strong>BAD!</strong> --></pre>
- <p>Instead, one would either not include the meter element, or use
- the meter element with a defined range to give the dimensions in
- context compared to other pies:</p>
+ <p>Instead, one would either not include the meter element, or use the meter element with a
+ defined range to give the dimensions in context compared to other pies:</p>
<pre><p>The grapefruit pie had a radius of 12cm and a height of
2cm.</p>
@@ -62044,9 +61971,8 @@
</div>
- <p>There is no explicit way to specify units in the
- <code>meter</code> element, but the units may be specified in the
- <code title="attr-title">title</code> attribute in free-form text.</p>
+ <p>There is no explicit way to specify units in the <code>meter</code> element, but the units may
+ be specified in the <code title="attr-title">title</code> attribute in free-form text.</p>
<div class="example">
@@ -62061,43 +61987,39 @@
<div class="impl">
- <p><strong>User agent requirements</strong>: User agents must parse
- the <code title="attr-meter-min">min</code>, <code
- title="attr-meter-max">max</code>, <code
- title="attr-meter-value">value</code>, <code
- title="attr-meter-low">low</code>, <code
- title="attr-meter-high">high</code>, and <code
- title="attr-meter-optimum">optimum</code> attributes using the
- <span>rules for parsing floating-point number values</span>.</p>
+ <p><strong>User agent requirements</strong>: User agents must parse the <code
+ title="attr-meter-min">min</code>, <code title="attr-meter-max">max</code>, <code
+ title="attr-meter-value">value</code>, <code title="attr-meter-low">low</code>, <code
+ title="attr-meter-high">high</code>, and <code title="attr-meter-optimum">optimum</code>
+ attributes using the <span>rules for parsing floating-point number values</span>.</p>
- <p>User agents must then use all these numbers to obtain values for
- six points on the gauge, as follows. (The order in which these are
- evaluated is important, as some of the values refer to earlier
- ones.)</p>
+ <p>User agents must then use all these numbers to obtain values for six points on the gauge, as
+ follows. (The order in which these are evaluated is important, as some of the values refer to
+ earlier ones.)</p>
<dl>
<dt>The <dfn title="concept-meter-minimum">minimum value</dfn></dt>
<dd>
- <p>If the <code title="attr-meter-min">min</code> attribute is
- specified and a value could be parsed out of it, then the minimum
- value is that value. Otherwise, the minimum value is zero.</p>
+
+ <p>If the <code title="attr-meter-min">min</code> attribute is specified and a value could be
+ parsed out of it, then the minimum value is that value. Otherwise, the minimum value is
+ zero.</p>
+
</dd>
<dt>The <dfn title="concept-meter-maximum">maximum value</dfn></dt>
<dd>
- <p>If the <code title="attr-meter-max">max</code> attribute is
- specified and a value could be parsed out of it, then the
- candidate maximum value is that value. Otherwise, the candidate
+ <p>If the <code title="attr-meter-max">max</code> attribute is specified and a value could be
+ parsed out of it, then the candidate maximum value is that value. Otherwise, the candidate
maximum value is 1.0.</p>
- <p>If the candidate maximum value is greater than or equal to the
- minimum value, then the maximum value is the candidate maximum
- value. Otherwise, the maximum value is the same as the minimum
- value.</p>
+ <p>If the candidate maximum value is greater than or equal to the minimum value, then the
+ maximum value is the candidate maximum value. Otherwise, the maximum value is the same as the
+ minimum value.</p>
</dd>
@@ -62105,16 +62027,15 @@
<dd>
- <p>If the <code title="attr-meter-value">value</code> attribute is
- specified and a value could be parsed out of it, then that value
- is the candidate actual value. Otherwise, the candidate actual
- value is zero.</p>
+ <p>If the <code title="attr-meter-value">value</code> attribute is specified and a value could
+ be parsed out of it, then that value is the candidate actual value. Otherwise, the candidate
+ actual value is zero.</p>
- <p>If the candidate actual value is less than the minimum value,
- then the actual value is the minimum value.</p>
+ <p>If the candidate actual value is less than the minimum value, then the actual value is the
+ minimum value.</p>
- <p>Otherwise, if the candidate actual value is greater than the
- maximum value, then the actual value is the maximum value.</p>
+ <p>Otherwise, if the candidate actual value is greater than the maximum value, then the actual
+ value is the maximum value.</p>
<p>Otherwise, the actual value is the candidate actual value.</p>
@@ -62124,16 +62045,15 @@
<dd>
- <p>If the <code title="attr-meter-low">low</code> attribute is
- specified and a value could be parsed out of it, then the
- candidate low boundary is that value. Otherwise, the candidate low
+ <p>If the <code title="attr-meter-low">low</code> attribute is specified and a value could be
+ parsed out of it, then the candidate low boundary is that value. Otherwise, the candidate low
boundary is the same as the minimum value.</p>
- <p>If the candidate low boundary is less than the minimum value,
- then the low boundary is the minimum value.</p>
+ <p>If the candidate low boundary is less than the minimum value, then the low boundary is the
+ minimum value.</p>
- <p>Otherwise, if the candidate low boundary is greater than the
- maximum value, then the low boundary is the maximum value.</p>
+ <p>Otherwise, if the candidate low boundary is greater than the maximum value, then the low
+ boundary is the maximum value.</p>
<p>Otherwise, the low boundary is the candidate low boundary.</p>
@@ -62143,16 +62063,15 @@
<dd>
- <p>If the <code title="attr-meter-high">high</code> attribute is
- specified and a value could be parsed out of it, then the
- candidate high boundary is that value. Otherwise, the candidate
- high boundary is the same as the maximum value.</p>
+ <p>If the <code title="attr-meter-high">high</code> attribute is specified and a value could be
+ parsed out of it, then the candidate high boundary is that value. Otherwise, the candidate high
+ boundary is the same as the maximum value.</p>
- <p>If the candidate high boundary is less than the low boundary,
- then the high boundary is the low boundary.</p>
+ <p>If the candidate high boundary is less than the low boundary, then the high boundary is the
+ low boundary.</p>
- <p>Otherwise, if the candidate high boundary is greater than the
- maximum value, then the high boundary is the maximum value.</p>
+ <p>Otherwise, if the candidate high boundary is greater than the maximum value, then the high
+ boundary is the maximum value.</p>
<p>Otherwise, the high boundary is the candidate high boundary.</p>
@@ -62162,27 +62081,23 @@
<dd>
- <p>If the <code title="attr-meter-optimum">optimum</code>
- attribute is specified and a value could be parsed out of it, then
- the candidate optimum point is that value. Otherwise, the
- candidate optimum point is the midpoint between the minimum value
- and the maximum value.</p>
+ <p>If the <code title="attr-meter-optimum">optimum</code> attribute is specified and a value
+ could be parsed out of it, then the candidate optimum point is that value. Otherwise, the
+ candidate optimum point is the midpoint between the minimum value and the maximum value.</p>
- <p>If the candidate optimum point is less than the minimum value,
- then the optimum point is the minimum value.</p>
+ <p>If the candidate optimum point is less than the minimum value, then the optimum point is the
+ minimum value.</p>
- <p>Otherwise, if the candidate optimum point is greater than the
- maximum value, then the optimum point is the maximum value.</p>
+ <p>Otherwise, if the candidate optimum point is greater than the maximum value, then the optimum
+ point is the maximum value.</p>
- <p>Otherwise, the optimum point is the candidate optimum
- point.</p>
+ <p>Otherwise, the optimum point is the candidate optimum point.</p>
</dd>
</dl>
- <p>All of which will result in the following inequalities all being
- true:</p>
+ <p>All of which will result in the following inequalities all being true:</p>
<ul class="brief">
<li>minimum value ≤ actual value ≤ maximum value</li>
@@ -62190,28 +62105,22 @@
<li>minimum value ≤ optimum point ≤ maximum value</li>
</ul>
- <p><strong>UA requirements for regions of the gauge</strong>: If the
- optimum point is equal to the low boundary or the high boundary, or
- anywhere in between them, then the region between the low and high
- boundaries of the gauge must be treated as the optimum region, and
- the low and high parts, if any, must be treated as suboptimal.
- Otherwise, if the optimum point is less than the low boundary, then
- the region between the minimum value and the low boundary must be
- treated as the optimum region, the region from the low boundary up
- to the high boundary must be treated as a suboptimal region, and the
- remaining region must be treated as an even less good region.
- Finally, if the optimum point is higher than the high boundary, then
- the situation is reversed; the region between the high boundary and
- the maximum value must be treated as the optimum region, the region
- from the high boundary down to the low boundary must be treated as a
- suboptimal region, and the remaining region must be treated as an
- even less good region.</p>
+ <p><strong>UA requirements for regions of the gauge</strong>: If the optimum point is equal to the
+ low boundary or the high boundary, or anywhere in between them, then the region between the low
+ and high boundaries of the gauge must be treated as the optimum region, and the low and high
+ parts, if any, must be treated as suboptimal. Otherwise, if the optimum point is less than the low
+ boundary, then the region between the minimum value and the low boundary must be treated as the
+ optimum region, the region from the low boundary up to the high boundary must be treated as a
+ suboptimal region, and the remaining region must be treated as an even less good region. Finally,
+ if the optimum point is higher than the high boundary, then the situation is reversed; the region
+ between the high boundary and the maximum value must be treated as the optimum region, the region
+ from the high boundary down to the low boundary must be treated as a suboptimal region, and the
+ remaining region must be treated as an even less good region.</p>
- <p><strong>UA requirements for showing the gauge</strong>: When
- representing a <code>meter</code> element to the user, the UA should
- indicate the relative position of the actual value to the minimum
- and maximum values, and the relationship between the actual value
- and the three regions of the gauge.</p>
+ <p><strong>UA requirements for showing the gauge</strong>: When representing a <code>meter</code>
+ element to the user, the UA should indicate the relative position of the actual value to the
+ minimum and maximum values, and the relationship between the actual value and the three regions of
+ the gauge.</p>
</div>
@@ -62244,10 +62153,9 @@
<p><img src="images/sample-meter.png" width="332" height="178" alt="With the <meter> elements rendered as inline green bars of varying lengths."></p>
</div>
- <p>User agents <span class="impl">may</span> combine the value of
- the <code title="attr-title">title</code> attribute and the other
- attributes to provide context-sensitive help or inline text
- detailing the actual values.</p>
+ <p>User agents <span class="impl">may</span> combine the value of the <code
+ title="attr-title">title</code> attribute and the other attributes to provide context-sensitive
+ help or inline text detailing the actual values.</p>
<div class="example">
<p>For example, the following snippet:</p>
@@ -62259,63 +62167,48 @@
<div class="impl">
- <p>The <dfn title="dom-meter-value"><code>value</code></dfn> IDL
- attribute, on getting, must return the <span
- title="concept-meter-actual">actual value</span>. On setting, the
- given value must be converted to the <span>best representation of
- the number as a floating-point number</span> and then the <code
- title="dom-meter-value">value</code> content attribute must be set
- to that string.</p>
+ <p>The <dfn title="dom-meter-value"><code>value</code></dfn> IDL attribute, on getting, must
+ return the <span title="concept-meter-actual">actual value</span>. On setting, the given value
+ must be converted to the <span>best representation of the number as a floating-point number</span>
+ and then the <code title="dom-meter-value">value</code> content attribute must be set to that
+ string.</p>
- <p>The <dfn title="dom-meter-min"><code>min</code></dfn> IDL
- attribute, on getting, must return the <span
- title="concept-meter-minimum">minimum value</span>. On setting, the
- given value must be converted to the <span>best representation of
- the number as a floating-point number</span> and then the <code
- title="dom-meter-min">min</code> content attribute must be set to
- that string.</p>
+ <p>The <dfn title="dom-meter-min"><code>min</code></dfn> IDL attribute, on getting, must return
+ the <span title="concept-meter-minimum">minimum value</span>. On setting, the given value must be
+ converted to the <span>best representation of the number as a floating-point number</span> and
+ then the <code title="dom-meter-min">min</code> content attribute must be set to that string.</p>
- <p>The <dfn title="dom-meter-max"><code>max</code></dfn> IDL
- attribute, on getting, must return the <span
- title="concept-meter-maximum">maximum value</span>. On setting, the
- given value must be converted to the <span>best representation of
- the number as a floating-point number</span> and then the <code
- title="dom-meter-max">max</code> content attribute must be set to
- that string.</p>
+ <p>The <dfn title="dom-meter-max"><code>max</code></dfn> IDL attribute, on getting, must return
+ the <span title="concept-meter-maximum">maximum value</span>. On setting, the given value must be
+ converted to the <span>best representation of the number as a floating-point number</span> and
+ then the <code title="dom-meter-max">max</code> content attribute must be set to that string.</p>
- <p>The <dfn title="dom-meter-low"><code>low</code></dfn> IDL
- attribute, on getting, must return the <span
- title="concept-meter-low">low boundary</span>. On setting, the given
- value must be converted to the <span>best representation of the
- number as a floating-point number</span> and then the <code
- title="dom-meter-low">low</code> content attribute must be set to
- that string.</p>
+ <p>The <dfn title="dom-meter-low"><code>low</code></dfn> IDL attribute, on getting, must return
+ the <span title="concept-meter-low">low boundary</span>. On setting, the given value must be
+ converted to the <span>best representation of the number as a floating-point number</span> and
+ then the <code title="dom-meter-low">low</code> content attribute must be set to that string.</p>
- <p>The <dfn title="dom-meter-high"><code>high</code></dfn> IDL
- attribute, on getting, must return the <span
- title="concept-meter-high">high boundary</span>. On setting, the
- given value must be converted to the <span>best representation of
- the number as a floating-point number</span> and then the <code
- title="dom-meter-high">high</code> content attribute must be set to
- that string.</p>
+ <p>The <dfn title="dom-meter-high"><code>high</code></dfn> IDL attribute, on getting, must return
+ the <span title="concept-meter-high">high boundary</span>. On setting, the given value must be
+ converted to the <span>best representation of the number as a floating-point number</span> and
+ then the <code title="dom-meter-high">high</code> content attribute must be set to that
+ string.</p>
- <p>The <dfn title="dom-meter-optimum"><code>optimum</code></dfn> IDL
- attribute, on getting, must return the <span
- title="concept-meter-optimum">optimum value</span>. On setting, the
- given value must be converted to the <span>best representation of
- the number as a floating-point number</span> and then the <code
- title="dom-meter-optimum">optimum</code> content attribute must be
- set to that string.</p>
+ <p>The <dfn title="dom-meter-optimum"><code>optimum</code></dfn> IDL attribute, on getting, must
+ return the <span title="concept-meter-optimum">optimum value</span>. On setting, the given value
+ must be converted to the <span>best representation of the number as a floating-point number</span>
+ and then the <code title="dom-meter-optimum">optimum</code> content attribute must be set to that
+ string.</p>
- <p>The <code title="dom-lfe-labels">labels</code> IDL attribute
- provides a list of the element's <code>label</code>s.</p>
+ <p>The <code title="dom-lfe-labels">labels</code> IDL attribute provides a list of the element's
+ <code>label</code>s.</p>
</div>
<div class="example">
- <p>The following example shows how a gauge could fall back to
- localized or pretty-printed text.</p>
+ <p>The following example shows how a gauge could fall back to localized or pretty-printed
+ text.</p>
<pre><p>Disk usage: <meter min=0 value=170261928 max=233257824>170 261 928 bytes used
out of 233 257 824 bytes available</meter></p></pre>
@@ -80562,21 +80455,18 @@
<div class="impl">
- <p>The <dfn title="dom-PopStateEvent-state"><code>state</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents the context information for the event, or null, if the
- state represented is the initial state of the
- <code>Document</code>.</p>
+ <p>The <dfn title="dom-PopStateEvent-state"><code>state</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents the context information for the event, or null, if the state represented is
+ the initial state of the <code>Document</code>.</p>
</div>
<hr>
- <p>The <dfn title="event-hashchange"><code>hashchange</code></dfn>
- event is fired when navigating to a <span>session history
- entry</span> whose <span>URL</span> differs from that of the
- previous one only in the fragment identifier.</p>
+ <p>The <dfn title="event-hashchange"><code>hashchange</code></dfn> event is fired when navigating
+ to a <span>session history entry</span> whose <span>URL</span> differs from that of the previous
+ one only in the fragment identifier.</p>
<pre class="idl">[Constructor(DOMString type, optional <span>HashChangeEventInit</span> eventInitDict)]
interface <dfn>HashChangeEvent</dfn> : <span>Event</span> {
@@ -80595,8 +80485,8 @@
<dd>
- <p>Returns the <span>URL</span> of the <span>session history
- entry</span> that was previously current.</p>
+ <p>Returns the <span>URL</span> of the <span>session history entry</span> that was previously
+ current.</p>
</dd>
@@ -80605,8 +80495,8 @@
<dd>
- <p>Returns the <span>URL</span> of the <span>session history
- entry</span> that is now current.</p>
+ <p>Returns the <span>URL</span> of the <span>session history entry</span> that is now
+ current.</p>
</dd>
@@ -80614,34 +80504,26 @@
<div class="impl">
- <p>The <dfn
- title="dom-HashChangeEvent-oldURL"><code>oldURL</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents context information for the event, specifically the URL
- of the <span>session history entry</span> that was traversed
- from.</p>
+ <p>The <dfn title="dom-HashChangeEvent-oldURL"><code>oldURL</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents context information for the event, specifically the URL of the <span>session
+ history entry</span> that was traversed from.</p>
- <p>The <dfn
- title="dom-HashChangeEvent-newURL"><code>newURL</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to null. It
- represents context information for the event, specifically the URL
- of the <span>session history entry</span> that was traversed to.</p>
+ <p>The <dfn title="dom-HashChangeEvent-newURL"><code>newURL</code></dfn> attribute must return the
+ value it was initialized to. When the object is created, this attribute must be initialized to
+ null. It represents context information for the event, specifically the URL of the <span>session
+ history entry</span> that was traversed to.</p>
</div>
<hr>
- <p>The <dfn title="event-pageshow"><code>pageshow</code></dfn> event
- is fired when traversing <em>to</em> a <span>session history
- entry</span>. The <dfn
- title="event-pagehide"><code>pagehide</code></dfn> event is fired
- when traversing <em>from</em> a <span>session history entry</span>.
- The specification uses the <span>page showing</span> flag to ensure
- that scripts receive these events in a consistent manner (e.g. that
- they never receive two <code title="event-pagehide">pagehide</code>
- events in a row without an intervening <code
+ <p>The <dfn title="event-pageshow"><code>pageshow</code></dfn> event is fired when traversing
+ <em>to</em> a <span>session history entry</span>. The <dfn
+ title="event-pagehide"><code>pagehide</code></dfn> event is fired when traversing <em>from</em> a
+ <span>session history entry</span>. The specification uses the <span>page showing</span> flag to
+ ensure that scripts receive these events in a consistent manner (e.g. that they never receive two
+ <code title="event-pagehide">pagehide</code> events in a row without an intervening <code
title="event-pageshow">pageshow</code>, or vice versa).</p>
<pre class="idl">[Constructor(DOMString type, optional <span>PageTransitionEventInit</span> eventInitDict)]
@@ -80659,7 +80541,8 @@
<dd>
- <p>Returns false if the page is newly being loaded (and the <code title="event-load">load</code> event will fire). Otherwise, returns true.</p>
+ <p>Returns false if the page is newly being loaded (and the <code title="event-load">load</code>
+ event will fire). Otherwise, returns true.</p>
</dd>
@@ -80667,11 +80550,9 @@
<div class="impl">
- <p>The <dfn
- title="dom-PageTransitionEvent-persisted"><code>persisted</code></dfn>
- attribute must return the value it was initialized to. When the
- object is created, this attribute must be initialized to false. It
- represents the context information for the event.</p>
+ <p>The <dfn title="dom-PageTransitionEvent-persisted"><code>persisted</code></dfn> attribute must
+ return the value it was initialized to. When the object is created, this attribute must be
+ initialized to false. It represents the context information for the event.</p>
</div>
@@ -80853,54 +80734,40 @@
</li>
- <li><p>If <var
- title="concept-document-salvageable">salvageable</var> and <var
- title="">recycle</var> are both false, then the
- <code>Document</code>'s <span>browsing context</span> must <span
- title="discard a document">discard the
+ <li><p>If <var title="concept-document-salvageable">salvageable</var> and <var
+ title="">recycle</var> are both false, then the <code>Document</code>'s <span>browsing
+ context</span> must <span title="discard a document">discard the
<code>Document</code></span>.</p></li>
- <li><p><i>End</i>: Decrease the <code>Document</code>'s
- <span>ignore-opens-during-unload counter</span> by one.</p></li>
+ <li><p><i>End</i>: Decrease the <code>Document</code>'s <span>ignore-opens-during-unload
+ counter</span> by one.</p></li>
</ol>
- <p>This specification defines the following <dfn>unloading document
- cleanup steps</dfn>. Other specifications can define more.</p>
+ <p>This specification defines the following <dfn>unloading document cleanup steps</dfn>. Other
+ specifications can define more.</p>
<ol>
<li>
- <p><span>Make disappear</span> any <code>WebSocket</code> objects
- that were created by the <code
- title="dom-WebSocket">WebSocket()</code> constructor whose global
- object is the <code>Document</code>'s <code>Window</code> object.
+ <p><span>Make disappear</span> any <code>WebSocket</code> objects that were created by the <code
+ title="dom-WebSocket">WebSocket()</code> constructor whose global object is the
+ <code>Document</code>'s <code>Window</code> object.</p>
-<!--END complete-->
- <a href="#refsWEBSOCKET">[WEBSOCKET]</a>
-<!--START complete-->
+ <p>If this affected any <code>WebSocket</code> objects, then set <code>Document</code>'s <var
+ title="concept-document-salvageable">salvageable</var> state to false.</p>
- </p>
-
- <p>If this affected any <code>WebSocket</code> objects, the set
- <code>Document</code>'s <var
- title="concept-document-salvageable">salvageable</var> state to
- false.</p>
-
</li>
- <li><p>If the <code>Document</code>'s <var
- title="concept-document-salvageable">salvageable</var> state is
- false, <span title="concept-EventSource-forcibly-close">forcibly
- close</span> any <code>EventSource</code> objects that whose
- constructor was invoked from the <code>Document</code>'s
- <code>Window</code> object.</p></li>
+ <li><p>If the <code>Document</code>'s <var title="concept-document-salvageable">salvageable</var>
+ state is false, <span title="concept-EventSource-forcibly-close">forcibly close</span> any
+ <code>EventSource</code> objects that whose constructor was invoked from the
+ <code>Document</code>'s <code>Window</code> object.</p></li>
- <li><p>If the <code>Document</code>'s <var
- title="concept-document-salvageable">salvageable</var> state is
- false, empty the <code>Document</code>'s <code>Window</code>'s
- <span>list of active timers</span>.</p></li>
+ <li><p>If the <code>Document</code>'s <var title="concept-document-salvageable">salvageable</var>
+ state is false, empty the <code>Document</code>'s <code>Window</code>'s <span>list of active
+ timers</span>.</p></li>
</ol>
@@ -85111,13 +84978,11 @@
<div class="impl">
<h5>Event firing</h5>
-<!--CLEANUP-->
- <p>Certain operations and methods are defined as firing events on
- elements. For example, the <code title="dom-click">click()</code>
- method on the <code>HTMLElement</code> interface is defined as
- firing a <code title="event-click">click</code> event on the
- element. <a href="#refsDOMEVENTS">[DOMEVENTS]</a></p>
+ <p>Certain operations and methods are defined as firing events on elements. For example, the <code
+ title="dom-click">click()</code> method on the <code>HTMLElement</code> interface is defined as
+ firing a <code title="event-click">click</code> event on the element. <a
+ href="#refsDOMEVENTS">[DOMEVENTS]</a></p>
<p><dfn title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means
that a <span title="concept-events-trusted">trusted</span> event with the name <var
@@ -85136,16 +85001,15 @@
<code title="">altKey</code>, and <code title="">metaKey</code> attributes initialized according
to the current state of the key input device, if any (false for any keys that are not available),
its <code title="">detail</code> attribute initialized to 1, and its <code
- title="">relatedTarget</code> attribute initialized to null (except where otherwise stated). The <code
- title="">getModifierState()</code> method on the object must return values appropriately
+ title="">relatedTarget</code> attribute initialized to null (except where otherwise stated). The
+ <code title="">getModifierState()</code> method on the object must return values appropriately
describing the state of the key input device at the time the event is created.</p>
<p><dfn title="fire a click event">Firing a <code title="event-click">click</code> event</dfn>
means <span title="fire a synthetic mouse event">firing a synthetic mouse event named <code
title="event-click">click</code></span>, which bubbles and is cancelable.</p>
- <p>The default action of these events is to do nothing except where
- otherwise stated.</p>
+ <p>The default action of these events is to do nothing except where otherwise stated.</p>
</div>
@@ -85171,8 +85035,8 @@
<h3 id="atob">Base64 utility methods</h3>
<p>The <code title="dom-windowbase64-atob">atob()</code> and <code
- title="dom-windowbase64-btoa">btoa()</code> methods allow authors to
- transform content to and from the base64 encoding.</p>
+ title="dom-windowbase64-btoa">btoa()</code> methods allow authors to transform content to and from
+ the base64 encoding.</p>
<!-- v2: actual binary support -->
@@ -85183,10 +85047,9 @@
};
<span>Window</span> implements <span>WindowBase64</span>;</pre>
- <p class="note">In these APIs, for mnemonic purposes, the "b" can be
- considered to stand for "binary", and the "a" for "ASCII". In
- practice, though, for primarily historical reasons, both the input
- and output of these functions are Unicode strings.</p>
+ <p class="note">In these APIs, for mnemonic purposes, the "b" can be considered to stand for
+ "binary", and the "a" for "ASCII". In practice, though, for primarily historical reasons, both the
+ input and output of these functions are Unicode strings.</p>
<dl class="domintro">
@@ -85194,13 +85057,12 @@
<dd>
- <p>Takes the input data, in the form of a Unicode string
- containing only characters in the range U+0000 to U+00FF, each
- representing a binary byte with values 0x00 to 0xFF respectively,
- and converts it to its base64 representation, which it returns.</p>
+ <p>Takes the input data, in the form of a Unicode string containing only characters in the range
+ U+0000 to U+00FF, each representing a binary byte with values 0x00 to 0xFF respectively, and
+ converts it to its base64 representation, which it returns.</p>
- <p>Throws an <code>InvalidCharacterError</code> exception if the
- input string contains any out-of-range characters.</p>
+ <p>Throws an <code>InvalidCharacterError</code> exception if the input string contains any
+ out-of-range characters.</p>
</dd>
@@ -85208,14 +85070,13 @@
<dd>
- <p>Takes the input data, in the form of a Unicode string
- containing base64-encoded binary data, decodes it, and returns a
- string consisting of characters in the range U+0000 to U+00FF,
- each representing a binary byte with values 0x00 to 0xFF
- respectively, corresponding to that binary data.</p>
+ <p>Takes the input data, in the form of a Unicode string containing base64-encoded binary data,
+ decodes it, and returns a string consisting of characters in the range U+0000 to U+00FF, each
+ representing a binary byte with values 0x00 to 0xFF respectively, corresponding to that binary
+ data.</p>
- <p>Throws an <code>InvalidCharacterError</code> exception if the
- input string is not valid base64 data.</p>
+ <p>Throws an <code>InvalidCharacterError</code> exception if the input string is not valid
+ base64 data.</p>
</dd>
@@ -85223,65 +85084,52 @@
<div class="impl">
- <p class="note">The <code>WindowBase64</code> interface adds to the
- <code>Window</code> interface and the <code>WorkerGlobalScope</code>
- interface (part of Web Workers).</p>
+ <p class="note">The <code>WindowBase64</code> interface adds to the <code>Window</code> interface
+ and the <code>WorkerGlobalScope</code> interface (part of Web Workers).</p>
- <p>The <dfn title="dom-windowbase64-btoa"><code>btoa()</code></dfn>
- method must throw an <code>InvalidCharacterError</code> exception if
- the method's first argument contains any character whose code point
- is greater than U+00FF. Otherwise, the user agent must convert that
- argument to a sequence of octets whose <var title="">n</var>th octet
- is the eight-bit representation of the code point of the <var
- title="">n</var>th character of the argument, and then must apply
- the base64 algorithm to that sequence of octets, and return the
- result. <a href="#refsRFC4648">[RFC4648]</a><!--base64--></p>
- <!-- Aryeh says: This seems to be what all browsers do as of January
- 2011 (except IE, which doesn't support these functions at all). -->
+ <p>The <dfn title="dom-windowbase64-btoa"><code>btoa()</code></dfn> method must throw an
+ <code>InvalidCharacterError</code> exception if the method's first argument contains any character
+ whose code point is greater than U+00FF. Otherwise, the user agent must convert that argument to a
+ sequence of octets whose <var title="">n</var>th octet is the eight-bit representation of the code
+ point of the <var title="">n</var>th character of the argument, and then must apply the base64
+ algorithm to that sequence of octets, and return the result. <a
+ href="#refsRFC4648">[RFC4648]</a><!--base64--></p> <!-- Aryeh says: This seems to be what all
+ browsers do as of January 2011 (except IE, which doesn't support these functions at all). -->
- <p>The <dfn title="dom-windowbase64-atob"><code>atob()</code></dfn>
- method must run the following steps to parse the string passed in
- the method's first argument:</p>
+ <p>The <dfn title="dom-windowbase64-atob"><code>atob()</code></dfn> method must run the following
+ steps to parse the string passed in the method's first argument:</p>
<ol>
- <!-- Aryeh says: Copies Firefox behavior as of January 2011
- (4.0b8). WebKit is somewhat laxer, and Opera throws no exceptions
- at all. gsnedders reports Opera's behavior causes site-compat
- problems, and I figure most sites depend on Firefox if on anything,
- so go with that. -->
+ <!-- Aryeh says: Copies Firefox behavior as of January 2011 (4.0b8). WebKit is somewhat laxer,
+ and Opera throws no exceptions at all. gsnedders reports Opera's behavior causes site-compat
+ problems, and I figure most sites depend on Firefox if on anything, so go with that. -->
<!-- Since updated to drop whitespace, based on the arguments here:
http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2011-May/031613.html
-->
- <li><p>Let <var title="">input</var> be the string being
- parsed.</p></li>
+ <li><p>Let <var title="">input</var> be the string being parsed.</p></li>
- <li><p>Let <var title="">position</var> be a pointer into <var
- title="">input</var>, initially pointing at the start of the
- string.</p></li>
+ <li><p>Let <var title="">position</var> be a pointer into <var title="">input</var>, initially
+ pointing at the start of the string.</p></li>
- <li><p>Remove all <span title="space character">space
- characters</span> from <var title="">input</var>.</p></li>
-
- <li><p>If the length of <var title="">input</var> divides by 4
- leaving no remainder, then: if <var title="">input</var> ends with
- one or two U+003D EQUALS SIGN (=) characters, remove them from <var
+ <li><p>Remove all <span title="space character">space characters</span> from <var
title="">input</var>.</p></li>
- <li><p>If the length of <var title="">input</var> divides by 4
- leaving a remainder of 1, throw an
- <code>InvalidCharacterError</code> exception and abort these
- steps.</p>
+ <li><p>If the length of <var title="">input</var> divides by 4 leaving no remainder, then: if
+ <var title="">input</var> ends with one or two U+003D EQUALS SIGN (=) characters, remove them
+ from <var title="">input</var>.</p></li>
+ <li><p>If the length of <var title="">input</var> divides by 4 leaving a remainder of 1, throw an
+ <code>InvalidCharacterError</code> exception and abort these steps.</p>
+
<li>
- <p>If <var title="">input</var> contains a character that is not
- in the following list of characters and character ranges, throw an
- <code>InvalidCharacterError</code> exception and abort these
- steps:</p>
+ <p>If <var title="">input</var> contains a character that is not in the following list of
+ characters and character ranges, throw an <code>InvalidCharacterError</code> exception and abort
+ these steps:</p>
<ul class="brief">
<li>U+002B PLUS SIGN (+)
@@ -85291,25 +85139,23 @@
</li>
- <li><p>Let <var title="">output</var> be a string, initially
+ <li><p>Let <var title="">output</var> be a string, initially empty.</p></li>
+
+ <li><p>Let <var title="">buffer</var> be a buffer that can have bits appended to it, initially
empty.</p></li>
- <li><p>Let <var title="">buffer</var> be a buffer that can have
- bits appended to it, initially empty.</p></li>
-
<li>
- <p>While <var title="">position</var> does not point past the end
- of <var title="">input</var>, run these substeps:</p>
+ <p>While <var title="">position</var> does not point past the end of <var title="">input</var>,
+ run these substeps:</p>
<ol>
<li>
- <p>Find the character pointed to by <var title="">position</var>
- in the first column of the following table. Let <var
- title="">n</var> be the number given in the second cell of the
- same row.</p>
+ <p>Find the character pointed to by <var title="">position</var> in the first column of the
+ following table. Let <var title="">n</var> be the number given in the second cell of the same
+ row.</p>
<div id="base64-table">
<table>
@@ -85387,18 +85233,14 @@
</li>
- <li><p>Append to <var title="">buffer</var> the six bits
- corresponding to <var title="">number</var>, most significant bit
- first.</p></li>
+ <li><p>Append to <var title="">buffer</var> the six bits corresponding to <var
+ title="">number</var>, most significant bit first.</p></li>
- <li><p>If <var title="">buffer</var> has accumulated 24 bits,
- interpret them as three 8-bit big-endian numbers. Append the
- three characters with code points equal to those numbers to <var
- title="">output</var>, in the same order, and then empty <var
- title="">buffer</var>.</p></li>
+ <li><p>If <var title="">buffer</var> has accumulated 24 bits, interpret them as three 8-bit
+ big-endian numbers. Append the three characters with code points equal to those numbers to <var
+ title="">output</var>, in the same order, and then empty <var title="">buffer</var>.</p></li>
- <li><p>Advance <var title="">position</var> by one
- character.</p></li>
+ <li><p>Advance <var title="">position</var> by one character.</p></li>
</ol>
@@ -85406,17 +85248,14 @@
<li>
- <p>If <var title="">buffer</var> is not empty, it contains either
- 12 or 18 bits. If it contains 12 bits, discard the last four and
- interpret the remaining eight as an 8-bit big-endian number. If it
- contains 18 bits, discard the last two and interpret the remaining
- 16 as two 8-bit big-endian numbers. Append the one or two
- characters with code points equal to those one or two numbers to
- <var title="">output</var>, in the same order.</p>
+ <p>If <var title="">buffer</var> is not empty, it contains either 12 or 18 bits. If it contains
+ 12 bits, discard the last four and interpret the remaining eight as an 8-bit big-endian number.
+ If it contains 18 bits, discard the last two and interpret the remaining 16 as two 8-bit
+ big-endian numbers. Append the one or two characters with code points equal to those one or two
+ numbers to <var title="">output</var>, in the same order.</p>
- <p class="note">The discarded bits mean that, for instance, <code
- title="">atob("YQ")</code> and <code title="">atob("YR")</code>
- both return "<code title="">a</code>".</p>
+ <p class="note">The discarded bits mean that, for instance, <code title="">atob("YQ")</code> and
+ <code title="">atob("YR")</code> both return "<code title="">a</code>".</p>
</li>
@@ -85424,21 +85263,17 @@
</ol>
- <!-- Note: this function is defined explicitly here because RFC4648
- does not specify how to handle erroneous input, and no preexisting
- browser implementation simply throws an exception on all erroneous
- input. -->
+ <!-- Note: this function is defined explicitly here because RFC4648 does not specify how to handle
+ erroneous input, and no preexisting browser implementation simply throws an exception on all
+ erroneous input. -->
</div>
- <p class="note">Some base64 encoders add newlines or other
- whitespace to their output. The <code
- title="dom-windowbase64-atob">atob()</code> method throws an
- exception if its input contains characters other than those
- described by the regular expression bracket expression <code
- title="">[+/=0-9A-Za-z]</code>, so other characters need to be
- removed before <code title="dom-windowbase64-atob">atob()</code> is
- used for decoding.</p>
+ <p class="note">Some base64 encoders add newlines or other whitespace to their output. The <code
+ title="dom-windowbase64-atob">atob()</code> method throws an exception if its input contains
+ characters other than those described by the regular expression bracket expression <code
+ title="">[+/=0-9A-Za-z]</code>, so other characters need to be removed before <code
+ title="dom-windowbase64-atob">atob()</code> is used for decoding.</p>
More information about the Commit-Watchers
mailing list