html5/spec Overview.html,1.1968,1.1969

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

Modified Files:
	Overview.html 
Log Message:
Support <form autocomplete> (whatwg r2798)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1968
retrieving revision 1.1969
diff -u -d -r1.1968 -r1.1969
--- Overview.html	12 Feb 2009 01:58:14 -0000	1.1968
+++ Overview.html	12 Feb 2009 02:48:32 -0000	1.1969
@@ -19809,6 +19809,7 @@
    <dd><a href=#global-attributes>Global attributes</a></dd>
    <dd><code title=attr-form-accept-charset><a href=#attr-form-accept-charset>accept-charset</a></code></dd>
    <dd><code title=attr-fs-action><a href=#attr-fs-action>action</a></code></dd>
+   <dd><code title=attr-form-autocomplete><a href=#attr-form-autocomplete>autocomplete</a></code></dd>
    <dd><code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code></dd>
    <dd><code title=attr-fs-method><a href=#attr-fs-method>method</a></code></dd>
    <dd><code title=attr-form-name><a href=#attr-form-name>name</a></code></dd>
@@ -19820,6 +19821,7 @@
 interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
            attribute DOMString <a href=#dom-form-acceptcharset title=dom-form-acceptCharset>acceptCharset</a>;
            attribute DOMString <a href=#dom-fs-action title=dom-fs-action>action</a>;
+           attribute boolean <a href=#dom-form-autocomplete title=dom-form-autocomplete>autocomplete</a>;
            attribute DOMString <a href=#dom-fs-enctype title=dom-fs-enctype>enctype</a>;
            attribute DOMString <a href=#dom-fs-method title=dom-fs-method>method</a>;
            attribute DOMString <a href=#dom-form-name title=dom-form-name>name</a>;
@@ -19850,11 +19852,24 @@
   encoding</a>. <a href=#references>[IANACHARSET]</a><p>The <dfn id=attr-form-name title=attr-form-name><code>name</code></dfn> attribute
   represents the <code><a href=#the-form-element>form</a></code>'s name within the <code title=dom-forms>forms</code> collection. The value must not be the
   empty string, and the value must be unique amongst the
-  <code><a href=#the-form-element>form</a></code> elements in the <code title=dom-forms>forms</code> collection that it is in, if any.<p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, <code title=attr-fs-novalidate><a href=#attr-fs-novalidate>novalidate</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes are <a href=#form-submission>attributes
-  for form submission</a>.<p>The <dfn id=dom-form-acceptcharset title=dom-form-acceptCharset><code>acceptCharset</code></dfn>
-  and <dfn id=dom-form-name title=dom-form-name><code>name</code></dfn> DOM
-  attributes must <a href=#reflect>reflect</a> the respective content
-  attributes of the same name.<p>The <dfn id=dom-form-elements title=dom-form-elements><code>elements</code></dfn>
+  <code><a href=#the-form-element>form</a></code> elements in the <code title=dom-forms>forms</code> collection that it is in, if any.<p>The <dfn id=attr-form-autocomplete title=attr-form-autocomplete><code>autocomplete</code></dfn>
+  attribute is an <a href=#enumerated-attribute>enumerated attribute</a>. The attribute has
+  two states. The <code title=attr-form-autocomplete-on>on</code>
+  keyword maps to the <dfn id=attr-form-autocomplete-on-state title=attr-form-autocomplete-on-state>on</dfn> state, and the
+  <code title=attr-form-autocomplete-off>off</code> keyword maps to
+  the <dfn id=attr-form-autocomplete-off-state title=attr-form-autocomplete-off-state>off</dfn>
+  state. The attribute may also be omitted. The <i>missing value
+  default</i> is the <a href=#attr-form-autocomplete-on-state title=attr-form-autocomplete-on-state>on</a> state. The <a href=#attr-form-autocomplete-off-state title=attr-form-autocomplete-off-state>off</a> state indicates
+  that by default, <code><a href=#the-input-element>input</a></code> elements in the form will have
+  their <a href=#resulting-autocompletion-state>resulting autocompletion state</a> set to <i title="">off</i>; the <a href=#attr-form-autocomplete-on-state title=attr-form-autocomplete-on-state>on</a> state indicates
+  that by default, <code><a href=#the-input-element>input</a></code> elements in the form will have
+  their <a href=#resulting-autocompletion-state>resulting autocompletion state</a> set to <i title="">on</i>.<p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, <code title=attr-fs-novalidate><a href=#attr-fs-novalidate>novalidate</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes are <a href=#form-submission>attributes
+  for form submission</a>.<p>The <dfn id=dom-form-autocomplete title=dom-form-autocomplete><code>autocomplete</code></dfn> and
+  <dfn id=dom-form-name title=dom-form-name><code>name</code></dfn> DOM attributes
+  must <a href=#reflect>reflect</a> the respective content attributes of the
+  same name.<p>The <dfn id=dom-form-acceptcharset title=dom-form-acceptCharset><code>acceptCharset</code></dfn> DOM
+  attribute must <a href=#reflect>reflect</a> the <code title=attr-form-accept-charset><a href=#attr-form-accept-charset>accept-charset</a></code> content
+  attribute.<p>The <dfn id=dom-form-elements title=dom-form-elements><code>elements</code></dfn>
   DOM attribute must return an <code><a href=#htmlformcontrolscollection-0>HTMLFormControlsCollection</a></code>
   rooted at the <code>Document</code> node, whose filter matches <a href=#category-listed title=category-listed>listed</a> elements whose <a href=#form-owner>form
   owner</a> is the <code><a href=#the-form-element>form</a></code> element, with the exception of
