[html5] r8382 - [e] (0) Minor clean-up of concept-fe-value vs <select>. Affected topics: DOM API [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Jan 7 14:18:22 PST 2014
Author: ianh
Date: 2014-01-07 14:18:20 -0800 (Tue, 07 Jan 2014)
New Revision: 8382
Modified:
complete.html
index
source
Log:
[e] (0) Minor clean-up of concept-fe-value vs <select>.
Affected topics: DOM APIs, HTML
Modified: complete.html
===================================================================
--- complete.html 2014-01-07 21:12:07 UTC (rev 8381)
+++ complete.html 2014-01-07 22:18:20 UTC (rev 8382)
@@ -44333,7 +44333,8 @@
<dd>
- <p>Returns the <a href=#concept-fe-value title=concept-fe-value>value</a> of the first selected item, if any,
+<!--CLEANUP-->
+ <p>Returns the <a href=#concept-option-value title=concept-option-value>value</a> of the first selected item, if any,
or the empty string if there is no selected item.</p>
<p>Can be set, to change the selection.</p>
@@ -46476,14 +46477,18 @@
<h5 id="a-form-control's-value"><span class=secno>4.10.18.1 </span>A form control's value</h5>
- <p>Form controls have a <dfn id=concept-fe-value title=concept-fe-value>value</dfn> and a <dfn id=concept-fe-checked title=concept-fe-checked>checkedness</dfn>. (The latter is only used by <code><a href=#the-input-element>input</a></code>
+ <p>Most form controls have a <dfn id=concept-fe-value title=concept-fe-value>value</dfn> and a <dfn id=concept-fe-checked title=concept-fe-checked>checkedness</dfn>. (The latter is only used by <code><a href=#the-input-element>input</a></code>
elements.) These are used to describe how the user interacts with the control.</p>
<p>To define the behaviour of constraint validation in the face of the <code><a href=#the-input-element>input</a></code>
element's <code title=attr-input-multiple><a href=#attr-input-multiple>multiple</a></code> attribute, <code><a href=#the-input-element>input</a></code> elements
can also have separately defined <dfn id=concept-fe-values title=concept-fe-values>value<em>s</em></dfn>.</p>
+ <p>The <code><a href=#the-select-element>select</a></code> element does not have a <a href=#concept-fe-value title=concept-fe-value>value</a>;
+ the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of its <code><a href=#the-option-element>option</a></code>
+ elements is what is used instead.</p>
+
<h5 id=mutability><span class=secno>4.10.18.2 </span>Mutability</h5>
<p>A form control can be designated as <dfn id=concept-fe-mutable title=concept-fe-mutable><i>mutable</i></dfn>.</p>
@@ -46491,6 +46496,7 @@
<p class=note>This determines (by means of definitions and requirements in this specification
that rely on whether an element is so designated) whether or not the user can modify the <a href=#concept-fe-value title=concept-fe-value>value</a> or <a href=#concept-fe-checked title=concept-fe-checked>checkedness</a> of a
form control, or whether or not a control can be automatically prefilled.</p>
+ <!-- or the concept-option-selectedness, or the concept-fe-values... -->
<h5 id=association-of-controls-and-forms><span class=secno>4.10.18.3 </span>Association of controls and forms</h5>
@@ -47886,6 +47892,7 @@
</ol><p>When an element's <a href=#autofill-field-name>autofill field name</a> is "<code title=attr-fe-autocomplete-off><a href=#attr-fe-autocomplete-off>off</a></code>", the user agent should not remember the control's
<a href=#concept-fe-value title=concept-fe-value>value</a>, and should not offer past values to the user.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p class=note>In addition, when an element's <a href=#autofill-field-name>autofill field name</a> is "<code title=attr-fe-autocomplete-off><a href=#attr-fe-autocomplete-off>off</a></code>", <a href=#history-autocomplete>values are reset</a>
when <a href=#traverse-the-history title="traverse the history">traversing the history</a>.</p>
@@ -47900,6 +47907,7 @@
</div>
<p>When an element's <a href=#autofill-field-name>autofill field name</a> is <em>not</em> "<code title=attr-fe-autocomplete-off><a href=#attr-fe-autocomplete-off>off</a></code>", the user agent may store the control's <a href=#concept-fe-value title=concept-fe-value>value</a>, and may offer previously stored values to the user.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p>When the <a href=#autofill-field-name>autofill field name</a> is "<code title=attr-fe-autocomplete-on><a href=#attr-fe-autocomplete-on>on</a></code>",
the user agent should attempt to use heuristics to determine the most appropriate values to offer
@@ -47943,6 +47951,7 @@
been inserted into the document, or when the user agent <a href=#stop-parsing title="stop parsing">stops
parsing</a>). User agents must only prefill controls using values that the user could have
entered.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p class=example>For example, if a <code><a href=#the-select-element>select</a></code> element only has <code><a href=#the-option-element>option</a></code>
elements with values "Steve" and "Rebecca", "Jay", and "Bob", and has an <a href=#autofill-field-name>autofill field
@@ -48425,8 +48434,9 @@
<dl><dt> <dfn id=suffering-from-being-missing>Suffering from being missing</dfn> </dt>
- <dd> <p>When a control has no <a href=#concept-fe-value title=concept-fe-value>value</a> but has a <code title="">required</code> attribute (<code><a href=#the-input-element>input</a></code> <code title=attr-input-required><a href=#attr-input-required>required</a></code>, <code><a href=#the-select-element>select</a></code> <code title=attr-select-required><a href=#attr-select-required>required</a></code>, <code><a href=#the-textarea-element>textarea</a></code> <code title=attr-textarea-required><a href=#attr-textarea-required>required</a></code>), or, in the case of an element in a <i><a href=#radio-button-group>radio
- button group</a></i>, any of the other elements in the group has a <code title=attr-input-required><a href=#attr-input-required>required</a></code> attribute. </dd>
+ <dd> <p>When a control has no <a href=#concept-fe-value title=concept-fe-value>value</a> but has a <code title="">required</code> attribute (<code><a href=#the-input-element>input</a></code> <code title=attr-input-required><a href=#attr-input-required>required</a></code>, <code><a href=#the-textarea-element>textarea</a></code> <code title=attr-textarea-required><a href=#attr-textarea-required>required</a></code>); or, in the case of an element in a <i><a href=#radio-button-group>radio
+ button group</a></i>, any of the other elements in the group has a <code title=attr-input-required><a href=#attr-input-required>required</a></code> attribute; or, for <code><a href=#the-select-element>select</a></code> elements,
+ none of the <code><a href=#the-option-element>option</a></code> elements have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set (<code><a href=#the-select-element>select</a></code> <code title=attr-select-required><a href=#attr-select-required>required</a></code>).</dd>
<dt> <dfn id=suffering-from-a-type-mismatch>Suffering from a type mismatch</dfn> </dt>
Modified: index
===================================================================
--- index 2014-01-07 21:12:07 UTC (rev 8381)
+++ index 2014-01-07 22:18:20 UTC (rev 8382)
@@ -44333,7 +44333,8 @@
<dd>
- <p>Returns the <a href=#concept-fe-value title=concept-fe-value>value</a> of the first selected item, if any,
+<!--CLEANUP-->
+ <p>Returns the <a href=#concept-option-value title=concept-option-value>value</a> of the first selected item, if any,
or the empty string if there is no selected item.</p>
<p>Can be set, to change the selection.</p>
@@ -46476,14 +46477,18 @@
<h5 id="a-form-control's-value"><span class=secno>4.10.18.1 </span>A form control's value</h5>
- <p>Form controls have a <dfn id=concept-fe-value title=concept-fe-value>value</dfn> and a <dfn id=concept-fe-checked title=concept-fe-checked>checkedness</dfn>. (The latter is only used by <code><a href=#the-input-element>input</a></code>
+ <p>Most form controls have a <dfn id=concept-fe-value title=concept-fe-value>value</dfn> and a <dfn id=concept-fe-checked title=concept-fe-checked>checkedness</dfn>. (The latter is only used by <code><a href=#the-input-element>input</a></code>
elements.) These are used to describe how the user interacts with the control.</p>
<p>To define the behaviour of constraint validation in the face of the <code><a href=#the-input-element>input</a></code>
element's <code title=attr-input-multiple><a href=#attr-input-multiple>multiple</a></code> attribute, <code><a href=#the-input-element>input</a></code> elements
can also have separately defined <dfn id=concept-fe-values title=concept-fe-values>value<em>s</em></dfn>.</p>
+ <p>The <code><a href=#the-select-element>select</a></code> element does not have a <a href=#concept-fe-value title=concept-fe-value>value</a>;
+ the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of its <code><a href=#the-option-element>option</a></code>
+ elements is what is used instead.</p>
+
<h5 id=mutability><span class=secno>4.10.18.2 </span>Mutability</h5>
<p>A form control can be designated as <dfn id=concept-fe-mutable title=concept-fe-mutable><i>mutable</i></dfn>.</p>
@@ -46491,6 +46496,7 @@
<p class=note>This determines (by means of definitions and requirements in this specification
that rely on whether an element is so designated) whether or not the user can modify the <a href=#concept-fe-value title=concept-fe-value>value</a> or <a href=#concept-fe-checked title=concept-fe-checked>checkedness</a> of a
form control, or whether or not a control can be automatically prefilled.</p>
+ <!-- or the concept-option-selectedness, or the concept-fe-values... -->
<h5 id=association-of-controls-and-forms><span class=secno>4.10.18.3 </span>Association of controls and forms</h5>
@@ -47886,6 +47892,7 @@
</ol><p>When an element's <a href=#autofill-field-name>autofill field name</a> is "<code title=attr-fe-autocomplete-off><a href=#attr-fe-autocomplete-off>off</a></code>", the user agent should not remember the control's
<a href=#concept-fe-value title=concept-fe-value>value</a>, and should not offer past values to the user.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p class=note>In addition, when an element's <a href=#autofill-field-name>autofill field name</a> is "<code title=attr-fe-autocomplete-off><a href=#attr-fe-autocomplete-off>off</a></code>", <a href=#history-autocomplete>values are reset</a>
when <a href=#traverse-the-history title="traverse the history">traversing the history</a>.</p>
@@ -47900,6 +47907,7 @@
</div>
<p>When an element's <a href=#autofill-field-name>autofill field name</a> is <em>not</em> "<code title=attr-fe-autocomplete-off><a href=#attr-fe-autocomplete-off>off</a></code>", the user agent may store the control's <a href=#concept-fe-value title=concept-fe-value>value</a>, and may offer previously stored values to the user.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p>When the <a href=#autofill-field-name>autofill field name</a> is "<code title=attr-fe-autocomplete-on><a href=#attr-fe-autocomplete-on>on</a></code>",
the user agent should attempt to use heuristics to determine the most appropriate values to offer
@@ -47943,6 +47951,7 @@
been inserted into the document, or when the user agent <a href=#stop-parsing title="stop parsing">stops
parsing</a>). User agents must only prefill controls using values that the user could have
entered.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p class=example>For example, if a <code><a href=#the-select-element>select</a></code> element only has <code><a href=#the-option-element>option</a></code>
elements with values "Steve" and "Rebecca", "Jay", and "Bob", and has an <a href=#autofill-field-name>autofill field
@@ -48425,8 +48434,9 @@
<dl><dt> <dfn id=suffering-from-being-missing>Suffering from being missing</dfn> </dt>
- <dd> <p>When a control has no <a href=#concept-fe-value title=concept-fe-value>value</a> but has a <code title="">required</code> attribute (<code><a href=#the-input-element>input</a></code> <code title=attr-input-required><a href=#attr-input-required>required</a></code>, <code><a href=#the-select-element>select</a></code> <code title=attr-select-required><a href=#attr-select-required>required</a></code>, <code><a href=#the-textarea-element>textarea</a></code> <code title=attr-textarea-required><a href=#attr-textarea-required>required</a></code>), or, in the case of an element in a <i><a href=#radio-button-group>radio
- button group</a></i>, any of the other elements in the group has a <code title=attr-input-required><a href=#attr-input-required>required</a></code> attribute. </dd>
+ <dd> <p>When a control has no <a href=#concept-fe-value title=concept-fe-value>value</a> but has a <code title="">required</code> attribute (<code><a href=#the-input-element>input</a></code> <code title=attr-input-required><a href=#attr-input-required>required</a></code>, <code><a href=#the-textarea-element>textarea</a></code> <code title=attr-textarea-required><a href=#attr-textarea-required>required</a></code>); or, in the case of an element in a <i><a href=#radio-button-group>radio
+ button group</a></i>, any of the other elements in the group has a <code title=attr-input-required><a href=#attr-input-required>required</a></code> attribute; or, for <code><a href=#the-select-element>select</a></code> elements,
+ none of the <code><a href=#the-option-element>option</a></code> elements have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set (<code><a href=#the-select-element>select</a></code> <code title=attr-select-required><a href=#attr-select-required>required</a></code>).</dd>
<dt> <dfn id=suffering-from-a-type-mismatch>Suffering from a type mismatch</dfn> </dt>
Modified: source
===================================================================
--- source 2014-01-07 21:12:07 UTC (rev 8381)
+++ source 2014-01-07 22:18:20 UTC (rev 8382)
@@ -48575,7 +48575,8 @@
<dd>
- <p>Returns the <span data-x="concept-fe-value">value</span> of the first selected item, if any,
+<!--CLEANUP-->
+ <p>Returns the <span data-x="concept-option-value">value</span> of the first selected item, if any,
or the empty string if there is no selected item.</p>
<p>Can be set, to change the selection.</p>
@@ -50971,7 +50972,7 @@
<h5>A form control's value</h5>
- <p>Form controls have a <dfn data-x="concept-fe-value">value</dfn> and a <dfn
+ <p>Most form controls have a <dfn data-x="concept-fe-value">value</dfn> and a <dfn
data-x="concept-fe-checked">checkedness</dfn>. (The latter is only used by <code>input</code>
elements.) These are used to describe how the user interacts with the control.</p>
@@ -50979,7 +50980,11 @@
element's <code data-x="attr-input-multiple">multiple</code> attribute, <code>input</code> elements
can also have separately defined <dfn data-x="concept-fe-values">value<em>s</em></dfn>.</p>
+ <p>The <code>select</code> element does not have a <span data-x="concept-fe-value">value</span>;
+ the <span data-x="concept-option-selectedness">selectedness</span> of its <code>option</code>
+ elements is what is used instead.</p>
+
<h5>Mutability</h5>
<p>A form control can be designated as <dfn data-x="concept-fe-mutable"><i>mutable</i></dfn>.</p>
@@ -50988,6 +50993,7 @@
that rely on whether an element is so designated) whether or not the user can modify the <span
data-x="concept-fe-value">value</span> or <span data-x="concept-fe-checked">checkedness</span> of a
form control, or whether or not a control can be automatically prefilled.</p>
+ <!-- or the concept-option-selectedness, or the concept-fe-values... -->
<h5>Association of controls and forms</h5>
@@ -52689,6 +52695,7 @@
<p>When an element's <span>autofill field name</span> is "<code
data-x="attr-fe-autocomplete-off">off</code>", the user agent should not remember the control's
<span data-x="concept-fe-value">value</span>, and should not offer past values to the user.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p class="note">In addition, when an element's <span>autofill field name</span> is "<code
data-x="attr-fe-autocomplete-off">off</code>", <a href="#history-autocomplete">values are reset</a>
@@ -52706,6 +52713,7 @@
<p>When an element's <span>autofill field name</span> is <em>not</em> "<code
data-x="attr-fe-autocomplete-off">off</code>", the user agent may store the control's <span
data-x="concept-fe-value">value</span>, and may offer previously stored values to the user.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p>When the <span>autofill field name</span> is "<code data-x="attr-fe-autocomplete-on">on</code>",
the user agent should attempt to use heuristics to determine the most appropriate values to offer
@@ -52756,6 +52764,7 @@
been inserted into the document, or when the user agent <span data-x="stop parsing">stops
parsing</span>). User agents must only prefill controls using values that the user could have
entered.</p>
+ <!-- XXX for select concept-option-selectedness -->
<p class="example">For example, if a <code>select</code> element only has <code>option</code>
elements with values "Steve" and "Rebecca", "Jay", and "Bob", and has an <span>autofill field
@@ -53301,11 +53310,13 @@
<dd> <p>When a control has no <span data-x="concept-fe-value">value</span> but has a <code
data-x="">required</code> attribute (<code>input</code> <code
- data-x="attr-input-required">required</code>, <code>select</code> <code
- data-x="attr-select-required">required</code>, <code>textarea</code> <code
- data-x="attr-textarea-required">required</code>), or, in the case of an element in a <i>radio
+ data-x="attr-input-required">required</code>, <code>textarea</code> <code
+ data-x="attr-textarea-required">required</code>); or, in the case of an element in a <i>radio
button group</i>, any of the other elements in the group has a <code
- data-x="attr-input-required">required</code> attribute. </p></dd>
+ data-x="attr-input-required">required</code> attribute; or, for <code>select</code> elements,
+ none of the <code>option</code> elements have their <span
+ data-x="concept-option-selectedness">selectedness</span> set (<code>select</code> <code
+ data-x="attr-select-required">required</code>).</p></dd>
<dt> <dfn>Suffering from a type mismatch</dfn> </dt>
More information about the Commit-Watchers
mailing list