- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 24 Jan 2012 23:00:35 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv28927
Modified Files:
Overview.html
Log Message:
Fix the changes in r6905 to be more consistent and thorough. (whatwg r6912)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5509
retrieving revision 1.5510
diff -u -d -r1.5509 -r1.5510
--- Overview.html 24 Jan 2012 22:39:25 -0000 1.5509
+++ Overview.html 24 Jan 2012 23:00:31 -0000 1.5510
@@ -836,7 +836,7 @@
<li><a href="#implementing-the-server-side-processing-for-a-form"><span class="secno">4.10.1.2 </span>Implementing the server-side processing for a form</a></li>
<li><a href="#configuring-a-form-to-communicate-with-a-server"><span class="secno">4.10.1.3 </span>Configuring a form to communicate with a server</a></li>
<li><a href="#client-side-form-validation"><span class="secno">4.10.1.4 </span>Client-side form validation</a></li>
- <li><a href="#date-and-time-formats"><span class="secno">4.10.1.5 </span>Date and time formats</a></ol></li>
+ <li><a href="#input-author-notes"><span class="secno">4.10.1.5 </span>Date, time, and number formats</a></ol></li>
<li><a href="#categories"><span class="secno">4.10.2 </span>Categories</a></li>
<li><a href="#the-form-element"><span class="secno">4.10.3 </span>The <code>form</code> element</a></li>
<li><a href="#the-fieldset-element"><span class="secno">4.10.4 </span>The <code>fieldset</code> element</a></li>
@@ -868,22 +868,23 @@
<li><a href="#image-button-state-type-image"><span class="secno">4.10.7.1.20 </span>Image Button state (<code title="">type=image</code>)</a></li>
<li><a href="#reset-button-state-type-reset"><span class="secno">4.10.7.1.21 </span>Reset Button state (<code title="">type=reset</code>)</a></li>
<li><a href="#button-state-type-button"><span class="secno">4.10.7.1.22 </span>Button state (<code title="">type=button</code>)</a></ol></li>
- <li><a href="#common-input-element-attributes"><span class="secno">4.10.7.2 </span>Common <code>input</code> element attributes</a>
+ <li><a href="#input-impl-notes"><span class="secno">4.10.7.2 </span>Implemention notes regarding localization of form controls</a></li>
+ <li><a href="#common-input-element-attributes"><span class="secno">4.10.7.3 </span>Common <code>input</code> element attributes</a>
<ol>
- <li><a href="#the-autocomplete-attribute"><span class="secno">4.10.7.2.1 </span>The <code title="attr-input-autocomplete">autocomplete</code> attribute</a></li>
- <li><a href="#the-dirname-attribute"><span class="secno">4.10.7.2.2 </span>The <code title="attr-input-dirname">dirname</code> attribute</a></li>
- <li><a href="#the-list-attribute"><span class="secno">4.10.7.2.3 </span>The <code title="attr-input-list">list</code> attribute</a></li>
- <li><a href="#the-readonly-attribute"><span class="secno">4.10.7.2.4 </span>The <code title="attr-input-readonly">readonly</code> attribute</a></li>
- <li><a href="#the-size-attribute"><span class="secno">4.10.7.2.5 </span>The <code title="attr-input-size">size</code> attribute</a></li>
- <li><a href="#the-required-attribute"><span class="secno">4.10.7.2.6 </span>The <code title="attr-input-required">required</code> attribute</a></li>
- <li><a href="#the-multiple-attribute"><span class="secno">4.10.7.2.7 </span>The <code title="attr-input-multiple">multiple</code> attribute</a></li>
- <li><a href="#the-maxlength-attribute"><span class="secno">4.10.7.2.8 </span>The <code title="attr-input-maxlength">maxlength</code> attribute</a></li>
- <li><a href="#the-pattern-attribute"><span class="secno">4.10.7.2.9 </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.7.2.10 </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.7.2.11 </span>The <code title="attr-input-step">step</code> attribute</a></li>
- <li><a href="#the-placeholder-attribute"><span class="secno">4.10.7.2.12 </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.7.3 </span>Common <code>input</code> element APIs</a></li>
- <li><a href="#common-event-behaviors"><span class="secno">4.10.7.4 </span>Common event behaviors</a></ol></li>
+ <li><a href="#the-autocomplete-attribute"><span class="secno">4.10.7.3.1 </span>The <code title="attr-input-autocomplete">autocomplete</code> attribute</a></li>
+ <li><a href="#the-dirname-attribute"><span class="secno">4.10.7.3.2 </span>The <code title="attr-input-dirname">dirname</code> attribute</a></li>
+ <li><a href="#the-list-attribute"><span class="secno">4.10.7.3.3 </span>The <code title="attr-input-list">list</code> attribute</a></li>
+ <li><a href="#the-readonly-attribute"><span class="secno">4.10.7.3.4 </span>The <code title="attr-input-readonly">readonly</code> attribute</a></li>
+ <li><a href="#the-size-attribute"><span class="secno">4.10.7.3.5 </span>The <code title="attr-input-size">size</code> attribute</a></li>
+ <li><a href="#the-required-attribute"><span class="secno">4.10.7.3.6 </span>The <code title="attr-input-required">required</code> attribute</a></li>
+ <li><a href="#the-multiple-attribute"><span class="secno">4.10.7.3.7 </span>The <code title="attr-input-multiple">multiple</code> attribute</a></li>
+ <li><a href="#the-maxlength-attribute"><span class="secno">4.10.7.3.8 </span>The <code title="attr-input-maxlength">maxlength</code> attribute</a></li>
+ <li><a href="#the-pattern-attribute"><span class="secno">4.10.7.3.9 </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.7.3.10 </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.7.3.11 </span>The <code title="attr-input-step">step</code> attribute</a></li>
+ <li><a href="#the-placeholder-attribute"><span class="secno">4.10.7.3.12 </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.7.4 </span>Common <code>input</code> element APIs</a></li>
+ <li><a href="#common-event-behaviors"><span class="secno">4.10.7.5 </span>Common event behaviors</a></ol></li>
<li><a href="#the-button-element"><span class="secno">4.10.8 </span>The <code>button</code> element</a></li>
<li><a href="#the-select-element"><span class="secno">4.10.9 </span>The <code>select</code> element</a></li>
<li><a href="#the-datalist-element"><span class="secno">4.10.10 </span>The <code>datalist</code> element</a></li>
@@ -32722,7 +32723,7 @@
<p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900" name="delivery" required></label></p>
<p><label>Delivery instructions: <textarea name="comments"<strong> maxlength=1000</strong>></textarea></label></p>
<p><button>Submit order</button></p>
-</form></pre><h5 id="date-and-time-formats"><span class="secno">4.10.1.5 </span>Date and time formats</h5><p><i>This section is non-normative.</i><p>In this pizze delivery example, the times are specified in the
+</form></pre><h5 id="input-author-notes"><span class="secno">4.10.1.5 </span>Date, time, and number formats</h5><p><i>This section is non-normative.</i><p>In this pizze delivery example, the times are specified in the
format "HH:MM": two digits for the hour, in 24-hour format, and two
digits for the time. (Seconds could also be specified, though they
are not necessary in this example.)<p>In some locales, however, times are often expressed differently
@@ -32730,26 +32731,34 @@
still common to use the 12-hour clock with an am/pm indicator, as in
"2pm". In France, it is common to separate the hours from the
minutes using an "h" character, as in "14h00".<p>Similar issues exist with dates, with the added complication that
- even the order of the components is not always consistent; for
- example, in Cyprus the first of February 2003 would typically be
+ even the order of the components is not always consistent —
+ for example, in Cyprus the first of February 2003 would typically be
written "1/2/03", while that same date in Japan would typically be
- written as "2003年02月01日".<p>It therefore is important to distinguish the time and date format
- used in HTML and in form submissions, which are always the formats
- defined in this specification (and based on the well-established ISO
- 8601 standard for computer-readable date and time formats), from the
- time and date formats presented to the user by the browser and
- accepted as input from the user by the browser.<p>The format used "on the wire", i.e. in HTML markup and in form
+ written as "2003年02月01日" — and even with
+ numbers, where locales differ, for example, in what punctuation is
+ used as the decimal separator and the thousands separator.<p>It therefore is important to distinguish the time, date, and
+ number formats used in HTML and in form submissions, which are
+ always the formats defined in this specification (and based on the
+ well-established ISO 8601 standard for computer-readable date and
+ time formats), from the time, date, and number formats presented to
+ the user by the browser and accepted as input from the user by the
+ browser.<p>The format used "on the wire", i.e. in HTML markup and in form
submissions, is intended to be computer-readable and consistent
irrespective of the user's locale. Dates, for instance, are always
written in the format "YYYY-MM-DD", as in "2003-02-01". Users are
- not expected to ever see this format.<p>The date or time given by the page in the wire format is then
- translated to the user's preferred presentation (based on user
+ not expected to ever see this format.<p>The time, date, or number given by the page in the wire format is
+ then translated to the user's preferred presentation (based on user
preferences or on the locale of the page itself), before being
- displayed to the user. Similarly, after the user inputs a date or
- time using their preferred format, the user agent converts it back
- to the wire format before putting it in the DOM or submitting it.<p>This allows scripts in pages and on servers to process dates and
- times in a consistent manner without needing to support dozens of
- different formats, while still supporting the users' needs.<h4 id="categories"><span class="secno">4.10.2 </span>Categories</h4><p>Mostly for historical reasons, elements in this section fall into
+ displayed to the user. Similarly, after the user inputs a time,
+ date, or number using their preferred format, the user agent
+ converts it back to the wire format before putting it in the DOM or
+ submitting it.<p>This allows scripts in pages and on servers to process times,
+ dates, and numbers in a consistent manner without needing to support
+ dozens of different formats, while still supporting the users'
+ needs.<div class="impl">
+ <p class="note">See also the <a href="#input-impl-notes">implementation notes</a> regarding
+ localization of form controls.</p>
+ </div><h4 id="categories"><span class="secno">4.10.2 </span>Categories</h4><p>Mostly for historical reasons, elements in this section fall into
several overlapping (but subtly different) categories in addition to
the usual ones like <a href="#flow-content">flow content</a>, <a href="#phrasing-content">phrasing
content</a>, and <a href="#interactive-content">interactive content</a>.<p>A number of the elements are <dfn id="form-associated-element" title="form-associated
@@ -35452,20 +35461,11 @@
normalized forced-UTC global date and time string</a> representing the
user's selection. User agents should allow the user to set the <a href="#concept-fe-value" title="concept-fe-value">value</a> to the empty string.</p>
- </div><p class="note">The format shown to the user is independent of the
- format used for form submission. Browsers are encouraged to use user
- interfaces that present dates and times according to the conventions
- of either the locale implied by the element's <a href="#language">language</a>
- or the user's preferred locale. Using the page locale will ensure
- consistency with page-provided data.<p class="Example">For example, it would be confusing to users if an
- American English page claimed that a Cirque De Soleil show was going
- to be showing on 02/03, but their browser,
- configured to use the British English locale, only showed the date
- 03/02 in the ticket purchase date picker. Using
- the page's locale would at least ensure that the date was presented
- in the same format everywhere. (There's still a risk that the user
- would end up arriving a month late, of course, but there's only so
- much that can be done about such cultural differences...)<p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
+ </div><p class="note">See the <a href="#input-author-notes">introduction
+ section</a> for a discussion of the difference between the input
+ format and submission format for date, time, and number form
+ controls<span class="impl">, and the <a href="#input-impl-notes">implementation notes</a> regarding
+ localization of form controls</span>.<p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
specified and not empty, must have a value that is a <a href="#valid-global-date-and-time-string">valid
global date and time string</a>.</p><div class="impl">
@@ -35635,10 +35635,11 @@
date string</a> representing the user's selection. User agents
should allow the user to set the <a href="#concept-fe-value" title="concept-fe-value">value</a> to the empty string.</p>
- </div><p class="note">The format shown to the user is independent of the
- format used for form submission. Browsers are encouraged to use user
- interfaces that present dates according to the conventions of the
- user's preferred locale.<p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
+ </div><p class="note">See the <a href="#input-author-notes">introduction
+ section</a> for a discussion of the difference between the input
+ format and submission format for date, time, and number form
+ controls<span class="impl">, and the <a href="#input-impl-notes">implementation notes</a> regarding
+ localization of form controls</span>.<p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
specified and not empty, must have a value that is a <a href="#valid-date-string">valid
date string</a>.</p><div class="impl">
@@ -35764,10 +35765,13 @@
month string</a> representing the user's selection. User agents
should allow the user to set the <a href="#concept-fe-value" title="concept-fe-value">value</a> to the empty string.</p>
- </div><p class="note">The format shown to the user is independent of the
- format used for form submission. Browsers are encouraged to use user
- interfaces that present months according to the conventions of the
- user's preferred locale.<p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
+ <p class="note">See the <a href="#input-author-notes">introduction
+ section</a> for a discussion of the difference between the input
+ format and submission format for date, time, and number form
+ controls<span class="impl">, and the <a href="#input-impl-notes">implementation notes</a> regarding
+ localization of form controls</span>.</p>
+
+ </div><p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
specified and not empty, must have a value that is a <a href="#valid-month-string">valid
month string</a>.</p><div class="impl">
@@ -35892,10 +35896,13 @@
week string</a> representing the user's selection. User agents
should allow the user to set the <a href="#concept-fe-value" title="concept-fe-value">value</a> to the empty string.</p>
- </div><p class="note">The format shown to the user is independent of the
- format used for form submission. Browsers are encouraged to use user
- interfaces that present weeks according to the conventions of the
- user's preferred locale.<p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
+ <p class="note">See the <a href="#input-author-notes">introduction
+ section</a> for a discussion of the difference between the input
+ format and submission format for date, time, and number form
+ controls<span class="impl">, and the <a href="#input-impl-notes">implementation notes</a> regarding
+ localization of form controls</span>.</p>
+
+ </div><p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
specified and not empty, must have a value that is a <a href="#valid-week-string">valid
week string</a>.</p><div class="impl">
@@ -36022,10 +36029,13 @@
time string</a> representing the user's selection. User agents
should allow the user to set the <a href="#concept-fe-value" title="concept-fe-value">value</a> to the empty string.</p>
- </div><p class="note">The format shown to the user is independent of the
- format used for form submission. Browsers are encouraged to use user
- interfaces that present times according to the conventions of the
- user's preferred locale.<p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
+ <p class="note">See the <a href="#input-author-notes">introduction
+ section</a> for a discussion of the difference between the input
+ format and submission format for date, time, and number form
+ controls<span class="impl">, and the <a href="#input-impl-notes">implementation notes</a> regarding
+ localization of form controls</span>.</p>
+
+ </div><p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
specified and not empty, must have a value that is a <a href="#valid-time-string">valid
time string</a>.</p><div class="impl">
@@ -36153,10 +36163,13 @@
string</a> representing the user's selection. User agents should
allow the user to set the <a href="#concept-fe-value" title="concept-fe-value">value</a> to the empty string.</p>
- </div><p class="note">The format shown to the user is independent of the
- format used for form submission. Browsers are encouraged to use user
- interfaces that present dates and times according to the conventions
- of the user's preferred locale.<p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
+ <p class="note">See the <a href="#input-author-notes">introduction
+ section</a> for a discussion of the difference between the input
+ format and submission format for date, time, and number form
+ controls<span class="impl">, and the <a href="#input-impl-notes">implementation notes</a> regarding
+ localization of form controls</span>.</p>
+
+ </div><p>The <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, if
specified and not empty, must have a value that is a <a href="#valid-local-date-and-time-string">valid
local date and time string</a>.</p><div class="impl">
@@ -37495,7 +37508,32 @@
<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.7.2 </span>Common <code><a href="#the-input-element">input</a></code> element attributes</h5><div class="impl">
+ </div><div class="impl">
+
+ <h5 id="input-impl-notes"><span class="secno">4.10.7.2 </span>Implemention notes regarding localization of form controls</h5>
+
+ <p><i>This section is non-normative.</i></p>
+
+ <p>The formats shown to the user in date, time, and number controls
+ is independent of the format used for form submission.</p>
+
+ <p>Browsers are encouraged to use user interfaces that present
+ dates, times, and numbers according to the conventions of either the
+ locale implied by the <code><a href="#the-input-element">input</a></code> element's
+ <a href="#language">language</a> or the user's preferred locale. Using the
+ page's locale will ensure consistency with page-provided data.
+
+ <p class="example">For example, it would be confusing to users if an
+ American English page claimed that a Cirque De Soleil show was going
+ to be showing on 02/03, but their browser,
+ configured to use the British English locale, only showed the date
+ 03/02 in the ticket purchase date picker. Using
+ the page's locale would at least ensure that the date was presented
+ in the same format everywhere. (There's still a risk that the user
+ would end up arriving a month late, of course, but there's only so
+ much that can be done about such cultural differences...)</p>
+
+ </div><h5 id="common-input-element-attributes"><span class="secno">4.10.7.3 </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
@@ -37505,7 +37543,7 @@
attribute, regardless of the requirements and definitions
below.</p>
- </div><h6 id="the-autocomplete-attribute"><span class="secno">4.10.7.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
+ </div><h6 id="the-autocomplete-attribute"><span class="secno">4.10.7.3.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
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
@@ -37590,7 +37628,7 @@
significant security implications for the user if all values are
always remembered, regardless of the site's preferences.</p>
- </div><h6 id="the-dirname-attribute"><span class="secno">4.10.7.2.2 </span>The <code title="attr-input-dirname"><a href="#attr-input-dirname">dirname</a></code> attribute</h6><p>The <dfn id="attr-input-dirname" title="attr-input-dirname"><code>dirname</code></dfn>
+ </div><h6 id="the-dirname-attribute"><span class="secno">4.10.7.3.2 </span>The <code title="attr-input-dirname"><a href="#attr-input-dirname">dirname</a></code> attribute</h6><p>The <dfn id="attr-input-dirname" title="attr-input-dirname"><code>dirname</code></dfn>
attribute, when it applies, is a <a href="#form-control-dirname-attribute">form control <code title="">dirname</code> attribute</a>.<div class="example">
<p>In this example, a form contains a text field and a submission
@@ -37614,7 +37652,7 @@
<pre>comment=%D9%85%D8%B1%D8%AD%D8%A8%D9%8B%D8%A7&<strong>comment.dir=rtl</strong>&mode=add</pre>
- </div><h6 id="the-list-attribute"><span class="secno">4.10.7.2.3 </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>
+ </div><h6 id="the-list-attribute"><span class="secno">4.10.7.3.3 </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
options suggested to the user.<p>If present, its value must be the <a href="#concept-id" title="concept-id">ID</a> of a <code><a href="#the-datalist-element">datalist</a></code> element in
the same document.<div class="impl">
@@ -37748,7 +37786,7 @@
<code><a href="#the-input-element">input</a></code> element in UAs that support
<code><a href="#the-datalist-element">datalist</a></code>.</p>
- </div><h6 id="the-readonly-attribute"><span class="secno">4.10.7.2.4 </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>
+ </div><h6 id="the-readonly-attribute"><span class="secno">4.10.7.3.4 </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
or not the user 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">
@@ -37787,7 +37825,7 @@
<p> <button name="action" value="update">Save</button> </p>
</form></pre>
- </div><h6 id="the-size-attribute"><span class="secno">4.10.7.2.5 </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>
+ </div><h6 id="the-size-attribute"><span class="secno">4.10.7.3.5 </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
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
@@ -37803,7 +37841,7 @@
<a href="#limited-to-only-non-negative-numbers-greater-than-zero">limited to only non-negative numbers greater than
zero</a> and has a default value of 20.</p>
- </div><h6 id="the-required-attribute"><span class="secno">4.10.7.2.6 </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>
+ </div><h6 id="the-required-attribute"><span class="secno">4.10.7.3.6 </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
element is <dfn id="concept-input-required" title="concept-input-required"><i>required</i></dfn>.<div class="impl">
@@ -37837,7 +37875,7 @@
<input type=submit value="Create account">
</form></pre>
- </div><h6 id="the-multiple-attribute"><span class="secno">4.10.7.2.7 </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>
+ </div><h6 id="the-multiple-attribute"><span class="secno">4.10.7.3.7 </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
the user is to be allowed to specify more than one value.<div class="example">
@@ -37881,7 +37919,7 @@
<pre><label>Attachments: <input type=file multiple name=att></label></pre>
- </div><h6 id="the-maxlength-attribute"><span class="secno">4.10.7.2.8 </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>
+ </div><h6 id="the-maxlength-attribute"><span class="secno">4.10.7.3.8 </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">
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
@@ -37897,7 +37935,7 @@
<pre><label>What are you doing? <input name=status maxlength=140></label></pre>
- </div><h6 id="the-pattern-attribute"><span class="secno">4.10.7.2.9 </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>
+ </div><h6 id="the-pattern-attribute"><span class="secno">4.10.7.3.9 </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
<a href="#concept-fe-value" title="concept-fe-value">value</a>, or, when the <code title="attr-input-multiple"><a href="#attr-input-multiple">multiple</a></code> attribute applies and is
set, the control's <a href="#concept-fe-values" title="concept-fe-values">value<em>s</em></a>, are to be
@@ -37965,7 +38003,7 @@
required pattern. Birthday</samp>, which is not useful.<p>UAs may still show the <code><a href="#the-title-element">title</a></code> in non-error situations
(for example, as a tooltip when hovering over the control), so
authors should be careful not to word <code><a href="#the-title-element">title</a></code>s as if an
- error has necessarily occurred.<h6 id="the-min-and-max-attributes"><span class="secno">4.10.7.2.10 </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
+ error has necessarily occurred.<h6 id="the-min-and-max-attributes"><span class="secno">4.10.7.3.10 </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.<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>
@@ -38029,7 +38067,7 @@
<pre><input name=quantity required type=number min=1 value=1></pre>
- </div><h6 id="the-step-attribute"><span class="secno">4.10.7.2.11 </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>
+ </div><h6 id="the-step-attribute"><span class="secno">4.10.7.3.11 </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)
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
@@ -38101,7 +38139,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.7.2.12 </span>The <code title="attr-input-placeholder"><a href="#attr-input-placeholder">placeholder</a></code> attribute</h6><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.7.3.12 </span>The <code title="attr-input-placeholder"><a href="#attr-input-placeholder">placeholder</a></code> attribute</h6><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,
@@ -38131,7 +38169,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.7.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>
+ </div><h5 id="common-input-element-apis"><span class="secno">4.10.7.4 </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>
<dd>
@@ -38403,7 +38441,7 @@
</div><div class="impl">
- <h5 id="common-event-behaviors"><span class="secno">4.10.7.4 </span>Common event behaviors</h5>
+ <h5 id="common-event-behaviors"><span class="secno">4.10.7.5 </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
Received on Tuesday, 24 January 2012 23:00:39 UTC