Skip to content

Commit

Permalink
[e] (0) Moving some stuff around and changing section titles in the f…
Browse files Browse the repository at this point in the history
…orm control section to make the spec easier to read.

Affected topics: HTML

git-svn-id: http://svn.whatwg.org/webapps@7207 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Jul 26, 2012
1 parent 3245e26 commit 65d1859
Show file tree
Hide file tree
Showing 3 changed files with 104 additions and 91 deletions.
71 changes: 38 additions & 33 deletions complete.html
Original file line number Diff line number Diff line change
Expand Up @@ -726,17 +726,19 @@ <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 26 July 2012</h2>
<li><a href=#the-output-element><span class=secno>4.10.15 </span>The <code>output</code> element</a></li>
<li><a href=#the-progress-element><span class=secno>4.10.16 </span>The <code>progress</code> element</a></li>
<li><a href=#the-meter-element><span class=secno>4.10.17 </span>The <code>meter</code> element</a></li>
<li><a href=#association-of-controls-and-forms><span class=secno>4.10.18 </span>Association of controls and forms</a></li>
<li><a href=#form-control-infrastructure><span class=secno>4.10.18 </span>Form control infrastructure</a>
<ol>
<li><a href="#a-form-control's-value"><span class=secno>4.10.18.1 </span>A form control's value</a></li>
<li><a href=#association-of-controls-and-forms><span class=secno>4.10.18.2 </span>Association of controls and forms</a></ol></li>
<li><a href=#attributes-common-to-form-controls><span class=secno>4.10.19 </span>Attributes common to form controls</a>
<ol>
<li><a href=#naming-form-controls><span class=secno>4.10.19.1 </span>Naming form controls</a></li>
<li><a href=#enabling-and-disabling-form-controls><span class=secno>4.10.19.2 </span>Enabling and disabling form controls</a></li>
<li><a href="#a-form-control's-value"><span class=secno>4.10.19.3 </span>A form control's value</a></li>
<li><a href=#autofocusing-a-form-control><span class=secno>4.10.19.4 </span>Autofocusing a form control</a></li>
<li><a href=#limiting-user-input-length><span class=secno>4.10.19.5 </span>Limiting user input length</a></li>
<li><a href=#form-submission-0><span class=secno>4.10.19.6 </span>Form submission</a></li>
<li><a href=#submitting-element-directionality><span class=secno>4.10.19.7 </span>Submitting element directionality</a></li>
<li><a href=#input-modalities><span class=secno>4.10.19.8 </span>Input modalities</a></ol></li>
<li><a href=#naming-form-controls:-the-name-attribute><span class=secno>4.10.19.1 </span>Naming form controls: the <code title=attr-fe-name>name</code> attribute</a></li>
<li><a href=#enabling-and-disabling-form-controls:-the-disabled-attribute><span class=secno>4.10.19.2 </span>Enabling and disabling form controls: the <code title=attr-fe-disabled>disabled</code> attribute</a></li>
<li><a href=#autofocusing-a-form-control:-the-autofocus-attribute><span class=secno>4.10.19.3 </span>Autofocusing a form control: the <code title=attr-fe-autofocus>autofocus</code> attribute</a></li>
<li><a href=#limiting-user-input-length:-the-maxlength-attribute><span class=secno>4.10.19.4 </span>Limiting user input length: the <code title=attr-fe-maxlength>maxlength</code> attribute</a></li>
<li><a href=#form-submission-0><span class=secno>4.10.19.5 </span>Form submission</a></li>
<li><a href=#submitting-element-directionality:-the-dirname-attribute><span class=secno>4.10.19.6 </span>Submitting element directionality: the <code title="form control dirname attribute">dirname</code> attribute</a></li>
<li><a href=#input-modalities:-the-inputmode-attribute><span class=secno>4.10.19.7 </span>Input modalities: the <code title=attr-inputmode>inputmode</code> attribute</a></ol></li>
<li><a href=#textFieldSelection><span class=secno>4.10.20 </span>APIs for the text field selections</a></li>
<li><a href=#constraints><span class=secno>4.10.21 </span>Constraints</a>
<ol>
Expand Down Expand Up @@ -54236,8 +54238,25 @@ <h4 id=the-meter-element><span class=secno>4.10.17 </span>The <dfn><code>meter</



<h4 id=form-control-infrastructure><span class=secno>4.10.18 </span>Form control infrastructure</h4>

<div class=impl>

<h4 id=association-of-controls-and-forms><span class=secno>4.10.18 </span>Association of controls and forms</h4>
<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> 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>

</div>


<h5 id=association-of-controls-and-forms><span class=secno>4.10.18.2 </span>Association of controls and forms</h5>

<p>A <a href=#form-associated-element>form-associated element</a> can have a relationship
with a <code><a href=#the-form-element>form</a></code> element, which is called the element's
Expand Down Expand Up @@ -54403,7 +54422,7 @@ <h4 id=association-of-controls-and-forms><span class=secno>4.10.18 </span>Associ

