- From: poot <cvsmail@w3.org>
- Date: Tue, 15 Sep 2009 20:15:25 +0900 (JST)
- To: public-html-diffs@w3.org
hixie: Move <div> and <legend> to more appropriate spots. (whatwg r3861)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3026&r2=1.3027&f=h
http://html5.org/tools/web-apps-tracker?from=3860&to=3861
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3026
retrieving revision 1.3027
diff -u -d -r1.3026 -r1.3027
--- Overview.html 15 Sep 2009 11:12:55 -0000 1.3026
+++ Overview.html 15 Sep 2009 11:14:58 -0000 1.3027
@@ -527,7 +527,8 @@
<li><a href="#the-li-element"><span class="secno">4.5.8 </span>The <code>li</code> element</a></li>
<li><a href="#the-dl-element"><span class="secno">4.5.9 </span>The <code>dl</code> element</a></li>
<li><a href="#the-dt-element"><span class="secno">4.5.10 </span>The <code>dt</code> element</a></li>
- <li><a href="#the-dd-element"><span class="secno">4.5.11 </span>The <code>dd</code> element</a></ol></li>
+ <li><a href="#the-dd-element"><span class="secno">4.5.11 </span>The <code>dd</code> element</a></li>
+ <li><a href="#the-div-element"><span class="secno">4.5.12 </span>The <code>div</code> element</a></ol></li>
<li><a href="#text-level-semantics"><span class="secno">4.6 </span>Text-level semantics</a>
<ol>
<li><a href="#the-a-element"><span class="secno">4.6.1 </span>The <code>a</code> element</a></li>
@@ -655,81 +656,82 @@
<ol>
<li><a href="#the-form-element"><span class="secno">4.10.1 </span>The <code>form</code> element</a></li>
<li><a href="#the-fieldset-element"><span class="secno">4.10.2 </span>The <code>fieldset</code> element</a></li>
- <li><a href="#the-label-element"><span class="secno">4.10.3 </span>The <code>label</code> element</a></li>
- <li><a href="#the-input-element"><span class="secno">4.10.4 </span>The <code>input</code> element</a>
+ <li><a href="#the-legend-element"><span class="secno">4.10.3 </span>The <code>legend</code> element</a></li>
+ <li><a href="#the-label-element"><span class="secno">4.10.4 </span>The <code>label</code> element</a></li>
+ <li><a href="#the-input-element"><span class="secno">4.10.5 </span>The <code>input</code> element</a>
<ol>
- <li><a href="#states-of-the-type-attribute"><span class="secno">4.10.4.1 </span>States of the <code title="attr-input-type">type</code> attribute</a>
+ <li><a href="#states-of-the-type-attribute"><span class="secno">4.10.5.1 </span>States of the <code title="attr-input-type">type</code> attribute</a>
<ol>
- <li><a href="#hidden-state"><span class="secno">4.10.4.1.1 </span>Hidden state</a></li>
- <li><a href="#text-state-and-search-state"><span class="secno">4.10.4.1.2 </span>Text state and Search state</a></li>
- <li><a href="#telephone-state"><span class="secno">4.10.4.1.3 </span>Telephone state</a></li>
- <li><a href="#url-state"><span class="secno">4.10.4.1.4 </span>URL state</a></li>
- <li><a href="#e-mail-state"><span class="secno">4.10.4.1.5 </span>E-mail state</a></li>
- <li><a href="#password-state"><span class="secno">4.10.4.1.6 </span>Password state</a></li>
- <li><a href="#date-and-time-state"><span class="secno">4.10.4.1.7 </span>Date and Time state</a></li>
- <li><a href="#date-state"><span class="secno">4.10.4.1.8 </span>Date state</a></li>
- <li><a href="#month-state"><span class="secno">4.10.4.1.9 </span>Month state</a></li>
- <li><a href="#week-state"><span class="secno">4.10.4.1.10 </span>Week state</a></li>
- <li><a href="#time-state"><span class="secno">4.10.4.1.11 </span>Time state</a></li>
- <li><a href="#local-date-and-time-state"><span class="secno">4.10.4.1.12 </span>Local Date and Time state</a></li>
- <li><a href="#number-state"><span class="secno">4.10.4.1.13 </span>Number state</a></li>
- <li><a href="#range-state"><span class="secno">4.10.4.1.14 </span>Range state</a></li>
- <li><a href="#color-state"><span class="secno">4.10.4.1.15 </span>Color state</a></li>
- <li><a href="#checkbox-state"><span class="secno">4.10.4.1.16 </span>Checkbox state</a></li>
- <li><a href="#radio-button-state"><span class="secno">4.10.4.1.17 </span>Radio Button state</a></li>
- <li><a href="#file-upload-state"><span class="secno">4.10.4.1.18 </span>File Upload state</a></li>
- <li><a href="#submit-button-state"><span class="secno">4.10.4.1.19 </span>Submit Button state</a></li>
- <li><a href="#image-button-state"><span class="secno">4.10.4.1.20 </span>Image Button state</a></li>
- <li><a href="#reset-button-state"><span class="secno">4.10.4.1.21 </span>Reset Button state</a></li>
- <li><a href="#button-state"><span class="secno">4.10.4.1.22 </span>Button state</a></ol></li>
- <li><a href="#common-input-element-attributes"><span class="secno">4.10.4.2 </span>Common <code>input</code> element attributes</a>
+ <li><a href="#hidden-state"><span class="secno">4.10.5.1.1 </span>Hidden state</a></li>
+ <li><a href="#text-state-and-search-state"><span class="secno">4.10.5.1.2 </span>Text state and Search state</a></li>
+ <li><a href="#telephone-state"><span class="secno">4.10.5.1.3 </span>Telephone state</a></li>
+ <li><a href="#url-state"><span class="secno">4.10.5.1.4 </span>URL state</a></li>
+ <li><a href="#e-mail-state"><span class="secno">4.10.5.1.5 </span>E-mail state</a></li>
+ <li><a href="#password-state"><span class="secno">4.10.5.1.6 </span>Password state</a></li>
+ <li><a href="#date-and-time-state"><span class="secno">4.10.5.1.7 </span>Date and Time state</a></li>
+ <li><a href="#date-state"><span class="secno">4.10.5.1.8 </span>Date state</a></li>
+ <li><a href="#month-state"><span class="secno">4.10.5.1.9 </span>Month state</a></li>
+ <li><a href="#week-state"><span class="secno">4.10.5.1.10 </span>Week state</a></li>
+ <li><a href="#time-state"><span class="secno">4.10.5.1.11 </span>Time state</a></li>
+ <li><a href="#local-date-and-time-state"><span class="secno">4.10.5.1.12 </span>Local Date and Time state</a></li>
+ <li><a href="#number-state"><span class="secno">4.10.5.1.13 </span>Number state</a></li>
+ <li><a href="#range-state"><span class="secno">4.10.5.1.14 </span>Range state</a></li>
+ <li><a href="#color-state"><span class="secno">4.10.5.1.15 </span>Color state</a></li>
+ <li><a href="#checkbox-state"><span class="secno">4.10.5.1.16 </span>Checkbox state</a></li>
+ <li><a href="#radio-button-state"><span class="secno">4.10.5.1.17 </span>Radio Button state</a></li>
+ <li><a href="#file-upload-state"><span class="secno">4.10.5.1.18 </span>File Upload state</a></li>
+ <li><a href="#submit-button-state"><span class="secno">4.10.5.1.19 </span>Submit Button state</a></li>
+ <li><a href="#image-button-state"><span class="secno">4.10.5.1.20 </span>Image Button state</a></li>
+ <li><a href="#reset-button-state"><span class="secno">4.10.5.1.21 </span>Reset Button state</a></li>
+ <li><a href="#button-state"><span class="secno">4.10.5.1.22 </span>Button state</a></ol></li>
+ <li><a href="#common-input-element-attributes"><span class="secno">4.10.5.2 </span>Common <code>input</code> element attributes</a>
<ol>
- <li><a href="#the-autocomplete-attribute"><span class="secno">4.10.4.2.1 </span>The <code title="attr-input-autocomplete">autocomplete</code> attribute</a></li>
- <li><a href="#the-list-attribute"><span class="secno">4.10.4.2.2 </span>The <code title="attr-input-list">list</code> attribute</a></li>
- <li><a href="#the-readonly-attribute"><span class="secno">4.10.4.2.3 </span>The <code title="attr-input-readonly">readonly</code> attribute</a></li>
- <li><a href="#the-size-attribute"><span class="secno">4.10.4.2.4 </span>The <code title="attr-input-size">size</code> attribute</a></li>
- <li><a href="#the-required-attribute"><span class="secno">4.10.4.2.5 </span>The <code title="attr-input-required">required</code> attribute</a></li>
- <li><a href="#the-multiple-attribute"><span class="secno">4.10.4.2.6 </span>The <code title="attr-input-multiple">multiple</code> attribute</a></li>
- <li><a href="#the-maxlength-attribute"><span class="secno">4.10.4.2.7 </span>The <code title="attr-input-maxlength">maxlength</code> attribute</a></li>
- <li><a href="#the-pattern-attribute"><span class="secno">4.10.4.2.8 </span>The <code title="attr-input-pattern">pattern</code> attribute</a></li>
- <li><a href="#the-min-and-max-attributes"><span class="secno">4.10.4.2.9 </span>The <code title="attr-input-min">min</code> and <code title="attr-input-max">max</code> attributes</a></li>
- <li><a href="#the-step-attribute"><span class="secno">4.10.4.2.10 </span>The <code title="attr-input-step">step</code> attribute</a></li>
- <li><a href="#the-placeholder-attribute"><span class="secno">4.10.4.2.11 </span>The <code title="attr-input-placeholder">placeholder</code> attribute</a></ol></li>
- <li><a href="#common-input-element-apis"><span class="secno">4.10.4.3 </span>Common <code>input</code> element APIs</a></li>
- <li><a href="#common-event-behaviors"><span class="secno">4.10.4.4 </span>Common event behaviors</a></ol></li>
- <li><a href="#the-button-element"><span class="secno">4.10.5 </span>The <code>button</code> element</a></li>
- <li><a href="#the-select-element"><span class="secno">4.10.6 </span>The <code>select</code> element</a></li>
- <li><a href="#the-datalist-element"><span class="secno">4.10.7 </span>The <code>datalist</code> element</a></li>
- <li><a href="#the-optgroup-element"><span class="secno">4.10.8 </span>The <code>optgroup</code> element</a></li>
- <li><a href="#the-option-element"><span class="secno">4.10.9 </span>The <code>option</code> element</a></li>
- <li><a href="#the-textarea-element"><span class="secno">4.10.10 </span>The <code>textarea</code> element</a></li>
- <li><a href="#the-keygen-element"><span class="secno">4.10.11 </span>The <code>keygen</code> element</a></li>
- <li><a href="#the-output-element"><span class="secno">4.10.12 </span>The <code>output</code> element</a></li>
- <li><a href="#association-of-controls-and-forms"><span class="secno">4.10.13 </span>Association of controls and forms</a></li>
- <li><a href="#attributes-common-to-form-controls"><span class="secno">4.10.14 </span>Attributes common to form controls</a>
+ <li><a href="#the-autocomplete-attribute"><span class="secno">4.10.5.2.1 </span>The <code title="attr-input-autocomplete">autocomplete</code> attribute</a></li>
+ <li><a href="#the-list-attribute"><span class="secno">4.10.5.2.2 </span>The <code title="attr-input-list">list</code> attribute</a></li>
+ <li><a href="#the-readonly-attribute"><span class="secno">4.10.5.2.3 </span>The <code title="attr-input-readonly">readonly</code> attribute</a></li>
+ <li><a href="#the-size-attribute"><span class="secno">4.10.5.2.4 </span>The <code title="attr-input-size">size</code> attribute</a></li>
+ <li><a href="#the-required-attribute"><span class="secno">4.10.5.2.5 </span>The <code title="attr-input-required">required</code> attribute</a></li>
+ <li><a href="#the-multiple-attribute"><span class="secno">4.10.5.2.6 </span>The <code title="attr-input-multiple">multiple</code> attribute</a></li>
+ <li><a href="#the-maxlength-attribute"><span class="secno">4.10.5.2.7 </span>The <code title="attr-input-maxlength">maxlength</code> attribute</a></li>
+ <li><a href="#the-pattern-attribute"><span class="secno">4.10.5.2.8 </span>The <code title="attr-input-pattern">pattern</code> attribute</a></li>
+ <li><a href="#the-min-and-max-attributes"><span class="secno">4.10.5.2.9 </span>The <code title="attr-input-min">min</code> and <code title="attr-input-max">max</code> attributes</a></li>
+ <li><a href="#the-step-attribute"><span class="secno">4.10.5.2.10 </span>The <code title="attr-input-step">step</code> attribute</a></li>
+ <li><a href="#the-placeholder-attribute"><span class="secno">4.10.5.2.11 </span>The <code title="attr-input-placeholder">placeholder</code> attribute</a></ol></li>
+ <li><a href="#common-input-element-apis"><span class="secno">4.10.5.3 </span>Common <code>input</code> element APIs</a></li>
+ <li><a href="#common-event-behaviors"><span class="secno">4.10.5.4 </span>Common event behaviors</a></ol></li>
+ <li><a href="#the-button-element"><span class="secno">4.10.6 </span>The <code>button</code> element</a></li>
+ <li><a href="#the-select-element"><span class="secno">4.10.7 </span>The <code>select</code> element</a></li>
+ <li><a href="#the-datalist-element"><span class="secno">4.10.8 </span>The <code>datalist</code> element</a></li>
+ <li><a href="#the-optgroup-element"><span class="secno">4.10.9 </span>The <code>optgroup</code> element</a></li>
+ <li><a href="#the-option-element"><span class="secno">4.10.10 </span>The <code>option</code> element</a></li>
+ <li><a href="#the-textarea-element"><span class="secno">4.10.11 </span>The <code>textarea</code> element</a></li>
+ <li><a href="#the-keygen-element"><span class="secno">4.10.12 </span>The <code>keygen</code> element</a></li>
+ <li><a href="#the-output-element"><span class="secno">4.10.13 </span>The <code>output</code> element</a></li>
+ <li><a href="#association-of-controls-and-forms"><span class="secno">4.10.14 </span>Association of controls and forms</a></li>
+ <li><a href="#attributes-common-to-form-controls"><span class="secno">4.10.15 </span>Attributes common to form controls</a>
<ol>
- <li><a href="#naming-form-controls"><span class="secno">4.10.14.1 </span>Naming form controls</a></li>
- <li><a href="#enabling-and-disabling-form-controls"><span class="secno">4.10.14.2 </span>Enabling and disabling form controls</a></li>
- <li><a href="#a-form-control-s-value"><span class="secno">4.10.14.3 </span>A form control's value</a></li>
- <li><a href="#autofocusing-a-form-control"><span class="secno">4.10.14.4 </span>Autofocusing a form control</a></li>
- <li><a href="#limiting-user-input-length"><span class="secno">4.10.14.5 </span>Limiting user input length</a></li>
- <li><a href="#form-submission-0"><span class="secno">4.10.14.6 </span>Form submission</a></ol></li>
- <li><a href="#constraints"><span class="secno">4.10.15 </span>Constraints</a>
+ <li><a href="#naming-form-controls"><span class="secno">4.10.15.1 </span>Naming form controls</a></li>
+ <li><a href="#enabling-and-disabling-form-controls"><span class="secno">4.10.15.2 </span>Enabling and disabling form controls</a></li>
+ <li><a href="#a-form-control-s-value"><span class="secno">4.10.15.3 </span>A form control's value</a></li>
+ <li><a href="#autofocusing-a-form-control"><span class="secno">4.10.15.4 </span>Autofocusing a form control</a></li>
+ <li><a href="#limiting-user-input-length"><span class="secno">4.10.15.5 </span>Limiting user input length</a></li>
+ <li><a href="#form-submission-0"><span class="secno">4.10.15.6 </span>Form submission</a></ol></li>
+ <li><a href="#constraints"><span class="secno">4.10.16 </span>Constraints</a>
<ol>
- <li><a href="#definitions"><span class="secno">4.10.15.1 </span>Definitions</a></li>
- <li><a href="#constraint-validation"><span class="secno">4.10.15.2 </span>Constraint validation</a></li>
- <li><a href="#the-constraint-validation-api"><span class="secno">4.10.15.3 </span>The constraint validation API</a></li>
- <li><a href="#security-0"><span class="secno">4.10.15.4 </span>Security</a></ol></li>
- <li><a href="#form-submission"><span class="secno">4.10.16 </span>Form submission</a>
+ <li><a href="#definitions"><span class="secno">4.10.16.1 </span>Definitions</a></li>
+ <li><a href="#constraint-validation"><span class="secno">4.10.16.2 </span>Constraint validation</a></li>
+ <li><a href="#the-constraint-validation-api"><span class="secno">4.10.16.3 </span>The constraint validation API</a></li>
+ <li><a href="#security-0"><span class="secno">4.10.16.4 </span>Security</a></ol></li>
+ <li><a href="#form-submission"><span class="secno">4.10.17 </span>Form submission</a>
<ol>
- <li><a href="#introduction-0"><span class="secno">4.10.16.1 </span>Introduction</a></li>
- <li><a href="#implicit-submission"><span class="secno">4.10.16.2 </span>Implicit submission</a></li>
- <li><a href="#form-submission-algorithm"><span class="secno">4.10.16.3 </span>Form submission algorithm</a></li>
- <li><a href="#url-encoded-form-data"><span class="secno">4.10.16.4 </span>URL-encoded form data</a></li>
- <li><a href="#multipart-form-data"><span class="secno">4.10.16.5 </span>Multipart form data</a></li>
- <li><a href="#plain-text-form-data"><span class="secno">4.10.16.6 </span>Plain text form data</a></ol></li>
- <li><a href="#resetting-a-form"><span class="secno">4.10.17 </span>Resetting a form</a></li>
- <li><a href="#event-dispatch"><span class="secno">4.10.18 </span>Event dispatch</a></ol></li>
+ <li><a href="#introduction-0"><span class="secno">4.10.17.1 </span>Introduction</a></li>
+ <li><a href="#implicit-submission"><span class="secno">4.10.17.2 </span>Implicit submission</a></li>
+ <li><a href="#form-submission-algorithm"><span class="secno">4.10.17.3 </span>Form submission algorithm</a></li>
+ <li><a href="#url-encoded-form-data"><span class="secno">4.10.17.4 </span>URL-encoded form data</a></li>
+ <li><a href="#multipart-form-data"><span class="secno">4.10.17.5 </span>Multipart form data</a></li>
+ <li><a href="#plain-text-form-data"><span class="secno">4.10.17.6 </span>Plain text form data</a></ol></li>
+ <li><a href="#resetting-a-form"><span class="secno">4.10.18 </span>Resetting a form</a></li>
+ <li><a href="#event-dispatch"><span class="secno">4.10.19 </span>Event dispatch</a></ol></li>
<li><a href="#interactive-elements"><span class="secno">4.11 </span>Interactive elements</a>
<ol>
<li><a href="#the-details-element"><span class="secno">4.11.1 </span>The <code>details</code> element</a></li>
@@ -751,16 +753,12 @@
<li><a href="#using-the-accesskey-attribute-on-a-label-element-to-define-a-command"><span class="secno">4.11.4.6 </span>Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>label</code> element to define a command</a></li>
<li><a href="#using-the-accesskey-attribute-on-a-legend-element-to-define-a-command"><span class="secno">4.11.4.7 </span>Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>legend</code> element to define a command</a></li>
<li><a href="#using-the-accesskey-attribute-to-define-a-command-on-other-elements"><span class="secno">4.11.4.8 </span>Using the <code title="attr-accesskey">accesskey</code> attribute to define a command on other elements</a></ol></ol></li>
- <li><a href="#miscellaneous-elements"><span class="secno">4.12 </span>Miscellaneous elements</a>
- <ol>
- <li><a href="#the-legend-element"><span class="secno">4.12.1 </span>The <code>legend</code> element</a></li>
- <li><a href="#the-div-element"><span class="secno">4.12.2 </span>The <code>div</code> element</a></ol></li>
- <li><a href="#common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</a>
+ <li><a href="#common-idioms-without-dedicated-elements"><span class="secno">4.12 </span>Common idioms without dedicated elements</a>
<ol>
- <li><a href="#tag-clouds"><span class="secno">4.13.1 </span>Tag clouds</a></li>
- <li><a href="#conversations"><span class="secno">4.13.2 </span>Conversations</a></li>
- <li><a href="#footnotes"><span class="secno">4.13.3 </span>Footnotes</a></ol></li>
- <li><a href="#matching-html-elements-using-selectors"><span class="secno">4.14 </span>Matching HTML elements using selectors</a></ol></li>
+ <li><a href="#tag-clouds"><span class="secno">4.12.1 </span>Tag clouds</a></li>
+ <li><a href="#conversations"><span class="secno">4.12.2 </span>Conversations</a></li>
+ <li><a href="#footnotes"><span class="secno">4.12.3 </span>Footnotes</a></ol></li>
+ <li><a href="#matching-html-elements-using-selectors"><span class="secno">4.13 </span>Matching HTML elements using selectors</a></ol></li>
<li><a href="#microdata"><span class="secno">5 </span>Microdata</a>
<ol>
<li><a href="#introduction-1"><span class="secno">5.1 </span>Introduction</a>
@@ -13200,6 +13198,56 @@
<dd><i class="part-of-speech"><abbr>v.intr.</abbr></i> To be delighted oneself.</dd>
<dd><i class="part-of-speech"><abbr>v.tr.</abbr></i> To cause one to be delighted.</dd>
</dl></pre>
+ </div><h4 id="the-div-element"><span class="secno">4.5.12 </span>The <dfn><code>div</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i><dl class="element"><dt>Categories</dt>
+ <dd><a href="#flow-content">Flow content</a>.</dd>
+ <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
+ <dt>Contexts in which this element may be used:</dt>
+ <dd>Where <a href="#flow-content">flow content</a> is expected.</dd>
+ <dt>Content model:</dt>
+ <dd><a href="#flow-content">Flow content</a>.</dd>
+ <dt>Content attributes:</dt>
+ <dd><a href="#global-attributes">Global attributes</a></dd>
+ <dt>DOM interface:</dt>
+ <dd>
+ <pre class="idl">interface <dfn id="htmldivelement">HTMLDivElement</dfn> : <a href="#htmlelement">HTMLElement</a> {};</pre>
+ </dd>
+ </dl><p>The <code><a href="#the-div-element">div</a></code> element has no special meaning at all. It
+ <a href="#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#attr-lang">lang</a></code>, and <code title="attr-title"><a href="#the-title-attribute">title</a></code> attributes to mark up semantics
+ common to a group of consecutive elements.<p class="note">Authors are strongly encouraged to view the
+ <code><a href="#the-div-element">div</a></code> element as an element of last resort, for when no
+ other element is suitable. Use of the <code><a href="#the-div-element">div</a></code> element
+ instead of more appropriate elements leads to poor accessibility for
+ readers and poor maintainability for authors.<div class="example">
+
+ <p>For example, a blog post would be marked up using
+ <code><a href="#the-article-element">article</a></code>, a chapter using <code><a href="#the-section-element">section</a></code>, a
+ page's navigation aids using <code><a href="#the-nav-element">nav</a></code>, and a group of form
+ controls using <code><a href="#the-fieldset-element">fieldset</a></code>.</p>
+
+ <p>On the other hand, <code><a href="#the-div-element">div</a></code> elements can be useful for
+ stylistic purposes or to wrap multiple paragraphs within a section
+ that are all to be annotated in a similar way. In the following
+ example, we see <code><a href="#the-div-element">div</a></code> elements used as a way to set the
+ language of two paragraphs at once, instead of setting the language
+ on the two paragraph elements separately:</p>
+
+ <pre><article lang="en-US">
+ <h1>My use of language and my cats</h1>
+ <p>My cat's behavior hasn't changed much since her absence, except
+ that she plays her new physique to the neighbors regularly, in an
+ attempt to get pets.</p>
+ <div lang="en-GB">
+ <p>My other cat, coloured black and white, is a sweetie. He followed
+ us to the pool today, walking down the pavement with us. Yesterday
+ he apparently visited our neighbours. I wonder if he recognises that
+ their flat is a mirror image of ours.</p>
+ <p>Hm, I just noticed that in the last paragraph I used British
+ English. But I'm supposed to write in American English. So I
+ shouldn't say "pavement" or "flat" or "colour"...</p>
+ </div>
+ <p>I should say "sidewalk" and "apartment" and "color"!</p>
+</article></pre>
+
</div><h3 id="text-level-semantics"><span class="secno">4.6 </span>Text-level semantics</h3><h4 id="the-a-element"><span class="secno">4.6.1 </span>The <dfn><code>a</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd>When the element only contains <a href="#phrasing-content">phrasing content</a>: <a href="#phrasing-content">phrasing content</a>.</dd>
@@ -27137,7 +27185,43 @@
<p><label>Expiry date: <input name=clubexp type=month></label></p>
</fieldset></pre>
- </div><h4 id="the-label-element"><span class="secno">4.10.3 </span>The <dfn><code>label</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-legend-element"><span class="secno">4.10.3 </span>The <dfn><code>legend</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
+ <dd>None.</dd>
+ <dt>Contexts in which this element may be used:</dt>
+ <dd>As the first child of a <code><a href="#the-fieldset-element">fieldset</a></code> element.</dd>
+ <dt>Content model:</dt>
+ <dd><a href="#phrasing-content">Phrasing content</a>.</dd>
+ <dt>Content attributes:</dt>
+ <dd><a href="#global-attributes">Global attributes</a></dd>
+ <dt>DOM interface:</dt>
+ <dd>
+ <pre class="idl">interface <dfn id="htmllegendelement">HTMLLegendElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#dom-legend-form" title="dom-legend-form">form</a>;
+};</pre>
+ </dd>
+ </dl><p>The <code><a href="#the-legend-element">legend</a></code> element <a href="#represents">represents</a> a caption
+ for the rest of the contents of the <code><a href="#the-legend-element">legend</a></code> element's
+ parent <code><a href="#the-fieldset-element">fieldset</a></code> element<span class="impl">, if
+ any</span>.<dl class="domintro"><dt><var title="">legend</var> . <code title="dom-legend-form"><a href="#dom-legend-form">form</a></code></dt>
+
+ <dd>
+
+ <p>Returns the element's <code><a href="#the-form-element">form</a></code> element, if any, or
+ null otherwise.</p>
+
+ </dd>
+
+ </dl><div class="impl">
+
+ <p>The <dfn id="dom-legend-form" title="dom-legend-form"><code>form</code></dfn> IDL
+ attribute's behavior depends on whether the <code><a href="#the-legend-element">legend</a></code>
+ element is in a <code><a href="#the-fieldset-element">fieldset</a></code> element or not. If the
+ <code><a href="#the-legend-element">legend</a></code> has a <code><a href="#the-fieldset-element">fieldset</a></code> element as its
+ parent, then the <code title="dom-legend-form"><a href="#dom-legend-form">form</a></code> IDL
+ 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-fieldset-element">fieldset</a></code> element. Otherwise, it must return null.</p>
+
+ </div><h4 id="the-label-element"><span class="secno">4.10.4 </span>The <dfn><code>label</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="#interactive-content">Interactive content</a>.</dd>
@@ -27256,7 +27340,7 @@
<p><label>Age: <input name=age type=number min=0></label></p>
<p><label>Post code: <input name=pc> <small>Format: AB12 3CD</small></label></p></pre>
- </div><h4 id="the-input-element"><span class="secno">4.10.4 </span>The <dfn><code>input</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Working draft</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-input-element"><span class="secno">4.10.5 </span>The <dfn><code>input</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Working draft</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd>If the <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is <em>not</em> in the <a href="#hidden-state" title="attr-input-type-hidden">Hidden</a> state: <a href="#interactive-content">Interactive content</a>.</dd>
@@ -28499,7 +28583,7 @@
and <code title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code>
methods and attributes expose the element's text selection.</p>
- </div><h5 id="states-of-the-type-attribute"><span class="secno">4.10.4.1 </span>States of the <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute</h5><h6 id="hidden-state"><span class="secno">4.10.4.1.1 </span><dfn title="attr-input-type-hidden">Hidden</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h5 id="states-of-the-type-attribute"><span class="secno">4.10.5.1 </span>States of the <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute</h5><h6 id="hidden-state"><span class="secno">4.10.5.1.1 </span><dfn title="attr-input-type-hidden">Hidden</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#hidden-state" title="attr-input-type-hidden">Hidden</a> state, the rules in
this section apply.</p>
@@ -28566,7 +28650,7 @@
<p>The <code class="no-backref" title="event-input-input"><a href="#event-input-input">input</a></code> and <code class="no-backref" title="event-input-change"><a href="#event-input-change">change</a></code> events do not apply.</p>
- </div><h6 id="text-state-and-search-state"><span class="secno">4.10.4.1.2 </span><dfn title="attr-input-type-text">Text</dfn> state and <dfn title="attr-input-type-search">Search</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 idea: applying input masks to <input>, e.g. for entering
+ </div><h6 id="text-state-and-search-state"><span class="secno">4.10.5.1.2 </span><dfn title="attr-input-type-text">Text</dfn> state and <dfn title="attr-input-type-search">Search</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 idea: applying input masks to <input>, e.g. for entering
data with slashes and dashes (ack Greg Kilwein)
--><div class="impl">
@@ -28644,7 +28728,7 @@
<code class="no-backref" title="dom-input-stepDown"><a href="#dom-input-stepdown">stepDown()</a></code> and
<code class="no-backref" title="dom-input-stepUp"><a href="#dom-input-stepup">stepUp()</a></code> methods.</p>
- </div><h6 id="telephone-state"><span class="secno">4.10.4.1.3 </span><dfn title="attr-input-type-tel">Telephone</dfn> state</h6><div class="impl">
+ </div><h6 id="telephone-state"><span class="secno">4.10.5.1.3 </span><dfn title="attr-input-type-tel">Telephone</dfn> state</h6><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#telephone-state" title="attr-input-type-tel">Telephone</a> state, the rules in
this section apply.</p>
@@ -28722,7 +28806,7 @@
<code class="no-backref" title="dom-input-stepDown"><a href="#dom-input-stepdown">stepDown()</a></code> and
<code class="no-backref" title="dom-input-stepUp"><a href="#dom-input-stepup">stepUp()</a></code> methods.</p>
- </div><h6 id="url-state"><span class="secno">4.10.4.1.4 </span><dfn title="attr-input-type-url">URL</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="url-state"><span class="secno">4.10.5.1.4 </span><dfn title="attr-input-type-url">URL</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#url-state" title="attr-input-type-url">URL</a> state, the rules in this
section apply.</p>
@@ -28807,7 +28891,7 @@
<code class="no-backref" title="dom-input-stepDown"><a href="#dom-input-stepdown">stepDown()</a></code> and
<code class="no-backref" title="dom-input-stepUp"><a href="#dom-input-stepup">stepUp()</a></code> methods.</p>
- </div><h6 id="e-mail-state"><span class="secno">4.10.4.1.5 </span><dfn title="attr-input-type-email">E-mail</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="e-mail-state"><span class="secno">4.10.5.1.5 </span><dfn title="attr-input-type-email">E-mail</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#e-mail-state" title="attr-input-type-email">E-mail</a> state, the rules in this
section apply.</p>
@@ -28916,7 +29000,7 @@
<code class="no-backref" title="dom-input-stepDown"><a href="#dom-input-stepdown">stepDown()</a></code> and
<code class="no-backref" title="dom-input-stepUp"><a href="#dom-input-stepup">stepUp()</a></code> methods.</p>
- </div><h6 id="password-state"><span class="secno">4.10.4.1.6 </span><dfn title="attr-input-type-password">Password</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="password-state"><span class="secno">4.10.5.1.6 </span><dfn title="attr-input-type-password">Password</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#password-state" title="attr-input-type-password">Password</a> state, the rules in
this section apply.</p>
@@ -28989,7 +29073,7 @@
<code class="no-backref" title="dom-input-stepDown"><a href="#dom-input-stepdown">stepDown()</a></code> and
<code class="no-backref" title="dom-input-stepUp"><a href="#dom-input-stepup">stepUp()</a></code> methods.</p>
- </div><h6 id="date-and-time-state"><span class="secno">4.10.4.1.7 </span><dfn title="attr-input-type-datetime">Date and Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="date-and-time-state"><span class="secno">4.10.5.1.7 </span><dfn title="attr-input-type-datetime">Date and Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#date-and-time-state" title="attr-input-type-datetime">Date and Time</a> state, the
rules in this section apply.</p>
@@ -29123,7 +29207,7 @@
<code class="no-backref" title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select()</a></code> and
<code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code> methods.</p>
- </div><h6 id="date-state"><span class="secno">4.10.4.1.8 </span><dfn title="attr-input-type-date">Date</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="date-state"><span class="secno">4.10.5.1.8 </span><dfn title="attr-input-type-date">Date</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#date-state" title="attr-input-type-date">Date</a> state, the rules in this
section apply.</p>
@@ -29249,7 +29333,7 @@
<code class="no-backref" title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select()</a></code> and
<code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code> methods.</p>
- </div><h6 id="month-state"><span class="secno">4.10.4.1.9 </span><dfn title="attr-input-type-month">Month</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="month-state"><span class="secno">4.10.5.1.9 </span><dfn title="attr-input-type-month">Month</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#month-state" title="attr-input-type-month">Month</a> state, the rules in this
section apply.</p>
@@ -29376,7 +29460,7 @@
<code class="no-backref" title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select()</a></code> and
<code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code> methods.</p>
- </div><h6 id="week-state"><span class="secno">4.10.4.1.10 </span><dfn title="attr-input-type-week">Week</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="week-state"><span class="secno">4.10.5.1.10 </span><dfn title="attr-input-type-week">Week</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#week-state" title="attr-input-type-week">Week</a> state, the rules in this
section apply.</p>
@@ -29503,7 +29587,7 @@
<code class="no-backref" title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select()</a></code> and
<code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code> methods.</p>
- </div><h6 id="time-state"><span class="secno">4.10.4.1.11 </span><dfn title="attr-input-type-time">Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="time-state"><span class="secno">4.10.5.1.11 </span><dfn title="attr-input-type-time">Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#time-state" title="attr-input-type-time">Time</a> state, the rules in this
section apply.</p>
@@ -29624,7 +29708,7 @@
<code class="no-backref" title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select()</a></code> and
<code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code> methods.</p>
- </div><h6 id="local-date-and-time-state"><span class="secno">4.10.4.1.12 </span><dfn title="attr-input-type-datetime-local">Local Date and Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="local-date-and-time-state"><span class="secno">4.10.5.1.12 </span><dfn title="attr-input-type-datetime-local">Local Date and Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#local-date-and-time-state" title="attr-input-type-datetime-local">Local Date and Time</a>
state, the rules in this section apply.</p>
@@ -29738,7 +29822,7 @@
<code class="no-backref" title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select()</a></code> and
<code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code> methods.</p>
- </div><h6 id="number-state"><span class="secno">4.10.4.1.13 </span><dfn title="attr-input-type-number">Number</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="number-state"><span class="secno">4.10.5.1.13 </span><dfn title="attr-input-type-number">Number</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#number-state" title="attr-input-type-number">Number</a> state, the rules in
this section apply.</p>
@@ -29846,7 +29930,7 @@
<code class="no-backref" title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select()</a></code> and
<code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code> methods.</p>
- </div><h6 id="range-state"><span class="secno">4.10.4.1.14 </span><dfn title="attr-input-type-range">Range</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="range-state"><span class="secno">4.10.5.1.14 </span><dfn title="attr-input-type-range">Range</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#range-state" title="attr-input-type-range">Range</a> state, the rules in this
section apply.</p>
@@ -29981,7 +30065,7 @@
<code class="no-backref" title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select()</a></code> and
<code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code> methods.</p>
- </div><h6 id="color-state"><span class="secno">4.10.4.1.15 </span><dfn title="attr-input-type-color">Color</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Working draft</i><div class="impl">
+ </div><h6 id="color-state"><span class="secno">4.10.5.1.15 </span><dfn title="attr-input-type-color">Color</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Working draft</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#color-state" title="attr-input-type-color">Color</a> state, the rules in this
section apply.</p>
@@ -30067,7 +30151,7 @@
<code class="no-backref" title="dom-input-stepDown"><a href="#dom-input-stepdown">stepDown()</a></code>, and
<code class="no-backref" title="dom-input-stepUp"><a href="#dom-input-stepup">stepUp()</a></code> methods.</p>
- </div><h6 id="checkbox-state"><span class="secno">4.10.4.1.16 </span><dfn title="attr-input-type-checkbox">Checkbox</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="checkbox-state"><span class="secno">4.10.5.1.16 </span><dfn title="attr-input-type-checkbox">Checkbox</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#checkbox-state" title="attr-input-type-checkbox">Checkbox</a> state, the rules in
this section apply.</p>
@@ -30164,7 +30248,7 @@
<p>The <code class="no-backref" title="event-input-input"><a href="#event-input-input">input</a></code> event does not apply.</p>
- </div><h6 id="radio-button-state"><span class="secno">4.10.4.1.17 </span><dfn title="attr-input-type-radio">Radio Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="radio-button-state"><span class="secno">4.10.5.1.17 </span><dfn title="attr-input-type-radio">Radio Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#radio-button-state" title="attr-input-type-radio">Radio Button</a> state, the rules
in this section apply.</p>
@@ -30281,7 +30365,7 @@
<p>The <code class="no-backref" title="event-input-input"><a href="#event-input-input">input</a></code> event does not apply.</p>
- </div><h6 id="file-upload-state"><span class="secno">4.10.4.1.18 </span><dfn title="attr-input-type-file">File Upload</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 ideas:
+ </div><h6 id="file-upload-state"><span class="secno">4.10.5.1.18 </span><dfn title="attr-input-type-file">File Upload</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 ideas:
* maximum height/width or required ratio for image uploads? - Leons Petrazickis
* maximum per-file upload size - Alfonso Martínez de Lizarrondo
--><div class="impl">
@@ -30398,7 +30482,7 @@
<p>The <code class="no-backref" title="event-input-input"><a href="#event-input-input">input</a></code> event does not apply.</p>
- </div><h6 id="submit-button-state"><span class="secno">4.10.4.1.19 </span><dfn title="attr-input-type-submit">Submit Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="submit-button-state"><span class="secno">4.10.5.1.19 </span><dfn title="attr-input-type-submit">Submit Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#submit-button-state" title="attr-input-type-submit">Submit Button</a> state, the rules
in this section apply.</p>
@@ -30473,7 +30557,7 @@
<p>The <code class="no-backref" title="event-input-input"><a href="#event-input-input">input</a></code> and <code class="no-backref" title="event-input-change"><a href="#event-input-change">change</a></code> events do not apply.</p>
- </div><h6 id="image-button-state"><span class="secno">4.10.4.1.20 </span><dfn title="attr-input-type-image">Image Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="image-button-state"><span class="secno">4.10.5.1.20 </span><dfn title="attr-input-type-image">Image Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#image-button-state" title="attr-input-type-image">Image Button</a> state, the rules
in this section apply.</p>
@@ -30650,7 +30734,7 @@
</div><p class="note">Many aspects of this state's behavior are similar to
the behavior of the <code><a href="#the-img-element">img</a></code> element. Readers are encouraged
to read that section, where many of the same requirements are
- described in more detail.<h6 id="reset-button-state"><span class="secno">4.10.4.1.21 </span><dfn title="attr-input-type-reset">Reset Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ described in more detail.<h6 id="reset-button-state"><span class="secno">4.10.5.1.21 </span><dfn title="attr-input-type-reset">Reset Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#reset-button-state" title="attr-input-type-reset">Reset Button</a> state, the rules
in this section apply.</p>
@@ -30720,7 +30804,7 @@
<p>The <code class="no-backref" title="event-input-input"><a href="#event-input-input">input</a></code> and <code class="no-backref" title="event-input-change"><a href="#event-input-change">change</a></code> events do not apply.</p>
- </div><h6 id="button-state"><span class="secno">4.10.4.1.22 </span><dfn title="attr-input-type-button">Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h6 id="button-state"><span class="secno">4.10.5.1.22 </span><dfn title="attr-input-type-button">Button</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
<p>When an <code><a href="#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#button-state" title="attr-input-type-button">Button</a> state, the rules in
this section apply.</p>
@@ -30786,7 +30870,7 @@
<p>The <code class="no-backref" title="event-input-input"><a href="#event-input-input">input</a></code> and <code class="no-backref" title="event-input-change"><a href="#event-input-change">change</a></code> events do not apply.</p>
- </div><h5 id="common-input-element-attributes"><span class="secno">4.10.4.2 </span>Common <code><a href="#the-input-element">input</a></code> element attributes</h5><div class="impl">
+ </div><h5 id="common-input-element-attributes"><span class="secno">4.10.5.2 </span>Common <code><a href="#the-input-element">input</a></code> element attributes</h5><div class="impl">
<p>These attributes only apply to an <code><a href="#the-input-element">input</a></code> element if
its <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in a
@@ -30795,7 +30879,7 @@
agents must <a href="#ignore">ignore</a> the attribute, regardless of the
requirements and definitions below.</p>
- </div><h6 id="the-autocomplete-attribute"><span class="secno">4.10.4.2.1 </span>The <code title="attr-input-autocomplete"><a href="#attr-input-autocomplete">autocomplete</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>User agents sometimes have features for helping users fill forms
+ </div><h6 id="the-autocomplete-attribute"><span class="secno">4.10.5.2.1 </span>The <code title="attr-input-autocomplete"><a href="#attr-input-autocomplete">autocomplete</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>User agents sometimes have features for helping users fill forms
in, for example prefilling the user's address based on earlier user
input.<p>The <dfn id="attr-input-autocomplete" title="attr-input-autocomplete"><code>autocomplete</code></dfn>
attribute is an <a href="#enumerated-attribute">enumerated attribute</a>. The attribute has
@@ -30878,7 +30962,7 @@
significant security implications for the user if all values are
always remembered, regardless of the site's preferences.</p>
- </div><h6 id="the-list-attribute"><span class="secno">4.10.4.2.2 </span>The <code title="attr-input-list"><a href="#attr-input-list">list</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-list" title="attr-input-list"><code>list</code></dfn>
+ </div><h6 id="the-list-attribute"><span class="secno">4.10.5.2.2 </span>The <code title="attr-input-list"><a href="#attr-input-list">list</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-list" title="attr-input-list"><code>list</code></dfn>
attribute is used to identify an element that lists predefined
options suggested to the user.<p>If present, its value must be the ID of a <code><a href="#the-datalist-element">datalist</a></code>
element in the same document.<div class="impl">
@@ -30925,7 +31009,7 @@
<p>Other URLs from the user's history might show also; this is up
to the user agent.</p>
- </div><h6 id="the-readonly-attribute"><span class="secno">4.10.4.2.3 </span>The <code title="attr-input-readonly"><a href="#attr-input-readonly">readonly</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-readonly" title="attr-input-readonly"><code>readonly</code></dfn>
+ </div><h6 id="the-readonly-attribute"><span class="secno">4.10.5.2.3 </span>The <code title="attr-input-readonly"><a href="#attr-input-readonly">readonly</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-readonly" title="attr-input-readonly"><code>readonly</code></dfn>
attribute is a <a href="#boolean-attribute">boolean attribute</a> that controls whether
or not the use can edit the form control. <span class="impl">When
specified, the element is <i title="concept-input-immutable"><a href="#concept-input-immutable">immutable</a></i>.</span><div class="impl">
@@ -30964,7 +31048,7 @@
<p> <button name="action" value="update">Save</button> </p>
</form></pre>
- </div><h6 id="the-size-attribute"><span class="secno">4.10.4.2.4 </span>The <code title="attr-input-size"><a href="#attr-input-size">size</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-size" title="attr-input-size"><code>size</code></dfn>
+ </div><h6 id="the-size-attribute"><span class="secno">4.10.5.2.4 </span>The <code title="attr-input-size"><a href="#attr-input-size">size</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-size" title="attr-input-size"><code>size</code></dfn>
attribute gives the number of characters that, in a visual
rendering, the user agent is to allow the user to see while editing
the element's <a href="#concept-fe-value" title="concept-fe-value">value</a>.<p>The <code title="attr-input-size"><a href="#attr-input-size">size</a></code> attribute, if
@@ -30979,7 +31063,7 @@
<p>The <code title="dom-input-size"><a href="#dom-input-size">size</a></code> IDL attribute
<a href="#limited-to-only-positive-non-zero-numbers">limited to only positive non-zero numbers</a>.</p>
- </div><h6 id="the-required-attribute"><span class="secno">4.10.4.2.5 </span>The <code title="attr-input-required"><a href="#attr-input-required">required</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-required" title="attr-input-required"><code>required</code></dfn>
+ </div><h6 id="the-required-attribute"><span class="secno">4.10.5.2.5 </span>The <code title="attr-input-required"><a href="#attr-input-required">required</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-required" title="attr-input-required"><code>required</code></dfn>
attribute is a <a href="#boolean-attribute">boolean attribute</a>. When specified, the
element is <dfn id="concept-input-required" title="concept-input-required"><i>required</i></dfn>.<div class="impl">
@@ -31012,7 +31096,7 @@
<input type=submit value="Create account">
</form></pre>
- </div><h6 id="the-multiple-attribute"><span class="secno">4.10.4.2.6 </span>The <code title="attr-input-multiple"><a href="#attr-input-multiple">multiple</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-multiple" title="attr-input-multiple"><code>multiple</code></dfn>
+ </div><h6 id="the-multiple-attribute"><span class="secno">4.10.5.2.6 </span>The <code title="attr-input-multiple"><a href="#attr-input-multiple">multiple</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-multiple" title="attr-input-multiple"><code>multiple</code></dfn>
attribute is a <a href="#boolean-attribute">boolean attribute</a> that indicates whether
the user is to be allowed to specify more than one value.<div class="example">
@@ -31028,7 +31112,7 @@
<pre><label>Attachments: <input type=file multiple name=att></label></pre>
- </div><h6 id="the-maxlength-attribute"><span class="secno">4.10.4.2.7 </span>The <code title="attr-input-maxlength"><a href="#attr-input-maxlength">maxlength</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-maxlength" title="attr-input-maxlength"><code>maxlength</code></dfn>
+ </div><h6 id="the-maxlength-attribute"><span class="secno">4.10.5.2.7 </span>The <code title="attr-input-maxlength"><a href="#attr-input-maxlength">maxlength</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-maxlength" title="attr-input-maxlength"><code>maxlength</code></dfn>
attribute<span class="impl">, when it applies,</span> is a <a href="#attr-fe-maxlength" title="attr-fe-maxlength">form control <code title="">maxlength</code> attribute</a><span class="impl">
controlled by the <code><a href="#the-input-element">input</a></code> element's <a href="#concept-input-value-dirty-flag" title="concept-input-value-dirty-flag">dirty value
flag</a></span>.<p>If the <code><a href="#the-input-element">input</a></code> element has a <a href="#maximum-allowed-value-length">maximum allowed
@@ -31044,7 +31128,7 @@
<pre>What are you doing? <input name=status maxlength=140></pre>
- </div><h6 id="the-pattern-attribute"><span class="secno">4.10.4.2.8 </span>The <code title="attr-input-pattern"><a href="#attr-input-pattern">pattern</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-pattern" title="attr-input-pattern"><code>pattern</code></dfn>
+ </div><h6 id="the-pattern-attribute"><span class="secno">4.10.5.2.8 </span>The <code title="attr-input-pattern"><a href="#attr-input-pattern">pattern</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-pattern" title="attr-input-pattern"><code>pattern</code></dfn>
attribute specifies a regular expression against which the control's
<a href="#concept-fe-value" title="concept-fe-value">value</a> is to be checked.<p>If specified, the attribute's value must match the JavaScript <i title="">Pattern</i> production. <a href="#refsECMA262">[ECMA262]</a><div class="impl">
@@ -31096,7 +31180,7 @@
authors should be careful not to word <code><a href="#the-title-element-0">title</a></code>s as if an
error has necessarily occurred.</p>
- </div><h6 id="the-min-and-max-attributes"><span class="secno">4.10.4.2.9 </span>The <code title="attr-input-min"><a href="#attr-input-min">min</a></code> and <code title="attr-input-max"><a href="#attr-input-max">max</a></code> attributes</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-min" title="attr-input-min"><code>min</code></dfn> and <dfn id="attr-input-max" title="attr-input-max"><code>max</code></dfn> attributes indicate
+ </div><h6 id="the-min-and-max-attributes"><span class="secno">4.10.5.2.9 </span>The <code title="attr-input-min"><a href="#attr-input-min">min</a></code> and <code title="attr-input-max"><a href="#attr-input-max">max</a></code> attributes</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-min" title="attr-input-min"><code>min</code></dfn> and <dfn id="attr-input-max" title="attr-input-max"><code>max</code></dfn> attributes indicate
the allowed range of values for the element.<div class="impl">
<p>Their syntax is defined by the section that defines the <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute's current state.</p>
@@ -31159,7 +31243,7 @@
<pre><input name=quantity required type=number min=1 value=1></pre>
- </div><h6 id="the-step-attribute"><span class="secno">4.10.4.2.10 </span>The <code title="attr-input-step"><a href="#attr-input-step">step</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-step" title="attr-input-step"><code>step</code></dfn>
+ </div><h6 id="the-step-attribute"><span class="secno">4.10.5.2.10 </span>The <code title="attr-input-step"><a href="#attr-input-step">step</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-input-step" title="attr-input-step"><code>step</code></dfn>
attribute indicates the granularity that is expected (and required)
of the <a href="#concept-fe-value" title="concept-fe-value">value</a>, by limiting the
allowed values. <span class="impl">The section that defines the
@@ -31229,7 +31313,7 @@
<p>Normally, time controls are limited to an accuracy of one
minute.</p>
- </div><h6 id="the-placeholder-attribute"><span class="secno">4.10.4.2.11 </span>The <code title="attr-input-placeholder"><a href="#attr-input-placeholder">placeholder</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- similar text in the <textarea> section --><p>The <dfn id="attr-input-placeholder" title="attr-input-placeholder"><code>placeholder</code></dfn>
+ </div><h6 id="the-placeholder-attribute"><span class="secno">4.10.5.2.11 </span>The <code title="attr-input-placeholder"><a href="#attr-input-placeholder">placeholder</a></code> attribute</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- similar text in the <textarea> section --><p>The <dfn id="attr-input-placeholder" title="attr-input-placeholder"><code>placeholder</code></dfn>
attribute represents a <em>short</em> hint (a word or short phrase)
intended to aid the user with data entry. A hint could be a sample
value or a brief description of the expected format. The attribute,
@@ -31258,7 +31342,7 @@
<p><label>Description: <input type="text" name="desc" placeholder="My Email Account"></label></p>
</fieldset></pre>
- </div><h5 id="common-input-element-apis"><span class="secno">4.10.4.3 </span>Common <code><a href="#the-input-element">input</a></code> element APIs</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">input</var> . <code title="dom-input-value"><a href="#dom-input-value">value</a></code> [ = <var title="">value</var> ]</dt>
+ </div><h5 id="common-input-element-apis"><span class="secno">4.10.5.3 </span>Common <code><a href="#the-input-element">input</a></code> element APIs</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">input</var> . <code title="dom-input-value"><a href="#dom-input-value">value</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -31514,7 +31598,7 @@
</div><div class="impl">
- <h5 id="common-event-behaviors"><span class="secno">4.10.4.4 </span>Common event behaviors</h5>
+ <h5 id="common-event-behaviors"><span class="secno">4.10.5.4 </span>Common event behaviors</h5>
<p>When the <dfn id="event-input-input" title="event-input-input"><code>input</code></dfn>
event applies, any time the user causes the element's <a href="#concept-fe-value" title="concept-fe-value">value</a> to change, the user agent must
@@ -31588,7 +31672,7 @@
<p>The <a href="#task-source">task source</a> for these <span title="concept-tasks">tasks</span> is the <a href="#user-interaction-task-source">user interaction task
source</a>.</p>
- </div><h4 id="the-button-element"><span class="secno">4.10.5 </span>The <dfn><code>button</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-button-element"><span class="secno">4.10.6 </span>The <dfn><code>button</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="#interactive-content">Interactive content</a>.</dd>
@@ -31723,7 +31807,7 @@
Show hint
</button></pre>
- </div><h4 id="the-select-element"><span class="secno">4.10.6 </span>The <dfn><code>select</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-select-element"><span class="secno">4.10.7 </span>The <dfn><code>select</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="#interactive-content">Interactive content</a>.</dd>
@@ -32085,7 +32169,7 @@
</select>
</p></pre>
- </div><h4 id="the-datalist-element"><span class="secno">4.10.7 </span>The <dfn><code>datalist</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-datalist-element"><span class="secno">4.10.8 </span>The <dfn><code>datalist</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element may be used:</dt>
@@ -32135,7 +32219,7 @@
<code><a href="#the-datalist-element">datalist</a></code> element ancestor, it is <a href="#barred-from-constraint-validation">barred from
constraint validation</a>.</p>
- </div><h4 id="the-optgroup-element"><span class="secno">4.10.8 </span>The <dfn><code>optgroup</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-optgroup-element"><span class="secno">4.10.9 </span>The <dfn><code>optgroup</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
<dd>None.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>As a child of a <code><a href="#the-select-element">select</a></code> element.</dd>
@@ -32202,7 +32286,7 @@
<p><input type=submit value="▶ Play">
</form></pre>
- </div><h4 id="the-option-element"><span class="secno">4.10.9 </span>The <dfn><code>option</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-option-element"><span class="secno">4.10.10 </span>The <dfn><code>option</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
<dd>None.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>As a child of a <code><a href="#the-select-element">select</a></code> element.</dd>
@@ -32379,7 +32463,7 @@
to false, even if the <var title="">defaultSelected</var> argument
is present and true.</p>
- </div><h4 id="the-textarea-element"><span class="secno">4.10.10 </span>The <dfn><code>textarea</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-textarea-element"><span class="secno">4.10.11 </span>The <dfn><code>textarea</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="#interactive-content">Interactive content</a>.</dd>
@@ -32644,7 +32728,7 @@
<pre><p>If you have any comments, please let us know: <textarea cols=80 name=comments></textarea></p></pre>
- </div><h4 id="the-keygen-element"><span class="secno">4.10.11 </span>The <dfn><code>keygen</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>First draft</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-keygen-element"><span class="secno">4.10.12 </span>The <dfn><code>keygen</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>First draft</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="#interactive-content">Interactive content</a>.</dd>
@@ -32905,7 +32989,7 @@
can then be used for various purposes, such as generating a client
certificate, as mentioned above.</p>
- </div><h4 id="the-output-element"><span class="secno">4.10.12 </span>The <dfn><code>output</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-output-element"><span class="secno">4.10.13 </span>The <dfn><code>output</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="#category-listed" title="category-listed">Listed</a> and <a href="#category-reset" title="category-reset">resettable</a> <a href="#form-associated-element">form-associated element</a>.</dd>
@@ -33052,7 +33136,7 @@
<output onforminput="value = a.value + b.value"></output>
</form></pre>
- </div><h4 id="association-of-controls-and-forms"><span class="secno">4.10.13 </span>Association of controls and forms</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>A <a href="#form-associated-element">form-associated element</a> can have a relationship
+ </div><h4 id="association-of-controls-and-forms"><span class="secno">4.10.14 </span>Association of controls and forms</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><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
<dfn id="form-owner">form owner</dfn>. If a <a href="#form-associated-element">form-associated element</a> is
not associated with a <code><a href="#the-form-element">form</a></code> element, its <a href="#form-owner">form
@@ -33170,7 +33254,7 @@
<a href="#form-owner">form owner</a>, it is <a href="#barred-from-constraint-validation">barred from constraint
validation</a>.</p>
- </div><h4 id="attributes-common-to-form-controls"><span class="secno">4.10.14 </span><dfn>Attributes common to form controls</dfn></h4><h5 id="naming-form-controls"><span class="secno">4.10.14.1 </span>Naming form controls</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-fe-name" title="attr-fe-name"><code>name</code></dfn> content
+ </div><h4 id="attributes-common-to-form-controls"><span class="secno">4.10.15 </span><dfn>Attributes common to form controls</dfn></h4><h5 id="naming-form-controls"><span class="secno">4.10.15.1 </span>Naming form controls</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><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
submission</a> and in the <code><a href="#the-form-element">form</a></code> element's <code title="dom-form-elements"><a href="#dom-form-elements">elements</a></code> object. If the attribute
is specified, its value must not be the empty string.<div class="impl">
@@ -33184,7 +33268,7 @@
<p>The <dfn id="dom-fe-name" title="dom-fe-name"><code>name</code></dfn> IDL
attribute must <a href="#reflect">reflect</a> the <code title="attr-fe-name"><a href="#attr-fe-name">name</a></code> content attribute.</p>
- </div><h5 id="enabling-and-disabling-form-controls"><span class="secno">4.10.14.2 </span>Enabling and disabling form controls</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-fe-disabled" title="attr-fe-disabled"><code>disabled</code></dfn>
+ </div><h5 id="enabling-and-disabling-form-controls"><span class="secno">4.10.15.2 </span>Enabling and disabling form controls</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><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>A form control is <dfn id="concept-fe-disabled" title="concept-fe-disabled">disabled</dfn>
if its <code title="attr-fe-disabled"><a href="#attr-fe-disabled">disabled</a></code> attribute is
set, or if it is a descendant of a <code><a href="#the-fieldset-element">fieldset</a></code> element
@@ -33203,14 +33287,14 @@
</div><div class="impl">
- <h5 id="a-form-control-s-value"><span class="secno">4.10.14.3 </span>A form control's value</h5>
+ <h5 id="a-form-control-s-value"><span class="secno">4.10.15.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>
- </div><h5 id="autofocusing-a-form-control"><span class="secno">4.10.14.4 </span>Autofocusing a form control</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2: Apply this to contentEditable elements --><p>The <dfn id="attr-fe-autofocus" title="attr-fe-autofocus"><code>autofocus</code></dfn>
+ </div><h5 id="autofocusing-a-form-control"><span class="secno">4.10.15.4 </span>Autofocusing a form control</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2: Apply this to contentEditable elements --><p>The <dfn id="attr-fe-autofocus" title="attr-fe-autofocus"><code>autofocus</code></dfn>
content attribute allows the user to indicate that a control is to
be focused as soon as the page is loaded, allowing the user to just
start typing without having to manually focus the main control.<p>The <code title="attr-fe-autofocus"><a href="#attr-fe-autofocus">autofocus</a></code> attribute is
@@ -33244,7 +33328,7 @@
the document was loaded.</p>
<pre><input maxlength="256" name="q" value="" autofocus>
<input type="submit" value="Search"></pre>
- </div><h5 id="limiting-user-input-length"><span class="secno">4.10.14.5 </span>Limiting user input length</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><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
+ </div><h5 id="limiting-user-input-length"><span class="secno">4.10.15.5 </span>Limiting user input length</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><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>If an element has its <a href="#attr-fe-maxlength" title="attr-fe-maxlength">form
control <code title="">maxlength</code> attribute</a> specified,
the attribute's value must be a <a href="#valid-non-negative-integer">valid non-negative
@@ -33265,7 +33349,7 @@
<a href="#code-point-length">code-point length</a> is greater than the element's
<a href="#maximum-allowed-value-length">maximum allowed value length</a>.</p>
- </div><h5 id="form-submission-0"><span class="secno">4.10.14.6 </span>Form submission</h5><p><dfn id="attributes-for-form-submission">Attributes for form submission</dfn> can be specified both
+ </div><h5 id="form-submission-0"><span class="secno">4.10.15.6 </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
represent buttons that submit forms, e.g. an <code><a href="#the-input-element">input</a></code>
element whose <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is
@@ -33378,7 +33462,7 @@
attribute. The <dfn id="dom-fs-formtarget" title="dom-fs-formTarget"><code>formTarget</code></dfn> IDL
attribute must reflect the <code title="attr-fs-formtarget"><a href="#attr-fs-formtarget">formtarget</a></code> content attribute.
- </div><h4 id="constraints"><span class="secno">4.10.15 </span>Constraints</h4><h5 id="definitions"><span class="secno">4.10.15.1 </span>Definitions</h5><div class="impl">
+ </div><h4 id="constraints"><span class="secno">4.10.16 </span>Constraints</h4><h5 id="definitions"><span class="secno">4.10.16.1 </span>Definitions</h5><div class="impl">
<p>A <a href="#category-listed" title="category-listed">listed form-associated
element</a> is a <dfn id="candidate-for-constraint-validation">candidate for constraint validation</dfn>
@@ -33459,7 +33543,7 @@
</div><div class="impl">
- <h5 id="constraint-validation"><span class="secno">4.10.15.2 </span>Constraint validation</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+ <h5 id="constraint-validation"><span class="secno">4.10.16.2 </span>Constraint validation</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>When the user agent is required to <dfn id="statically-validate-the-constraints">statically validate the
constraints</dfn> of <code><a href="#the-form-element">form</a></code> element <var title="">form</var>, it must run the following steps, which return
@@ -33539,7 +33623,7 @@
<li><p>Return a <i>negative</i> result.</li>
- </ol></div><h5 id="the-constraint-validation-api"><span class="secno">4.10.15.3 </span>The <dfn>constraint validation API</dfn></h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">element</var> . <code title="dom-cva-willValidate"><a href="#dom-cva-willvalidate">willValidate</a></code></dt>
+ </ol></div><h5 id="the-constraint-validation-api"><span class="secno">4.10.16.3 </span>The <dfn>constraint validation API</dfn></h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">element</var> . <code title="dom-cva-willValidate"><a href="#dom-cva-willvalidate">willValidate</a></code></dt>
<dd>
@@ -33758,7 +33842,7 @@
</div><div class="impl">
- <h5 id="security-0"><span class="secno">4.10.15.4 </span>Security</h5>
+ <h5 id="security-0"><span class="secno">4.10.16.4 </span>Security</h5>
<p>Servers should not rely on client-side validation. Client-side
validation can be intentionally bypassed by hostile users, and
@@ -33767,9 +33851,9 @@
validation features are only intended to improve the user
experience, not to provide any kind of security mechanism.</p>
- </div><h4 id="form-submission"><span class="secno">4.10.16 </span><dfn>Form submission</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
+ </div><h4 id="form-submission"><span class="secno">4.10.17 </span><dfn>Form submission</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl">
- <h5 id="introduction-0"><span class="secno">4.10.16.1 </span>Introduction</h5>
+ <h5 id="introduction-0"><span class="secno">4.10.17.1 </span>Introduction</h5>
</div><p><i>This section is non-normative.</i><p>When forms are submitted, the data in the form is converted into
the form specified by the <a href="#concept-fs-enctype" title="concept-fs-enctype">enctype</a>, and then sent to the
@@ -33795,7 +33879,7 @@
fur
------kYFrd4jNJEgCervE--</pre><div class="impl">
- <h5 id="implicit-submission"><span class="secno">4.10.16.2 </span>Implicit submission</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+ <h5 id="implicit-submission"><span class="secno">4.10.17.2 </span>Implicit submission</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>User agents may establish a <a href="#concept-button" title="concept-button">button</a> in each form as being the
form's <dfn id="default-button">default button</dfn>. This should be the first <a href="#concept-submit-button" title="concept-submit-button">submit button</a> in <a href="#tree-order">tree
@@ -33821,7 +33905,7 @@
</div><div class="impl">
- <h5 id="form-submission-algorithm"><span class="secno">4.10.16.3 </span>Form submission algorithm</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+ <h5 id="form-submission-algorithm"><span class="secno">4.10.17.3 </span>Form submission algorithm</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>When a form <var title="">form</var> is <dfn id="concept-form-submit" title="concept-form-submit">submitted</dfn> from an element <var title="">submitter</var> (typically a button), the user agent must
run the following steps:</p>
@@ -34354,7 +34438,7 @@
</ol></div><div class="impl">
- <h5 id="url-encoded-form-data"><span class="secno">4.10.16.4 </span>URL-encoded form data</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+ <h5 id="url-encoded-form-data"><span class="secno">4.10.17.4 </span>URL-encoded form data</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>The <dfn id="application-x-www-form-urlencoded-encoding-algorithm"><code title="">application/x-www-form-urlencoded</code> encoding
algorithm</dfn> is as follows:</p>
@@ -34450,7 +34534,7 @@
</ol></div><div class="impl">
- <h5 id="multipart-form-data"><span class="secno">4.10.16.5 </span>Multipart form data</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+ <h5 id="multipart-form-data"><span class="secno">4.10.17.5 </span>Multipart form data</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>The <dfn id="multipart-form-data-encoding-algorithm"><code title="">multipart/form-data</code> encoding
algorithm</dfn> is to encode the <var title="">form data set</var>
@@ -34468,7 +34552,7 @@
</div><div class="impl">
- <h5 id="plain-text-form-data"><span class="secno">4.10.16.6 </span>Plain text form data</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+ <h5 id="plain-text-form-data"><span class="secno">4.10.17.6 </span>Plain text form data</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>The <dfn id="text-plain-encoding-algorithm"><code title="">text/plain</code> encoding
algorithm</dfn> is as follows:</p>
@@ -34523,7 +34607,7 @@
</ol></div><div class="impl">
- <h4 id="resetting-a-form"><span class="secno">4.10.17 </span>Resetting a form</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
+ <h4 id="resetting-a-form"><span class="secno">4.10.18 </span>Resetting a form</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>When a form <var title="">form</var> is <dfn id="concept-form-reset" title="concept-form-reset">reset</dfn>, the user agent must invoke
the <a href="#concept-form-reset-control" title="concept-form-reset-control">reset algorithm</a>
@@ -34540,7 +34624,7 @@
</div><div class="impl">
- <h4 id="event-dispatch"><span class="secno">4.10.18 </span>Event dispatch</h4>
+ <h4 id="event-dispatch"><span class="secno">4.10.19 </span>Event dispatch</h4>
<p>When the user agent is to <dfn id="broadcast-forminput-events">broadcast <code title="event-forminput">forminput</code> events</dfn> or
<dfn id="broadcast-formchange-events">broadcast <code title="event-formchange">formchange</code>
@@ -38237,93 +38321,7 @@
<li>Otherwise, if the element does not have a defined
<a href="#activation-behavior">activation behavior</a>, <a href="#fire-a-click-event">fire a <code title="event-click">click</code> event</a> at the element.</li>
- </ol></div><h3 id="miscellaneous-elements"><span class="secno">4.12 </span>Miscellaneous elements</h3><h4 id="the-legend-element"><span class="secno">4.12.1 </span>The <dfn><code>legend</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="element"><dt>Categories</dt>
- <dd>None.</dd>
- <dt>Contexts in which this element may be used:</dt>
- <dd>As the first child of a <code><a href="#the-fieldset-element">fieldset</a></code> element.</dd>
- <dt>Content model:</dt>
- <dd><a href="#phrasing-content">Phrasing content</a>.</dd>
- <dt>Content attributes:</dt>
- <dd><a href="#global-attributes">Global attributes</a></dd>
- <dt>DOM interface:</dt>
- <dd>
- <pre class="idl">interface <dfn id="htmllegendelement">HTMLLegendElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
- readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#dom-legend-form" title="dom-legend-form">form</a>;
-};</pre>
- </dd>
- </dl><p>The <code><a href="#the-legend-element">legend</a></code> element <a href="#represents">represents</a> a caption
- for the rest of the contents of the <code><a href="#the-legend-element">legend</a></code> element's
- parent <code><a href="#the-fieldset-element">fieldset</a></code> element<span class="impl">, if
- any</span>.<dl class="domintro"><dt><var title="">legend</var> . <code title="dom-legend-form"><a href="#dom-legend-form">form</a></code></dt>
-
- <dd>
-
- <p>Returns the element's <code><a href="#the-form-element">form</a></code> element, if any, or
- null otherwise.</p>
-
- </dd>
-
- </dl><div class="impl">
-
- <p>The <dfn id="dom-legend-form" title="dom-legend-form"><code>form</code></dfn> IDL
- attribute's behavior depends on whether the <code><a href="#the-legend-element">legend</a></code>
- element is in a <code><a href="#the-fieldset-element">fieldset</a></code> element or not. If the
- <code><a href="#the-legend-element">legend</a></code> has a <code><a href="#the-fieldset-element">fieldset</a></code> element as its
- parent, then the <code title="dom-legend-form"><a href="#dom-legend-form">form</a></code> IDL
- 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-fieldset-element">fieldset</a></code> element. Otherwise, it must return null.</p>
-
- </div><h4 id="the-div-element"><span class="secno">4.12.2 </span>The <dfn><code>div</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i><dl class="element"><dt>Categories</dt>
- <dd><a href="#flow-content">Flow content</a>.</dd>
- <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
- <dt>Contexts in which this element may be used:</dt>
- <dd>Where <a href="#flow-content">flow content</a> is expected.</dd>
- <dt>Content model:</dt>
- <dd><a href="#flow-content">Flow content</a>.</dd>
- <dt>Content attributes:</dt>
- <dd><a href="#global-attributes">Global attributes</a></dd>
- <dt>DOM interface:</dt>
- <dd>
- <pre class="idl">interface <dfn id="htmldivelement">HTMLDivElement</dfn> : <a href="#htmlelement">HTMLElement</a> {};</pre>
- </dd>
- </dl><p>The <code><a href="#the-div-element">div</a></code> element has no special meaning at all. It
- <a href="#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#attr-lang">lang</a></code>, and <code title="attr-title"><a href="#the-title-attribute">title</a></code> attributes to mark up semantics
- common to a group of consecutive elements.<p class="note">Authors are strongly encouraged to view the
- <code><a href="#the-div-element">div</a></code> element as an element of last resort, for when no
- other element is suitable. Use of the <code><a href="#the-div-element">div</a></code> element
- instead of more appropriate elements leads to poor accessibility for
- readers and poor maintainability for authors.<div class="example">
-
- <p>For example, a blog post would be marked up using
- <code><a href="#the-article-element">article</a></code>, a chapter using <code><a href="#the-section-element">section</a></code>, a
- page's navigation aids using <code><a href="#the-nav-element">nav</a></code>, and a group of form
- controls using <code><a href="#the-fieldset-element">fieldset</a></code>.</p>
-
- <p>On the other hand, <code><a href="#the-div-element">div</a></code> elements can be useful for
- stylistic purposes or to wrap multiple paragraphs within a section
- that are all to be annotated in a similar way. In the following
- example, we see <code><a href="#the-div-element">div</a></code> elements used as a way to set the
- language of two paragraphs at once, instead of setting the language
- on the two paragraph elements separately:</p>
-
- <pre><article lang="en-US">
- <h1>My use of language and my cats</h1>
- <p>My cat's behavior hasn't changed much since her absence, except
- that she plays her new physique to the neighbors regularly, in an
- attempt to get pets.</p>
- <div lang="en-GB">
- <p>My other cat, coloured black and white, is a sweetie. He followed
- us to the pool today, walking down the pavement with us. Yesterday
- he apparently visited our neighbours. I wonder if he recognises that
- their flat is a mirror image of ours.</p>
- <p>Hm, I just noticed that in the last paragraph I used British
- English. But I'm supposed to write in American English. So I
- shouldn't say "pavement" or "flat" or "colour"...</p>
- </div>
- <p>I should say "sidewalk" and "apartment" and "color"!</p>
-</article></pre>
-
- </div><h3 id="common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</h3><h5 id="tag-clouds"><span class="secno">4.13.1 </span>Tag clouds</h5><p id="tag-cloud">This specification does not define any markup
+ </ol></div><h3 id="common-idioms-without-dedicated-elements"><span class="secno">4.12 </span>Common idioms without dedicated elements</h3><h5 id="tag-clouds"><span class="secno">4.12.1 </span>Tag clouds</h5><p id="tag-cloud">This specification does not define any markup
specifically for marking up lists of keywords that apply to a group
of pages (also known as <i>tag clouds</i>). In general, authors are
encouraged to either mark up such lists using <code><a href="#the-ul-element">ul</a></code>
@@ -38368,7 +38366,7 @@
that apply to the page itself; they are just part of an index
listing the tags themselves.</p>
- </div><h4 id="conversations"><span class="secno">4.13.2 </span>Conversations</h4><p>This specification does not define a specific element for marking
+ </div><h4 id="conversations"><span class="secno">4.12.2 </span>Conversations</h4><p>This specification does not define a specific element for marking
up conversations, meeting minutes, chat transcripts, dialogues in
screenplays, instant message logs, and other situations where
different players take turns in discourse.<p>Instead, authors are encouraged to mark up conversations using
@@ -38400,7 +38398,7 @@
<p> <time>14:24</time> <b>kaj</b> you are not helping your case</pre>
<!-- with thanks to http://bash.org/?854262 -->
- </div><h4 id="footnotes"><span class="secno">4.13.3 </span>Footnotes</h4><p>HTML does not have a dedicated mechanism for marking up
+ </div><h4 id="footnotes"><span class="secno">4.12.3 </span>Footnotes</h4><p>HTML does not have a dedicated mechanism for marking up
footnotes. Here are the recommended alternatives.<hr><p>For short inline annotations, the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute should be used.<div class="example">
<p>In this example, two parts of a dialogue are annotated.</p>
@@ -38492,7 +38490,7 @@
</div><div class="impl">
- <h3 id="matching-html-elements-using-selectors"><span class="secno">4.14 </span>Matching HTML elements using selectors</h3><p class="XXX annotation"><b>Status: </b><i>Working draft</i></p>
+ <h3 id="matching-html-elements-using-selectors"><span class="secno">4.13 </span>Matching HTML elements using selectors</h3><p class="XXX annotation"><b>Status: </b><i>Working draft</i></p>
<p>There are a number of dynamic selectors that can be used with
HTML. This section defines when these selectors match HTML
Received on Tuesday, 15 September 2009 11:16:08 UTC