W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2008

html5/spec Overview.html,1.1483,1.1484

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 09 Oct 2008 23:57:16 +0000
To: public-html-commits@w3.org
Message-Id: <E1Ko5Nc-0002zX-PB@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv11484

Modified Files:
	Overview.html 
Log Message:
WF2: <textarea maxlength>; also, factoring out common stuff for this from <input> to reduce duplication. (whatwg r2311)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1483
retrieving revision 1.1484
diff -u -d -r1.1483 -r1.1484
--- Overview.html	9 Oct 2008 20:32:39 -0000	1.1483
+++ Overview.html	9 Oct 2008 23:57:13 -0000	1.1484
@@ -463,8 +463,7 @@
          <li><a href=#submit-button-state><span class=secno>4.10.4.1.17 </span>Submit Button state</a></li>
          <li><a href=#image-button-state><span class=secno>4.10.4.1.18 </span>Image Button state</a></li>
          <li><a href=#reset-button-state><span class=secno>4.10.4.1.19 </span>Reset Button state</a></li>
-         <li><a href=#button-state><span class=secno>4.10.4.1.20 </span>Button state</a></li>
-         <li><a href=#common-algorithms><span class=secno>4.10.4.1.21 </span>Common algorithms</a></ol></li>
+         <li><a href=#button-state><span class=secno>4.10.4.1.20 </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>
         <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>
@@ -491,7 +490,8 @@
        <li><a href=#naming-form-controls><span class=secno>4.10.13.1 </span>Naming form controls</a></li>
        <li><a href=#enabling-and-disabling-form-controls><span class=secno>4.10.13.2 </span>Enabling and disabling form controls</a></li>
        <li><a href=#a-form-control-s-value><span class=secno>4.10.13.3 </span>A form control's value</a></li>
-       <li><a href=#autofocusing-a-form-control><span class=secno>4.10.13.4 </span>Autofocusing a form control</a></ol></li>
+       <li><a href=#autofocusing-a-form-control><span class=secno>4.10.13.4 </span>Autofocusing a form control</a></li>
+       <li><a href=#limiting-user-input-length><span class=secno>4.10.13.5 </span>Limiting user input length</a></ol></li>
      <li><a href=#attributes-for-form-submission><span class=secno>4.10.14 </span>Attributes for form submission</a></li>
      <li><a href=#constraints><span class=secno>4.10.15 </span>Constraints</a>
       <ol>
@@ -1608,7 +1608,10 @@
   White_Space characters</dfn> means that the user agent must
   <a href=#collect-a-sequence-of-characters>collect a sequence of characters</a> that are
   <a href=#white_space>White_Space</a> characters. In both cases, the collected
-  characters are not used. <a href=#references>[UNICODE]</a><h4 id=boolean-attributes><span class=secno>2.4.2 </span>Boolean attributes</h4><p>A number of attributes in HTML5 are <dfn id=boolean-attribute title="boolean
+  characters are not used. <a href=#references>[UNICODE]</a><p>When a user agent is to <dfn id=strip-line-breaks>strip line breaks</dfn> from a
+  string, the user agent must remove any U+000A LINE FEED (LF) and
+  U+000D CARRIAGE RETURN (CR) characters from that string.<p>The <dfn id=codepoint-length>codepoint length</dfn> of a string is the number of
+  Unicode codepoints in that string.<h4 id=boolean-attributes><span class=secno>2.4.2 </span>Boolean attributes</h4><p>A number of attributes in HTML5 are <dfn id=boolean-attribute title="boolean
   attribute">boolean attributes</dfn>. The presence of a boolean
   attribute on an element represents the true value, and the absence
   of the attribute represents the false value.<p>If the attribute is present, its value must either be the empty
@@ -19552,7 +19555,7 @@
   by the user. User agents must not allow users to insert U+000A LINE
   FEED (LF) or U+000D CARRIAGE RETURN (CR) characters into the
   element's <a href=#concept-fe-value title=concept-fe-value>value</a>.<p><strong>The <a href=#value-sanitization-algorithm>value sanitization algorithm</a> is as
-  follows:</strong> <a href=#strip-line-breaks-from-the-value>Strip line breaks from the value</a>.<div class=bookkeeping>
+  follows:</strong> <a href=#strip-line-breaks>Strip line breaks</a> from the <a href=#concept-fe-value title=concept-fe-value>value</a>.<div class=bookkeeping>
 
    <p>The following common <code><a href=#the-input-element>input</a></code> element content
    attributes and DOM attributes apply to the element:
@@ -19603,7 +19606,7 @@
   e-mail address. User agents should allow the user to set the <a href=#concept-fe-value title=concept-fe-value>value</a> to the empty string. User
   agents must not allow users to insert U+000A LINE FEED (LF) or
   U+000D CARRIAGE RETURN (CR) characters into the <a href=#concept-fe-value title=concept-fe-value>value</a>.<p><strong>The <a href=#value-sanitization-algorithm>value sanitization algorithm</a> is as