<h4 id=attributes-common-to-form-controls><span class=secno>4.10.19 </span><dfn>Attributes common to form controls</dfn></h4>

<h5 id=naming-form-controls><span class=secno>4.10.19.1 </span>Naming form controls</h5>
<h5 id=naming-form-controls:-the-name-attribute><span class=secno>4.10.19.1 </span>Naming form controls: the <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attribute</h5>

<p>The <dfn id=attr-fe-name title=attr-fe-name><code>name</code></dfn> content
attribute gives the name of the form control, as used in <a href=#form-submission>form
Expand Down Expand Up @@ -54436,7 +54455,7 @@ <h5 id=naming-form-controls><span class=secno>4.10.19.1 </span>Naming form contr
</div>


<h5 id=enabling-and-disabling-form-controls><span class=secno>4.10.19.2 </span>Enabling and disabling form controls</h5>
<h5 id=enabling-and-disabling-form-controls:-the-disabled-attribute><span class=secno>4.10.19.2 </span>Enabling and disabling form controls: the <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute</h5>

<p>The <dfn id=attr-fe-disabled title=attr-fe-disabled><code>disabled</code></dfn>
content attribute is a <a href=#boolean-attribute>boolean attribute</a>.</p>
Expand Down Expand Up @@ -54464,23 +54483,7 @@ <h5 id=enabling-and-disabling-form-controls><span class=secno>4.10.19.2 </span>E
</div>


<div class=impl>

<h5 id="a-form-control's-value"><span class=secno>4.10.19.3 </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> 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>

</div>


<h5 id=autofocusing-a-form-control><span class=secno>4.10.19.4 </span>Autofocusing a form control</h5>
<h5 id=autofocusing-a-form-control:-the-autofocus-attribute><span class=secno>4.10.19.3 </span>Autofocusing a form control: the <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code> attribute</h5>

<!-- v2: Apply this to contentEditable elements -->

Expand Down Expand Up @@ -54564,7 +54567,7 @@ <h5 id=autofocusing-a-form-control><span class=secno>4.10.19.4 </span>Autofocusi
</div>


<h5 id=limiting-user-input-length><span class=secno>4.10.19.5 </span>Limiting user input length</h5>
<h5 id=limiting-user-input-length:-the-maxlength-attribute><span class=secno>4.10.19.4 </span>Limiting user input length: the <code title=attr-fe-maxlength><a href=#attr-fe-maxlength>maxlength</a></code> attribute</h5>

<p>A <dfn id=attr-fe-maxlength title=attr-fe-maxlength>form control <code title="">maxlength</code> attribute</dfn>, controlled by a <var title="">dirty value flag</var>, declares a limit on the number of
characters a user can input.</p>
Expand Down Expand Up @@ -54597,7 +54600,7 @@ <h5 id=limiting-user-input-length><span class=secno>4.10.19.5 </span>Limiting us



<h5 id=form-submission-0><span class=secno>4.10.19.6 </span>Form submission</h5>
<h5 id=form-submission-0><span class=secno>4.10.19.5 </span>Form submission</h5>

<p><dfn id=attributes-for-form-submission>Attributes for form submission</dfn> can be specified both
on <code><a href=#the-form-element>form</a></code> elements and on <a href=#concept-submit-button title=concept-submit-button>submit buttons</a> (elements that
Expand Down Expand Up @@ -54756,7 +54759,7 @@ <h5 id=form-submission-0><span class=secno>4.10.19.6 </span>Form submission</h5>
</div>


<h5 id=submitting-element-directionality><span class=secno>4.10.19.7 </span>Submitting element directionality</h5>
<h5 id=submitting-element-directionality:-the-dirname-attribute><span class=secno>4.10.19.6 </span>Submitting element directionality: the <code title="form control dirname attribute"><a href=#form-control-dirname-attribute>dirname</a></code> attribute</h5>

<p>A <dfn id=form-control-dirname-attribute>form control <code title="">dirname</code> attribute</dfn>
on a form control element enables the submission of <a href=#the-directionality>the
Expand All @@ -54767,7 +54770,9 @@ <h5 id=submitting-element-directionality><span class=secno>4.10.19.7 </span>Subm



<h5 id=input-modalities><span class=secno>4.10.19.8 </span>Input modalities</h5>
<h5 id=input-modalities:-the-inputmode-attribute><span class=secno>4.10.19.7 </span>Input modalities: the <code title=attr-inputmode><a href=#attr-inputmode>inputmode</a></code> attribute</h5>

<!-- v2: Apply this to contentEditable elements -->

<p>A <dfn id=attr-inputmode title=attr-inputmode>form control <code title="">inputmode</code> attribute</dfn> on a form control element
is an <a href=#enumerated-attribute>enumerated attribute</a> that specifies what kind of
Expand Down
Loading

0 comments on commit 65d1859

Please sign in to comment.