- From: poot <cvsmail@w3.org>
- Date: Tue, 24 Jan 2012 18:00:53 -0500
- To: public-html-diffs@w3.org
hixie: Fix the changes in r6905 to be more consistent and thorough. (whatwg r6912) http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5509&r2=1.5510&f=h http://html5.org/tools/web-apps-tracker?from=6911&to=6912 =================================================================== 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:01:01 UTC