[html5] r3861 - [e] (0) Move <div> and <legend> to more appropriate spots.
whatwg at whatwg.org
whatwg at whatwg.org
Tue Sep 15 04:20:30 PDT 2009
Author: ianh
Date: 2009-09-15 04:20:29 -0700 (Tue, 15 Sep 2009)
New Revision: 3861
Modified:
index
source
Log:
[e] (0) Move <div> and <legend> to more appropriate spots.
Modified: index
===================================================================
--- index 2009-09-15 11:18:26 UTC (rev 3860)
+++ index 2009-09-15 11:20:29 UTC (rev 3861)
@@ -387,7 +387,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>
@@ -515,81 +516,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>
@@ -611,16 +613,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>
+ <li><a href=#common-idioms-without-dedicated-elements><span class=secno>4.12 </span>Common idioms without dedicated 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>
- <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>
@@ -14140,7 +14138,6 @@
-
<h3 id=grouping-content><span class=secno>4.5 </span>Grouping content</h3>
<h4 id=the-p-element><span class=secno>4.5.1 </span>The <dfn><code>p</code></dfn> element</h4>
@@ -14985,6 +14982,65 @@
+ <h4 id=the-div-element><span class=secno>4.5.12 </span>The <dfn><code>div</code></dfn> element</h4>
+
+ <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>
+
+ <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.</p>
+
+ <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>
@@ -30478,9 +30534,52 @@
</div>
+ <h4 id=the-legend-element><span class=secno>4.10.3 </span>The <dfn><code>legend</code></dfn> element</h4>
- <h4 id=the-label-element><span class=secno>4.10.3 </span>The <dfn><code>label</code></dfn> element</h4>
+ <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>.</p>
+ <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>
+
<dl class=element><dt>Categories</dt>
<dd><a href=#flow-content>Flow content</a>.</dd>
<dd><a href=#phrasing-content>Phrasing content</a>.</dd>
@@ -30615,7 +30714,7 @@
</div>
- <h4 id=the-input-element><span class=secno>4.10.4 </span>The <dfn><code>input</code></dfn> element</h4>
+ <h4 id=the-input-element><span class=secno>4.10.5 </span>The <dfn><code>input</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd><a href=#flow-content>Flow content</a>.</dd>
@@ -31886,10 +31985,10 @@
- <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>
+ <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.4.1.1 </span><dfn title=attr-input-type-hidden>Hidden</dfn> state</h6>
+ <h6 id=hidden-state><span class=secno>4.10.5.1.1 </span><dfn title=attr-input-type-hidden>Hidden</dfn> state</h6>
<div class=impl>
@@ -31969,7 +32068,7 @@
</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>
+ <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>
<!-- v2 idea: applying input masks to <input>, e.g. for entering
data with slashes and dashes (ack Greg Kilwein)
@@ -32066,7 +32165,7 @@
</div>
- <h6 id=telephone-state><span class=secno>4.10.4.1.3 </span><dfn title=attr-input-type-tel>Telephone</dfn> state</h6>
+ <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>
@@ -32162,7 +32261,7 @@
</div>
- <h6 id=url-state><span class=secno>4.10.4.1.4 </span><dfn title=attr-input-type-url>URL</dfn> state</h6>
+ <h6 id=url-state><span class=secno>4.10.5.1.4 </span><dfn title=attr-input-type-url>URL</dfn> state</h6>
<div class=impl>
@@ -32262,7 +32361,7 @@
</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>
+ <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>
<div class=impl>
@@ -32392,7 +32491,7 @@
</div>
- <h6 id=password-state><span class=secno>4.10.4.1.6 </span><dfn title=attr-input-type-password>Password</dfn> state</h6>
+ <h6 id=password-state><span class=secno>4.10.5.1.6 </span><dfn title=attr-input-type-password>Password</dfn> state</h6>
<div class=impl>
@@ -32480,7 +32579,7 @@
</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>
+ <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>
<div class=impl>
@@ -32635,7 +32734,7 @@
</div>
- <h6 id=date-state><span class=secno>4.10.4.1.8 </span><dfn title=attr-input-type-date>Date</dfn> state</h6>
+ <h6 id=date-state><span class=secno>4.10.5.1.8 </span><dfn title=attr-input-type-date>Date</dfn> state</h6>
<div class=impl>
@@ -32782,7 +32881,7 @@
</div>
- <h6 id=month-state><span class=secno>4.10.4.1.9 </span><dfn title=attr-input-type-month>Month</dfn> state</h6>
+ <h6 id=month-state><span class=secno>4.10.5.1.9 </span><dfn title=attr-input-type-month>Month</dfn> state</h6>
<div class=impl>
@@ -32930,7 +33029,7 @@
</div>
- <h6 id=week-state><span class=secno>4.10.4.1.10 </span><dfn title=attr-input-type-week>Week</dfn> state</h6>
+ <h6 id=week-state><span class=secno>4.10.5.1.10 </span><dfn title=attr-input-type-week>Week</dfn> state</h6>
<div class=impl>
@@ -33078,7 +33177,7 @@
</div>
- <h6 id=time-state><span class=secno>4.10.4.1.11 </span><dfn title=attr-input-type-time>Time</dfn> state</h6>
+ <h6 id=time-state><span class=secno>4.10.5.1.11 </span><dfn title=attr-input-type-time>Time</dfn> state</h6>
<div class=impl>
@@ -33220,7 +33319,7 @@
</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>
+ <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>
<div class=impl>
@@ -33355,7 +33454,7 @@
</div>
- <h6 id=number-state><span class=secno>4.10.4.1.13 </span><dfn title=attr-input-type-number>Number</dfn> state</h6>
+ <h6 id=number-state><span class=secno>4.10.5.1.13 </span><dfn title=attr-input-type-number>Number</dfn> state</h6>
<div class=impl>
@@ -33484,7 +33583,7 @@
</div>
- <h6 id=range-state><span class=secno>4.10.4.1.14 </span><dfn title=attr-input-type-range>Range</dfn> state</h6>
+ <h6 id=range-state><span class=secno>4.10.5.1.14 </span><dfn title=attr-input-type-range>Range</dfn> state</h6>
<div class=impl>
@@ -33644,7 +33743,7 @@
</div>
- <h6 id=color-state><span class=secno>4.10.4.1.15 </span><dfn title=attr-input-type-color>Color</dfn> state</h6>
+ <h6 id=color-state><span class=secno>4.10.5.1.15 </span><dfn title=attr-input-type-color>Color</dfn> state</h6>
<div class=impl>
@@ -33745,7 +33844,7 @@
</div>
- <h6 id=checkbox-state><span class=secno>4.10.4.1.16 </span><dfn title=attr-input-type-checkbox>Checkbox</dfn> state</h6>
+ <h6 id=checkbox-state><span class=secno>4.10.5.1.16 </span><dfn title=attr-input-type-checkbox>Checkbox</dfn> state</h6>
<div class=impl>
@@ -33856,7 +33955,7 @@
- <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>
+ <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>
<div class=impl>
@@ -33991,7 +34090,7 @@
- <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>
+ <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>
<!-- v2 ideas:
* maximum height/width or required ratio for image uploads? - Leons Petrazickis
@@ -34130,7 +34229,7 @@
- <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>
+ <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>
<div class=impl>
@@ -34220,7 +34319,7 @@
</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>
+ <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>
<div class=impl>
@@ -34421,7 +34520,7 @@
- <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>
+ <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>
<div class=impl>
@@ -34502,7 +34601,7 @@
</div>
- <h6 id=button-state><span class=secno>4.10.4.1.22 </span><dfn title=attr-input-type-button>Button</dfn> state</h6>
+ <h6 id=button-state><span class=secno>4.10.5.1.22 </span><dfn title=attr-input-type-button>Button</dfn> state</h6>
<div class=impl>
@@ -34580,7 +34679,7 @@
- <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>
+ <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>
@@ -34594,7 +34693,7 @@
</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>
+ <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>User agents sometimes have features for helping users fill forms
in, for example prefilling the user's address based on earlier user
@@ -34697,7 +34796,7 @@
- <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>
+ <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>The <dfn id=attr-input-list title=attr-input-list><code>list</code></dfn>
attribute is used to identify an element that lists predefined
@@ -34756,7 +34855,7 @@
- <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>
+ <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>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
@@ -34805,7 +34904,7 @@
- <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>
+ <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>The <dfn id=attr-input-size title=attr-input-size><code>size</code></dfn>
attribute gives the number of characters that, in a visual
@@ -34830,7 +34929,7 @@
- <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>
+ <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>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
@@ -34872,7 +34971,7 @@
</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>
+ <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>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
@@ -34897,7 +34996,7 @@
</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>
+ <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>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>
@@ -34923,7 +35022,7 @@
- <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>
+ <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>The <dfn id=attr-input-pattern title=attr-input-pattern><code>pattern</code></dfn>
attribute specifies a regular expression against which the control's
@@ -34995,7 +35094,7 @@
- <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>
+ <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>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.</p>
@@ -35069,7 +35168,7 @@
</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>
+ <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>The <dfn id=attr-input-step title=attr-input-step><code>step</code></dfn>
attribute indicates the granularity that is expected (and required)
@@ -35154,7 +35253,7 @@
- <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>
+ <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>
<!-- similar text in the <textarea> section -->
@@ -35199,7 +35298,7 @@
- <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>
+ <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>
<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>
@@ -35460,7 +35559,7 @@
<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
@@ -35538,7 +35637,7 @@
- <h4 id=the-button-element><span class=secno>4.10.5 </span>The <dfn><code>button</code></dfn> element</h4>
+ <h4 id=the-button-element><span class=secno>4.10.6 </span>The <dfn><code>button</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd><a href=#flow-content>Flow content</a>.</dd>
@@ -35702,7 +35801,7 @@
- <h4 id=the-select-element><span class=secno>4.10.6 </span>The <dfn><code>select</code></dfn> element</h4>
+ <h4 id=the-select-element><span class=secno>4.10.7 </span>The <dfn><code>select</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd><a href=#flow-content>Flow content</a>.</dd>
@@ -36086,7 +36185,7 @@
- <h4 id=the-datalist-element><span class=secno>4.10.7 </span>The <dfn><code>datalist</code></dfn> element</h4>
+ <h4 id=the-datalist-element><span class=secno>4.10.8 </span>The <dfn><code>datalist</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd><a href=#flow-content>Flow content</a>.</dd>
@@ -36145,7 +36244,7 @@
</div>
- <h4 id=the-optgroup-element><span class=secno>4.10.8 </span>The <dfn><code>optgroup</code></dfn> element</h4>
+ <h4 id=the-optgroup-element><span class=secno>4.10.9 </span>The <dfn><code>optgroup</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd>None.</dd>
@@ -36230,7 +36329,7 @@
- <h4 id=the-option-element><span class=secno>4.10.9 </span>The <dfn><code>option</code></dfn> element</h4>
+ <h4 id=the-option-element><span class=secno>4.10.10 </span>The <dfn><code>option</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd>None.</dd>
@@ -36427,7 +36526,7 @@
- <h4 id=the-textarea-element><span class=secno>4.10.10 </span>The <dfn><code>textarea</code></dfn> element</h4>
+ <h4 id=the-textarea-element><span class=secno>4.10.11 </span>The <dfn><code>textarea</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd><a href=#flow-content>Flow content</a>.</dd>
@@ -36746,7 +36845,7 @@
- <h4 id=the-keygen-element><span class=secno>4.10.11 </span>The <dfn><code>keygen</code></dfn> element</h4>
+ <h4 id=the-keygen-element><span class=secno>4.10.12 </span>The <dfn><code>keygen</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd><a href=#flow-content>Flow content</a>.</dd>
@@ -37034,7 +37133,7 @@
- <h4 id=the-output-element><span class=secno>4.10.12 </span>The <dfn><code>output</code></dfn> element</h4>
+ <h4 id=the-output-element><span class=secno>4.10.13 </span>The <dfn><code>output</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
<dd><a href=#flow-content>Flow content</a>.</dd>
@@ -37197,7 +37296,7 @@
- <h4 id=association-of-controls-and-forms><span class=secno>4.10.13 </span>Association of controls and forms</h4>
+ <h4 id=association-of-controls-and-forms><span class=secno>4.10.14 </span>Association of controls and forms</h4>
<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
@@ -37329,9 +37428,9 @@
- <h4 id=attributes-common-to-form-controls><span class=secno>4.10.14 </span><dfn>Attributes common to form controls</dfn></h4>
+ <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.14.1 </span>Naming form controls</h5>
+ <h5 id=naming-form-controls><span class=secno>4.10.15.1 </span>Naming form controls</h5>
<p>The <dfn id=attr-fe-name title=attr-fe-name><code>name</code></dfn> content
attribute gives the name of the form control, as used in <a href=#form-submission>form
@@ -37352,7 +37451,7 @@
</div>
- <h5 id=enabling-and-disabling-form-controls><span class=secno>4.10.14.2 </span>Enabling and disabling form controls</h5>
+ <h5 id=enabling-and-disabling-form-controls><span class=secno>4.10.15.2 </span>Enabling and disabling form controls</h5>
<p>The <dfn id=attr-fe-disabled title=attr-fe-disabled><code>disabled</code></dfn>
content attribute is a <a href=#boolean-attribute>boolean attribute</a>.</p>
@@ -37381,7 +37480,7 @@
<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
@@ -37392,7 +37491,7 @@
- <h5 id=autofocusing-a-form-control><span class=secno>4.10.14.4 </span>Autofocusing a form control</h5>
+ <h5 id=autofocusing-a-form-control><span class=secno>4.10.15.4 </span>Autofocusing a form control</h5>
<!-- v2: Apply this to contentEditable elements -->
@@ -37441,7 +37540,7 @@
</div>
- <h5 id=limiting-user-input-length><span class=secno>4.10.14.5 </span>Limiting user input length</h5>
+ <h5 id=limiting-user-input-length><span class=secno>4.10.15.5 </span>Limiting user input length</h5>
<p>A <dfn id=attr-fe-maxlength title=attr-fe-maxlength>form control <code title="">maxlength</code> attribute</dfn>, controlled by a <var title="">dirty value flag</var> declares a limit on the number of
characters a user can input.</p>
@@ -37472,7 +37571,7 @@
- <h5 id=form-submission-0><span class=secno>4.10.14.6 </span>Form submission</h5>
+ <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
@@ -37621,9 +37720,9 @@
- <h4 id=constraints><span class=secno>4.10.15 </span>Constraints</h4>
+ <h4 id=constraints><span class=secno>4.10.16 </span>Constraints</h4>
- <h5 id=definitions><span class=secno>4.10.15.1 </span>Definitions</h5>
+ <h5 id=definitions><span class=secno>4.10.16.1 </span>Definitions</h5>
<div class=impl>
@@ -37710,7 +37809,7 @@
<div class=impl>
- <h5 id=constraint-validation><span class=secno>4.10.15.2 </span>Constraint validation</h5>
+ <h5 id=constraint-validation><span class=secno>4.10.16.2 </span>Constraint validation</h5>
<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
@@ -37794,7 +37893,7 @@
- <h5 id=the-constraint-validation-api><span class=secno>4.10.15.3 </span>The <dfn>constraint validation API</dfn></h5>
+ <h5 id=the-constraint-validation-api><span class=secno>4.10.16.3 </span>The <dfn>constraint validation API</dfn></h5>
<dl class=domintro><dt><var title="">element</var> . <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code></dt>
@@ -38022,7 +38121,7 @@
<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
@@ -38036,11 +38135,11 @@
- <h4 id=form-submission><span class=secno>4.10.16 </span><dfn>Form submission</dfn></h4>
+ <h4 id=form-submission><span class=secno>4.10.17 </span><dfn>Form submission</dfn></h4>
<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>
@@ -38088,7 +38187,7 @@
<div class=impl>
- <h5 id=implicit-submission><span class=secno>4.10.16.2 </span>Implicit submission</h5>
+ <h5 id=implicit-submission><span class=secno>4.10.17.2 </span>Implicit submission</h5>
<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
@@ -38117,7 +38216,7 @@
<div class=impl>
- <h5 id=form-submission-algorithm><span class=secno>4.10.16.3 </span>Form submission algorithm</h5>
+ <h5 id=form-submission-algorithm><span class=secno>4.10.17.3 </span>Form submission algorithm</h5>
<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>
@@ -38653,7 +38752,7 @@
<div class=impl>
- <h5 id=url-encoded-form-data><span class=secno>4.10.16.4 </span>URL-encoded form data</h5>
+ <h5 id=url-encoded-form-data><span class=secno>4.10.17.4 </span>URL-encoded form data</h5>
<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>
@@ -38753,7 +38852,7 @@
<div class=impl>
- <h5 id=multipart-form-data><span class=secno>4.10.16.5 </span>Multipart form data</h5>
+ <h5 id=multipart-form-data><span class=secno>4.10.17.5 </span>Multipart form data</h5>
<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>
@@ -38775,7 +38874,7 @@
<div class=impl>
- <h5 id=plain-text-form-data><span class=secno>4.10.16.6 </span>Plain text form data</h5>
+ <h5 id=plain-text-form-data><span class=secno>4.10.17.6 </span>Plain text form data</h5>
<p>The <dfn id=text/plain-encoding-algorithm><code title="">text/plain</code> encoding
algorithm</dfn> is as follows:</p>
@@ -38834,7 +38933,7 @@
<div class=impl>
- <h4 id=resetting-a-form><span class=secno>4.10.17 </span>Resetting a form</h4>
+ <h4 id=resetting-a-form><span class=secno>4.10.18 </span>Resetting a form</h4>
<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>
@@ -38855,7 +38954,7 @@
<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>
@@ -42687,114 +42786,10 @@
</ol></div>
- <h3 id=miscellaneous-elements><span class=secno>4.12 </span>Miscellaneous elements</h3>
+ <h3 id=common-idioms-without-dedicated-elements><span class=secno>4.12 </span>Common idioms without dedicated elements</h3>
- <h4 id=the-legend-element><span class=secno>4.12.1 </span>The <dfn><code>legend</code></dfn> element</h4>
+ <h5 id=tag-clouds><span class=secno>4.12.1 </span>Tag clouds</h5>
- <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>.</p>
-
- <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>
-
- <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>
-
- <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.</p>
-
- <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
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
@@ -42845,7 +42840,7 @@
</div>
- <h4 id=conversations><span class=secno>4.13.2 </span>Conversations</h4>
+ <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
@@ -42888,7 +42883,7 @@
</div>
- <h4 id=footnotes><span class=secno>4.13.3 </span>Footnotes</h4>
+ <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.</p>
@@ -43002,7 +42997,7 @@
<div class=impl>
- <h3 id=matching-html-elements-using-selectors><span class=secno>4.14 </span>Matching HTML elements using selectors</h3>
+ <h3 id=matching-html-elements-using-selectors><span class=secno>4.13 </span>Matching HTML elements using selectors</h3>
<p>There are a number of dynamic selectors that can be used with
HTML. This section defines when these selectors match HTML
Modified: source
===================================================================
--- source 2009-09-15 11:18:26 UTC (rev 3860)
+++ source 2009-09-15 11:20:29 UTC (rev 3861)
@@ -15041,7 +15041,6 @@
-
<h3>Grouping content</h3>
<h4>The <dfn><code>p</code></dfn> element</h4>
@@ -15934,6 +15933,71 @@
+ <h4>The <dfn><code>div</code></dfn> element</h4>
+
+ <dl class="element">
+ <dt>Categories</dt>
+ <dd><span>Flow content</span>.</dd>
+ <dd><span><code title="">formatBlock</code> candidate</span>.</dd>
+ <dt>Contexts in which this element may be used:</dt>
+ <dd>Where <span>flow content</span> is expected.</dd>
+ <dt>Content model:</dt>
+ <dd><span>Flow content</span>.</dd>
+ <dt>Content attributes:</dt>
+ <dd><span>Global attributes</span></dd>
+ <dt>DOM interface:</dt>
+ <dd>
+ <pre class="idl">interface <dfn>HTMLDivElement</dfn> : <span>HTMLElement</span> {};</pre>
+ </dd>
+ </dl>
+
+ <p>The <code>div</code> element has no special meaning at all. It
+ <span>represents</span> its children. It can be used with the <code
+ title="attr-class">class</code>, <code
+ title="attr-lang">lang</code>, and <code
+ title="attr-title">title</code> attributes to mark up semantics
+ common to a group of consecutive elements.</p>
+
+ <p class="note">Authors are strongly encouraged to view the
+ <code>div</code> element as an element of last resort, for when no
+ other element is suitable. Use of the <code>div</code> element
+ instead of more appropriate elements leads to poor accessibility for
+ readers and poor maintainability for authors.</p>
+
+ <div class="example">
+
+ <p>For example, a blog post would be marked up using
+ <code>article</code>, a chapter using <code>section</code>, a
+ page's navigation aids using <code>nav</code>, and a group of form
+ controls using <code>fieldset</code>.</p>
+
+ <p>On the other hand, <code>div</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>div</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>Text-level semantics</h3>
<h4>The <dfn><code>a</code></dfn> element</h4>
@@ -33826,7 +33890,58 @@
</div>
+ <h4>The <dfn><code>legend</code></dfn> element</h4>
+ <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>fieldset</code> element.</dd>
+ <dt>Content model:</dt>
+ <dd><span>Phrasing content</span>.</dd>
+ <dt>Content attributes:</dt>
+ <dd><span>Global attributes</span></dd>
+ <dt>DOM interface:</dt>
+ <dd>
+ <pre class="idl">interface <dfn>HTMLLegendElement</dfn> : <span>HTMLElement</span> {
+ readonly attribute <span>HTMLFormElement</span> <span title="dom-legend-form">form</span>;
+};</pre>
+ </dd>
+ </dl>
+
+ <p>The <code>legend</code> element <span>represents</span> a caption
+ for the rest of the contents of the <code>legend</code> element's
+ parent <code>fieldset</code> element<span class="impl">, if
+ any</span>.</p>
+
+ <dl class="domintro">
+
+ <dt><var title="">legend</var> . <code title="dom-legend-form">form</code></dt>
+
+ <dd>
+
+ <p>Returns the element's <code>form</code> element, if any, or
+ null otherwise.</p>
+
+ </dd>
+
+ </dl>
+
+ <div class="impl">
+
+ <p>The <dfn title="dom-legend-form"><code>form</code></dfn> IDL
+ attribute's behavior depends on whether the <code>legend</code>
+ element is in a <code>fieldset</code> element or not. If the
+ <code>legend</code> has a <code>fieldset</code> element as its
+ parent, then the <code title="dom-legend-form">form</code> IDL
+ attribute must return the same value as the <code
+ title="dom-fae-form">form</code> IDL attribute on that
+ <code>fieldset</code> element. Otherwise, it must return null.</p>
+
+ </div>
+
+
+
<h4>The <dfn><code>label</code></dfn> element</h4>
<dl class="element">
@@ -47642,124 +47757,6 @@
</div>
- <h3>Miscellaneous elements</h3>
-
- <h4>The <dfn><code>legend</code></dfn> element</h4>
-
- <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>fieldset</code> element.</dd>
- <dt>Content model:</dt>
- <dd><span>Phrasing content</span>.</dd>
- <dt>Content attributes:</dt>
- <dd><span>Global attributes</span></dd>
- <dt>DOM interface:</dt>
- <dd>
- <pre class="idl">interface <dfn>HTMLLegendElement</dfn> : <span>HTMLElement</span> {
- readonly attribute <span>HTMLFormElement</span> <span title="dom-legend-form">form</span>;
-};</pre>
- </dd>
- </dl>
-
- <p>The <code>legend</code> element <span>represents</span> a caption
- for the rest of the contents of the <code>legend</code> element's
- parent <code>fieldset</code> element<span class="impl">, if
- any</span>.</p>
-
- <dl class="domintro">
-
- <dt><var title="">legend</var> . <code title="dom-legend-form">form</code></dt>
-
- <dd>
-
- <p>Returns the element's <code>form</code> element, if any, or
- null otherwise.</p>
-
- </dd>
-
- </dl>
-
- <div class="impl">
-
- <p>The <dfn title="dom-legend-form"><code>form</code></dfn> IDL
- attribute's behavior depends on whether the <code>legend</code>
- element is in a <code>fieldset</code> element or not. If the
- <code>legend</code> has a <code>fieldset</code> element as its
- parent, then the <code title="dom-legend-form">form</code> IDL
- attribute must return the same value as the <code
- title="dom-fae-form">form</code> IDL attribute on that
- <code>fieldset</code> element. Otherwise, it must return null.</p>
-
- </div>
-
-
- <h4>The <dfn><code>div</code></dfn> element</h4>
-
- <dl class="element">
- <dt>Categories</dt>
- <dd><span>Flow content</span>.</dd>
- <dd><span><code title="">formatBlock</code> candidate</span>.</dd>
- <dt>Contexts in which this element may be used:</dt>
- <dd>Where <span>flow content</span> is expected.</dd>
- <dt>Content model:</dt>
- <dd><span>Flow content</span>.</dd>
- <dt>Content attributes:</dt>
- <dd><span>Global attributes</span></dd>
- <dt>DOM interface:</dt>
- <dd>
- <pre class="idl">interface <dfn>HTMLDivElement</dfn> : <span>HTMLElement</span> {};</pre>
- </dd>
- </dl>
-
- <p>The <code>div</code> element has no special meaning at all. It
- <span>represents</span> its children. It can be used with the <code
- title="attr-class">class</code>, <code
- title="attr-lang">lang</code>, and <code
- title="attr-title">title</code> attributes to mark up semantics
- common to a group of consecutive elements.</p>
-
- <p class="note">Authors are strongly encouraged to view the
- <code>div</code> element as an element of last resort, for when no
- other element is suitable. Use of the <code>div</code> element
- instead of more appropriate elements leads to poor accessibility for
- readers and poor maintainability for authors.</p>
-
- <div class="example">
-
- <p>For example, a blog post would be marked up using
- <code>article</code>, a chapter using <code>section</code>, a
- page's navigation aids using <code>nav</code>, and a group of form
- controls using <code>fieldset</code>.</p>
-
- <p>On the other hand, <code>div</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>div</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>Common idioms without dedicated elements</h3>
<h5>Tag clouds</h5>
More information about the Commit-Watchers
mailing list