-  follows:</strong> <a href=#strip-line-breaks-from-the-value>Strip line breaks from the value</a>.<p><strong>Constraint validation:</strong> While the <a href=#concept-fe-value title=concept-fe-value>value</a> of the element does not match
+  follows:</strong> <a href=#strip-line-breaks>Strip line breaks</a> from the <a href=#concept-fe-value title=concept-fe-value>value</a>.<p><strong>Constraint validation:</strong> While the <a href=#concept-fe-value title=concept-fe-value>value</a> of the element does not match
   the <code>addr-spec</code> token defined in RFC 2822 section 3.4.1,
   excluding the <code>CFWS</code> subtoken everywhere, and excluding
   the <code>FWS</code> subtoken everywhere except in the
@@ -19660,7 +19663,7 @@
   allow the user to set the <a href=#concept-fe-value title=concept-fe-value>value</a> to the empty string. User
   agents must not allow users to insert U+000A LINE FEED (LF) or
   U+000D CARRIAGE RETURN (CR) characters into the <a href=#concept-fe-value title=concept-fe-value>value</a>.<p><strong>The <a href=#value-sanitization-algorithm>value sanitization algorithm</a> is as
-  follows:</strong> <a href=#strip-line-breaks-from-the-value>Strip line breaks from the value</a>.<p><strong>Constraint validation:</strong> While the <a href=#concept-fe-value title=concept-fe-value>value</a> of the element is not a
+  follows:</strong> <a href=#strip-line-breaks>Strip line breaks</a> from the <a href=#concept-fe-value title=concept-fe-value>value</a>.<p><strong>Constraint validation:</strong> While the <a href=#concept-fe-value title=concept-fe-value>value</a> of the element is not a
   <a href=#valid-url>valid URL</a>, the element is <a href=#suffering-from-a-type-mismatch>suffering from a type
   mismatch</a>.<div class=bookkeeping>
 
@@ -19711,7 +19714,7 @@
   its <a href=#concept-fe-value title=concept-fe-value>value</a> should be editable
   by the user. User agents must not allow users to insert U+000A LINE
   FEED (LF) or U+000D CARRIAGE RETURN (CR) characters into the <a href=#concept-fe-value title=concept-fe-value>value</a>.<p><strong>The <a href=#value-sanitization-algorithm>value sanitization algorithm</a> is as
-  follows:</strong> <a href=#strip-line-breaks-from-the-value>Strip line breaks from the value</a>.<div class=bookkeeping>
+  follows:</strong> <a href=#strip-line-breaks>Strip line breaks</a> from the <a href=#concept-fe-value title=concept-fe-value>value</a>.<div class=bookkeeping>
 
    <p>The following common <code><a href=#the-input-element>input</a></code> element content
    attributes and DOM attributes apply to the element:
@@ -20922,9 +20925,7 @@
 
    <p>The <code class=no-backref title=event-input-input><a href=#event-input-input>input</a></code> and <code class=no-backref title=event-input-change><a href=#event-input-change>change</a></code> events do not fire.</p>
 
-  </div><h6 id=common-algorithms><span class=secno>4.10.4.1.21 </span>Common algorithms</h6><p>When a user agent is to <dfn id=strip-line-breaks-from-the-value>strip line breaks from the
-  value</dfn>, the user agent must remove any U+000A LINE FEED (LF)
-  and U+000D CARRIAGE RETURN (CR) characters from <a href=#concept-fe-value title=concept-fe-value>value</a>.<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><p>These attributes only apply to an <code><a href=#the-input-element>input</a></code> element if
+  </div><h5 id=common-input-element-attributes><span class=secno>4.10.4.2 </span>Common <code><a href=#the-input-element>input</a></code> element attributes</h5><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
   state whose definition declares that the attribute applies. When an
   attribute doesn't apply to an <code><a href=#the-input-element>input</a></code> element, user
@@ -21019,26 +21020,14 @@
   the mode <a href=#dom-input-value-value title=dom-input-value-value>value</a>, and the
   element's <a href=#concept-fe-value title=concept-fe-value>value</a> is the empty
   string, then the element is <a href=#suffering-from-being-missing>suffering from being
