- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 12 Feb 2009 02:48:35 +0000
- To: public-html-commits@w3.org
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><p>Account: <input type="text" name="ac" autocomplete="off"></p>
<p>PIN: <input type="text" name="pin" autocomplete="off"></p></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