@@ -22847,16 +22862,15 @@
   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
-  agents must <a href=#ignore>ignore</a> the attribute.<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><!-- IE also applies it to <form> elements, but only 0.09% of pages
-  use it there, so we don't support that. (It doesn't apply it to
-  <textarea>, so we don't support it there either.) --><p>The <dfn id=attr-input-autocomplete title=attr-input-autocomplete><code>autocomplete</code></dfn>
+  agents must <a href=#ignore>ignore</a> the attribute.<h6 id=the-autocomplete-attribute><span class=secno>4.10.4.2.1 </span>The <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute</h6><p>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
-  two states. The <code title=attr-input-autocomplete-on>on</code>
+  three states. The <code title=attr-input-autocomplete-on>on</code>
   keyword maps to the <dfn id=attr-input-autocomplete-on-state title=attr-input-autocomplete-on-state>on</dfn> state, and the
   <code title=attr-input-autocomplete-off>off</code> keyword maps to
   the <dfn id=attr-input-autocomplete-off-state title=attr-input-autocomplete-off-state>off</dfn>
   state. The attribute may also be omitted. The <i>missing value
-  default</i> is the <a href=#attr-input-autocomplete-on-state title=attr-input-autocomplete-on-state>on</a> state.<p>The <a href=#attr-input-autocomplete-off-state title=attr-input-autocomplete-off-state>off</a>
+  default</i> is the <dfn id=attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</dfn>
+  state.<p>The <a href=#attr-input-autocomplete-off-state title=attr-input-autocomplete-off-state>off</a>
   state indicates that the control's input data is either particularly
   sensitive (for example the activation code for a nuclear weapon) or
   is a value that will never be reused (for example a one-time-key for
@@ -22865,13 +22879,26 @@
   prefill the value for him.<p>Conversely, the <a href=#attr-input-autocomplete-on-state title=attr-input-autocomplete-on-state>on</a> state indicates
   that the value is not particularly sensitive and the user can expect
   to be able to rely on his user agent to remember values he has
-  entered for that control.<p>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute is in
+  entered for that control.<p>The <a href=#attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</a> state
+  indicates that the user agent is to use the <code title=attr-form-autocomplete><a href=#attr-form-autocomplete>autocomplete</a></code> attribute on the
+  element's <a href=#form-owner>form owner</a> instead.<p>Each <code><a href=#the-input-element>input</a></code> element has a <dfn id=resulting-autocompletion-state>resulting
+  autocompletion state</dfn>, which is either <i title="">on</i> or <i title="">off</i>.<p>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute is in
   the <a href=#attr-input-autocomplete-on-state title=attr-input-autocomplete-on-state>on</a> state,
-  the user agent may store the value entered by the user so that if
-  the user returns to the page, the UA can prefill the form. When an
+  when an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute is in
+  the <a href=#attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</a> state,
+  and the element has no <a href=#form-owner>form owner</a>, and when an
   <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute is in
-  the <a href=#attr-input-autocomplete-off-state title=attr-input-autocomplete-off-state>off</a>
-  state, the user agent should not remember the control's <a href=#concept-fe-value title=concept-fe-value>value</a>.<p>The autocompletion mechanism must be implemented by the user
+  the <a href=#attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</a> state,
+  and the element's <a href=#form-owner>form owner</a>'s <code title=attr-form-autocomplete><a href=#attr-form-autocomplete>autocomplete</a></code> attribute is in
+  the <a href=#attr-form-autocomplete-on-state title=attr-form-autocomplete-on-state>on</a> state,
+  the <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting autocompletion
+  state</a> is <i title="">on</i>. Otherwise, the
+  <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting autocompletion
+  state</a> is <i title="">off</i>.<p>When an <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting
+  autocompletion state</a> is <i title="">on</i>, the user agent
+  may store the value entered by the user so that if the user returns
+  to the page, the UA can prefill the form. Otherwise, the user agent
+  should not remember the control's <a href=#concept-fe-value title=concept-fe-value>value</a>.<p>The autocompletion mechanism must be implemented by the user
   agent acting as if the user had modified the element's <a href=#concept-fe-value title=concept-fe-value>value</a>, and must be done at a time
   where the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>
   (e.g. just after the element has been inserted into the document, or
@@ -22884,15 +22911,12 @@
    <pre>&lt;p&gt;Account: &lt;input type="text" name="ac" autocomplete="off"&gt;&lt;/p&gt;
 &lt;p&gt;PIN: &lt;input type="text" name="pin" autocomplete="off"&gt;&lt;/p&gt;</pre>
 
-  </div><p>A user agent may allow the user to disable support for this
-  attribute's <a href=#attr-input-autocomplete-off-state title=attr-input-autocomplete-off-state>off</a> state (causing
-  the attribute to always be in the <a href=#attr-input-autocomplete-on-state title=attr-input-autocomplete-on-state>on</a> state and always
-  allowing values to be remembered and prefilled). Support for the
-  <a href=#attr-input-autocomplete-off-state title=attr-input-autocomplete-off-state>off</a> state
-  should be enabled by default, and the ability to disable support
-  should not be trivially accessible, as there are significant
-  security implications for the user if support for this attribute is
-  disabled.<h6 id=the-list-attribute><span class=secno>4.10.4.2.2 </span>The <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute</h6><p>The <dfn id=attr-input-list title=attr-input-list><code>list</code></dfn>
+  </div><p>A user agent may allow the user to override the <a href=#resulting-autocompletion-state>resulting
+  autocompletion state</a> and set it to always <i title="">on</i>,
+  always allowing values to be remembered and prefilled), or always <i title="">off</i>, never remembering values. However, the ability to
+  override the <a href=#resulting-autocompletion-state>resulting autocompletion state</a> to <i title="">on</i> should not be trivially accessible, as there are
+  significant security implications for the user if all values are
+  always remembered, regardless of the site's preferences.<h6 id=the-list-attribute><span class=secno>4.10.4.2.2 </span>The <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute</h6><p>The <dfn id=attr-input-list title=attr-input-list><code>list</code></dfn>
   attribute is used to identify an element that lists predefined
   options suggested to the user.<p>If present, its value must be the ID of a <code><a href=#the-datalist-element>datalist</a></code>
   element in the same document.<p>The <dfn id=concept-input-list title=concept-input-list>suggestions source

Received on Thursday, 12 February 2009 02:48:43 UTC