-  missing</a>.<h6 id=the-maxlength-attribute><span class=secno>4.10.4.2.6 </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
-  allows authors to specify the maximum length allowed for user
-  input.<p>The <dfn id=codepoint-length>codepoint length</dfn> of a string is the number of
-  Unicode codepoints in that string.<p>If the attribute is specified, the attribute's value must be a
-  <a href=#valid-non-negative-integer>valid non-negative integer</a>. If the attribute is
-  specified and applying the <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative
-  integers</a> to its value results in a number, then that number
-  is the element's <dfn id=maximum-allowed-value-length>maximum allowed value length</dfn>. If the
-  attribute is omitted or parsing its value results in an error, then
-  there is no <a href=#maximum-allowed-value-length>maximum allowed value length</a>.<p>If the <code><a href=#the-input-element>input</a></code> element has a <a href=#maximum-allowed-value-length>maximum allowed
+  missing</a>.<h6 id=the-maxlength-attribute><span class=secno>4.10.4.2.6 </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,
+  when it applies, is a <a href=#attr-fe-maxlength title=attr-fe-maxlength>form control
+  <code title="">maxlength</code> attribute</a> 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>.<p>If the <code><a href=#the-input-element>input</a></code> element has a <a href=#maximum-allowed-value-length>maximum allowed
   value length</a>, then the <a href=#codepoint-length>codepoint length</a> of the
   value of the element's <code title=attr-input-value><a href=#attr-input-value>value</a></code>
   attribute must be equal to or less than the element's <a href=#maximum-allowed-value-length>maximum
-  allowed value length</a>.<p><strong>Constraint validation:</strong> If an <code><a href=#the-input-element>input</a></code>
-  element has a <a href=#maximum-allowed-value-length>maximum allowed value length</a>, its <a href=#concept-input-value-dirty-flag title=concept-input-value-dirty-flag>dirty value flag</a> is
-  false, and the <a href=#codepoint-length>codepoint length</a> of the element's <a href=#concept-fe-value title=concept-fe-value>value</a> is greater than the element's
-  <a href=#maximum-allowed-value-length>maximum allowed value length</a>, then the element is
-  <a href=#suffering-from-being-too-long>suffering from being too long</a>.<p>User agents may prevent the user from setting the element's <a href=#concept-fe-value title=concept-fe-value>value</a> to a value whose
-  <a href=#codepoint-length>codepoint length</a> is greater than the element's
-  <a href=#maximum-allowed-value-length>maximum allowed value length</a>.<h6 id=the-pattern-attribute><span class=secno>4.10.4.2.7 </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>
+  allowed value length</a>.<h6 id=the-pattern-attribute><span class=secno>4.10.4.2.7 </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> is to be checked.<p>If specified, the attribute's value must match the <i title="">Pattern</i> production of ECMA 262's grammar. <a href=#references>[ECMA262]</a><p><strong>Constraint validation:</strong> If the element's <a href=#concept-fe-value title=concept-fe-value>value</a> is not the empty string, and
   the element's <code title=attr-input-pattern><a href=#attr-input-pattern>pattern</a></code>
@@ -21801,9 +21790,13 @@
    U+000D CARRIAGE RETURN - U+000A LINE FEED (CRLF) character
    pairs.</li>
 
-  </ol><p class=XXX> ... <dfn id=attr-textarea-maxlength title=attr-textarea-maxlength><code>maxlength</code></dfn>
-
-  <p class=XXX> ... <dfn id=attr-textarea-required title=attr-textarea-required><code>required</code></dfn>
+  </ol><p>The <dfn id=attr-textarea-maxlength title=attr-textarea-maxlength><code>maxlength</code></dfn>
+  attribute is a <a href=#attr-fe-maxlength title=attr-fe-maxlength>form control <code title="">maxlength</code> attribute</a> controlled by the
+  <code><a href=#the-textarea-element>textarea</a></code> element's <a href=#concept-textarea-dirty title=concept-textarea-dirty>dirty value flag</a>.<p>If the <code><a href=#the-textarea-element>textarea</a></code> element has a <a href=#maximum-allowed-value-length>maximum allowed
+  value length</a>, then the element's children must be such that
+  the <a href=#codepoint-length>codepoint length</a> of the value of the element's
+  <code><a href=#textcontent>textContent</a></code> DOM attribute is equal to or less than the
+  element's <a href=#maximum-allowed-value-length>maximum allowed value length</a>.<p class=XXX> ... <dfn id=attr-textarea-required title=attr-textarea-required><code>required</code></dfn>
 
   <p class=XXX> ... <dfn id=attr-textarea-accept title=attr-textarea-accept><code>accept</code></dfn>
 
@@ -21955,7 +21948,22 @@
    the document was loaded.</p>
    <pre>&lt;input maxlength="256" name="q" value="" autofocus&gt;
 &lt;input type="submit" value="Search"&gt;</pre>
-  </div><h4 id=attributes-for-form-submission><span class=secno>4.10.14 </span><dfn>Attributes for form submission</dfn></h4><p class=XXX>... <dfn id=attr-fs-action title=attr-fs-action>action</dfn> content attribute<p class=XXX>... <dfn id=dom-fs-action title=dom-fs-action>action</dfn> DOM attribute<p class=XXX>... <dfn id=concept-fs-action title=concept-fs-action>action</dfn> if present else form's else default</p><!-- XXX mozilla bug 297761 --><p class=XXX>... <dfn id=attr-fs-method title=attr-fs-method>method</dfn> content attribute<p class=XXX>... <dfn id=dom-fs-method title=dom-fs-method>method</dfn> DOM attribute<p class=XXX>... <dfn id=concept-fs-method title=concept-fs-method>method</dfn> if present else form's else default<p class=XXX>... <dfn id=attr-fs-enctype title=attr-fs-enctype>enctype</dfn> content attribute<p class=XXX>... <dfn id=dom-fs-enctype title=dom-fs-enctype>enctype</dfn> DOM attribute<p class=XXX>... <dfn id=concept-fs-enctype title=concept-fs-enctype>enctype</dfn> if present else form's else default<p class=XXX>... <dfn id=attr-fs-target title=attr-fs-target>target</dfn> content attribute<p class=XXX>... <dfn id=dom-fs-target title=dom-fs-target>target</dfn> DOM attribute<p class=XXX>... <dfn id=concept-fs-target title=concept-fs-target>target</dfn> if present else form's else base target else default</p><!-- c.f. hyperlink following --><p>Attributes for form submission can be specified both on
+  </div><h5 id=limiting-user-input-length><span class=secno>4.10.13.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>If an element has its <a href=#attr-fe-maxlength title=attr-fe-maxlength>form
+  control <code title="">maxlength</code> attribute</a> specified,
+  the attribute's value must be a <a href=#valid-non-negative-integer>valid non-negative
+  integer</a>. If the attribute is specified and applying the
+  <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a> to its value
+  results in a number, then that number is the element's <dfn id=maximum-allowed-value-length>maximum
+  allowed value length</dfn>. If the attribute is omitted or parsing
+  its value results in an error, then there is no <a href=#maximum-allowed-value-length>maximum
+  allowed value length</a>.<p><strong>Constraint validation:</strong> If an element has a
+  <a href=#maximum-allowed-value-length>maximum allowed value length</a>, and its <var title="">dirty value flag</var> is false, and the <a href=#codepoint-length>codepoint
+  length</a> of the element's <a href=#concept-fe-value title=concept-fe-value>value</a> is greater than the element's
+  <a href=#maximum-allowed-value-length>maximum allowed value length</a>, then the element is
+  <a href=#suffering-from-being-too-long>suffering from being too long</a>.<p>User agents may prevent the user from causing the element's <a href=#concept-fe-value title=concept-fe-value>value</a> to be set to a value whose
+  <a href=#codepoint-length>codepoint length</a> is greater than the element's
+  <a href=#maximum-allowed-value-length>maximum allowed value length</a>.<h4 id=attributes-for-form-submission><span class=secno>4.10.14 </span><dfn>Attributes for form submission</dfn></h4><p class=XXX>... <dfn id=attr-fs-action title=attr-fs-action>action</dfn> content attribute<p class=XXX>... <dfn id=dom-fs-action title=dom-fs-action>action</dfn> DOM attribute<p class=XXX>... <dfn id=concept-fs-action title=concept-fs-action>action</dfn> if present else form's else default</p><!-- XXX mozilla bug 297761 --><p class=XXX>... <dfn id=attr-fs-method title=attr-fs-method>method</dfn> content attribute<p class=XXX>... <dfn id=dom-fs-method title=dom-fs-method>method</dfn> DOM attribute<p class=XXX>... <dfn id=concept-fs-method title=concept-fs-method>method</dfn> if present else form's else default<p class=XXX>... <dfn id=attr-fs-enctype title=attr-fs-enctype>enctype</dfn> content attribute<p class=XXX>... <dfn id=dom-fs-enctype title=dom-fs-enctype>enctype</dfn> DOM attribute<p class=XXX>... <dfn id=concept-fs-enctype title=concept-fs-enctype>enctype</dfn> if present else form's else default<p class=XXX>... <dfn id=attr-fs-target title=attr-fs-target>target</dfn> content attribute<p class=XXX>... <dfn id=dom-fs-target title=dom-fs-target>target</dfn> DOM attribute<p class=XXX>... <dfn id=concept-fs-target title=concept-fs-target>target</dfn> if present else form's else base target else default</p><!-- c.f. hyperlink following --><p>Attributes for form submission can be specified both on
   <code><a href=#the-form-element>form</a></code> elements and on elements that represent buttons
   that submit forms, e.g. an <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a> state. The
   attributes on the buttons, when omitted, default to the values given
Received on Thursday, 9 October 2008 23:57:25 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 23:57:26 GMT