Skip to content
Permalink
Browse files
[giow] (1) Clarify formats for autofill fields
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=22286
Affected topics: HTML

git-svn-id: http://svn.whatwg.org/webapps@7983 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Jun 17, 2013
1 parent b74c620 commit d1cb8a7fb6a3b1addfa9859d9da3c81b0034d145
Show file tree
Hide file tree
Showing 3 changed files with 193 additions and 40 deletions.
@@ -256,7 +256,7 @@

<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 15 June 2013</h2>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 17 June 2013</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -53674,147 +53674,194 @@ <h5 id=autofilling-form-controls:-the-autocomplete-attribute><span class=secno>4

<table><thead><tr><th colspan=4> Field name
<th> Meaning
<th> Example
<th> Canonical Format
<th> Canonical Format Example
<tbody><tr><td colspan=4>"<dfn id=attr-fe-autocomplete-name title=attr-fe-autocomplete-name><code>name</code></dfn>"
<td>Full name
<td>Free-form text, no newlines
<td>Sir Timothy John Berners-Lee, OM, KBE, FRS, FREng, FRSA
<tr><td class=non-rectangular-cell-indentation rowspan=5>
<td colspan=3>"<dfn id=attr-fe-autocomplete-honorific-prefix title=attr-fe-autocomplete-honorific-prefix><code>honorific-prefix</code></dfn>"
<td>Prefix or title (e.g. "Mr.", "Ms.", "Dr.", "<span lang=fr title="">M<sup>lle</sup></span>")
<td>Free-form text, no newlines
<td>Sir
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-given-name title=attr-fe-autocomplete-given-name><code>given-name</code></dfn>"
<td>Given name (in some Western cultures, also known as the <i>first name</i>)
<td>Free-form text, no newlines
<td>Timothy
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-additional-name title=attr-fe-autocomplete-additional-name><code>additional-name</code></dfn>"
<td>Additional names (in some Western cultures, also known as <i>middle names</i>, forenames other than the first name)
<td>Free-form text, no newlines
<td>John
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-family-name title=attr-fe-autocomplete-family-name><code>family-name</code></dfn>"
<td>Family name (in some Western cultures, also known as the <i>last name</i> or <i>surname</i>)
<td>Free-form text, no newlines
<td>Berners-Lee
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-honorific-suffix title=attr-fe-autocomplete-honorific-suffix><code>honorific-suffix</code></dfn>"
<td>Suffix (e.g. "Jr.", "B.Sc.", "MBASW", "II")
<td>Free-form text, no newlines
<td>OM, KBE, FRS, FREng, FRSA
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-nickname title=attr-fe-autocomplete-nickname><code>nickname</code></dfn>"
<td>Nickname, screen name, handle: a typically short name used instead of the full name
<td>Free-form text, no newlines
<td>Tim
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-organization-title title=attr-fe-autocomplete-organization-title><code>organization-title</code></dfn>"
<td>Job title (e.g. "Software Engineer", "Senior Vice President", "Deputy Managing Director")
<td>Free-form text, no newlines
<td>Professor
<tbody><tr><td colspan=4>"<dfn id=attr-fe-autocomplete-organization title=attr-fe-autocomplete-organization><code>organization</code></dfn>"
<td>Company name corresponding to the person, address, or contact information in the other fields associated with this field
<td>Free-form text, no newlines
<td>World Wide Web Consortium
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-street-address title=attr-fe-autocomplete-street-address><code>street-address</code></dfn>"
<td>Street address (as one line)
<td>32 Vassar Street; MIT Room 32-G524
<td>Street address (multiple lines, newlines preserved)
<td>Free-form text
<td>32 Vassar Street<br>
MIT Room 32-G524
<tr><td class=non-rectangular-cell-indentation rowspan=3>
<td colspan=3>"<dfn id=attr-fe-autocomplete-address-line1 title=attr-fe-autocomplete-address-line1><code>address-line1</code></dfn>"
<td rowspan=3>Street address (as multiple lines)
<td rowspan=3>Street address (one line per field)
<td>Free-form text, no newlines
<td>32 Vassar Street
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-address-line2 title=attr-fe-autocomplete-address-line2><code>address-line2</code></dfn>"
<td>Free-form text, no newlines
<td>MIT Room 32-G524
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-address-line3 title=attr-fe-autocomplete-address-line3><code>address-line3</code></dfn>"
<td>Free-form text, no newlines
<td>
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-locality title=attr-fe-autocomplete-locality><code>locality</code></dfn>"
<td>City, town, village, or other locality within which the relevant street address is found
<td>City, town, village, post town, or other locality within which the relevant street address is found
<td>Free-form text, no newlines
<td>Cambridge
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-region title=attr-fe-autocomplete-region><code>region</code></dfn>"
<td>Provice such as a state, county, or canton within which the locality is found
<td>Free-form text, no newlines
<td>MA
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-country title=attr-fe-autocomplete-country><code>country</code></dfn>"
<td>Country
<td>USA
<td>Valid <a href=http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm>ISO 3166-1-alpha-2 country code</a> <a href=#refsISO3166>[ISO3166]</a>
<td>US
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-postal-code title=attr-fe-autocomplete-postal-code><code>postal-code</code></dfn>"
<td>Postal code, post code, ZIP code
<td>Postal code, post code, ZIP code, CEDEX code (if CEDEX, append "CEDEX" to the <code title=attr-fe-autocomplete-locality><a href=#attr-fe-autocomplete-locality>locality</a></code> field)
<td>Free-form text, no newlines
<td>02139
<tbody><tr><td colspan=4>"<dfn id=attr-fe-autocomplete-cc-name title=attr-fe-autocomplete-cc-name><code>cc-name</code></dfn>"
<td>Full name as given on the payment instrument
<td>Free-form text, no newlines
<td>Tim Berners-Lee
<tr><td class=non-rectangular-cell-indentation rowspan=3>
<td colspan=3>"<dfn id=attr-fe-autocomplete-cc-given-name title=attr-fe-autocomplete-cc-given-name><code>cc-given-name</code></dfn>"
<td>Given name as given on the payment instrument (in some Western cultures, also known as the <i>first name</i>)
<td>Free-form text, no newlines
<td>Tim
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-cc-additional-name title=attr-fe-autocomplete-cc-additional-name><code>cc-additional-name</code></dfn>"
<td>Additional names given on the payment instrument (in some Western cultures, also known as <i>middle names</i>, forenames other than the first name)
<td>Free-form text, no newlines
<td>
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-cc-family-name title=attr-fe-autocomplete-cc-family-name><code>cc-family-name</code></dfn>"
<td>Family name given on the payment instrument (in some Western cultures, also known as the <i>last name</i> or <i>surname</i>)
<td>Free-form text, no newlines
<td>Berners-Lee
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-cc-number title=attr-fe-autocomplete-cc-number><code>cc-number</code></dfn>"
<td>Code identifying the payment instrument (e.g. the credit card number, bank account number)
<td><a href=#ascii-digits>ASCII digits</a>
<td>4114360123456785 <!-- http://www.auricsystems.com/support-center/sample-credit-card-numbers -->
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-cc-exp title=attr-fe-autocomplete-cc-exp><code>cc-exp</code></dfn>"
<td>Expiration date of the payment instrument
<td><a href=#valid-month-string>Valid month string</a>
<td>2014-12
<tr><td class=non-rectangular-cell-indentation rowspan=2>
<td colspan=3>"<dfn id=attr-fe-autocomplete-cc-exp-month title=attr-fe-autocomplete-cc-exp-month><code>cc-exp-month</code></dfn>"
<td>Month component of the expiration date of the payment instrument
<td><a href=#valid-integer>Valid integer</a> in the range 1..12
<td>12
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-cc-exp-year title=attr-fe-autocomplete-cc-exp-year><code>cc-exp-year</code></dfn>"
<td>Year component of the expiration date of the payment instrument
<td><a href=#valid-integer>Valid integer</a> greater than zero
<td>2014
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-cc-csc title=attr-fe-autocomplete-cc-csc><code>cc-csc</code></dfn>"
<td>Security code for the payment instrument (also known as the card security code (CSC), card validation code (CVC), card verification value (CVV), signature panel code (SPC), credit card ID (CCID), etc)
<td><a href=#ascii-digits>ASCII digits</a>
<td>419
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-cc-type title=attr-fe-autocomplete-cc-type><code>cc-type</code></dfn>"
<td>Type of payment instrument
<td>Free-form text, no newlines
<td>Visa
<tbody><tr><td colspan=4>"<dfn id=attr-fe-autocomplete-language title=attr-fe-autocomplete-language><code>language</code></dfn>"
<td>Preferred language
<td>English
<td>Valid BCP 47 language tag <a href=#refsBCP47>[BCP47]</a>
<td>en
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-bday title=attr-fe-autocomplete-bday><code>bday</code></dfn>"
<td>Birthday
<td><a href=#valid-date-string>Valid date string</a>
<td>1955-06-08
<tr><td class=non-rectangular-cell-indentation rowspan=3>
<td colspan=3>"<dfn id=attr-fe-autocomplete-bday-day title=attr-fe-autocomplete-bday-day><code>bday-day</code></dfn>"
<td>Day component of birthday
<td><a href=#valid-integer>Valid integer</a> in the range 1..31
<td>8
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-bday-month title=attr-fe-autocomplete-bday-month><code>bday-month</code></dfn>"
<td>Month component of birthday
<td>June
<td><a href=#valid-integer>Valid integer</a> in the range 1..12
<td>6
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-bday-year title=attr-fe-autocomplete-bday-year><code>bday-year</code></dfn>"
<td>Year component of birthday
<td><a href=#valid-integer>Valid integer</a> greater than zero
<td>1955
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-sex title=attr-fe-autocomplete-sex><code>sex</code></dfn>"
<td>Gender identity (e.g. Female, Fa'afafine)
<td>Free-form text, no newlines
<td>Male
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-url title=attr-fe-autocomplete-url><code>url</code></dfn>"
<td>Home page or other Web page corresponding to the company, person, address, or contact information in the other fields associated with this field
<td><a href=#valid-url>Valid URL</a>
<td>http://www.w3.org/People/Berners-Lee/
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-photo title=attr-fe-autocomplete-photo><code>photo</code></dfn>"
<td>Photograph, icon, or other image corresponding to the company, person, address, or contact information in the other fields associated with this field
<td>File or <a href=#valid-url>Valid URL</a>
<td>http://www.w3.org/Press/Stock/Berners-Lee/2001-europaeum-eighth.jpg
<tbody><tr><td colspan=4>"<dfn id=attr-fe-autocomplete-tel title=attr-fe-autocomplete-tel><code>tel</code></dfn>"
<td>Full telephone number, including country code
<td><a href=#ascii-digits>ASCII digits</a> and U+0020 SPACE characters, prefixed by a U+002B PLUS SIGN character (+)
<td>+1 617 253 5702
<tr><td class=non-rectangular-cell-indentation rowspan=6>
<td colspan=3>"<dfn id=attr-fe-autocomplete-tel-country-code title=attr-fe-autocomplete-tel-country-code><code>tel-country-code</code></dfn>"
<td>Country code component of the telephone number
<td><a href=#ascii-digits>ASCII digits</a> prefixed by a U+002B PLUS SIGN character (+)
<td>+1
<tr><td colspan=3>"<dfn id=attr-fe-autocomplete-tel-national title=attr-fe-autocomplete-tel-national><code>tel-national</code></dfn>"
<td>Telephone number without the county code component
<td><a href=#ascii-digits>ASCII digits</a> and U+0020 SPACE characters
<td>617 253 5702
<tr><td class=non-rectangular-cell-indentation rowspan=4>
<td colspan=2>"<dfn id=attr-fe-autocomplete-tel-area-code title=attr-fe-autocomplete-tel-area-code><code>tel-area-code</code></dfn>"
<td>Area code component of the telephone number
<td><a href=#ascii-digits>ASCII digits</a>
<td>617
<tr><td colspan=2>"<dfn id=attr-fe-autocomplete-tel-local title=attr-fe-autocomplete-tel-local><code>tel-local</code></dfn>"
<td>Telephone number without the country code and area code components
<td><a href=#ascii-digits>ASCII digits</a>
<td>2535702
<tr><td class=non-rectangular-cell-indentation rowspan=2>
<td>"<dfn id=attr-fe-autocomplete-tel-local-prefix title=attr-fe-autocomplete-tel-local-prefix><code>tel-local-prefix</code></dfn>"
<td>First part of the component of the telephone number that follows the area code, when that component is split into two components
<td><a href=#ascii-digits>ASCII digits</a>
<td>253
<tr><td>"<dfn id=attr-fe-autocomplete-tel-local-suffix title=attr-fe-autocomplete-tel-local-suffix><code>tel-local-suffix</code></dfn>"
<td>Second part of the component of the telephone number that follows the area code, when that component is split into two components
<td><a href=#ascii-digits>ASCII digits</a>
<td>5702
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-tel-extension title=attr-fe-autocomplete-tel-extension><code>tel-extension</code></dfn>"
<td>Telephone number internal extension code
<td><a href=#ascii-digits>ASCII digits</a>
<td>1000
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-email title=attr-fe-autocomplete-email><code>email</code></dfn>"
<td>E-mail address
<td><a href=#valid-e-mail-address>Valid e-mail address</a>
<td>timbl@w3.org
<tr><td colspan=4>"<dfn id=attr-fe-autocomplete-impp title=attr-fe-autocomplete-impp><code>impp</code></dfn>"
<td>URL representing an instant messaging protocol endpoint (for example, "<code title="">aim:goim?screenname=example</code>" or <code title="">xmpp:fred@example.net</code>")
<td><a href=#valid-url>Valid URL</a>
<td>irc://example.org/timbl,isuser
</table><p>If the <code title=attr-fe-autocomplete><a href=#attr-fe-autocomplete>autocomplete</a></code>
attribute is omitted, the default value corresponding to the state
@@ -54221,8 +54268,9 @@ <h5 id=autofilling-form-controls:-the-autocomplete-attribute><span class=secno>4
long</a>, <a href=#suffering-from-an-underflow title="suffering from an underflow">suffer from
an underflow</a>, <a href=#suffering-from-an-overflow title="suffering from an overflow">suffer
from an overflow</a>, or <a href=#suffering-from-a-step-mismatch title="suffering from a step
mismatch">suffer from a step mismatch</a>. Where possible, user
agents should use heuristics to attempt to convert values so that
mismatch">suffer from a step mismatch</a>. Where possible given the control's constraints, user
agents must use the format given as canonical in the aforementioned table. Where it's not possible
for the canonical format to be used, user agents should use heuristics to attempt to convert values so that
they can be used.</p>

<div class=example>
@@ -57768,9 +57816,9 @@ <h4 id=the-dialog-element><span class=secno>4.11.7 </span>The <dfn><code>dialog<
boxes, <var title="">A</var> and <var title="">B</var> cease being in the same
<code><a href=#document>Document</a></code>, or <var title="">B</var> ceases being earlier than <var title="">A</var>
in <a href=#tree-order>tree order</a>, let <var title="">subject</var> be <span>mundanely
positioned</span>, and <a href=#set-up-the-default-static-position>set up the default static position</a> of <var title="">subject</var> without an anchor.</li>
positioned</span>, and <a href=#set-up-the-default-static-position>set up the default static position</a> of <var title="">subject</var> without an anchor.</p>


</li>

<li>

@@ -101689,6 +101737,9 @@ <h2 class=no-num id=references>References</h2><!--REFS-->
<dt id=refsIANAPERMHEADERS>[IANAPERMHEADERS]</dt>
<dd><cite><a href=http://www.iana.org/assignments/message-headers/perm-headers.html>Permanent Message Header Field Names</a></cite>. IANA.</dd>

<dt id=refsISO3166>[ISO3166]</dt>
<dd><cite><a href=http://www.iso.org/iso/home/standards/country_codes.htm>ISO 3166: Codes for the representation of names of countries and their subdivisions</a></cite>. ISO.</dd>

<dt id=refsISO8601>[ISO8601]</dt>
<dd>(Non-normative) <cite><a href="http://isotc.iso.org/livelink/livelink/4021199/ISO_8601_2004_E.zip?func=doc.Fetch&amp;nodeid=4021199">ISO8601: Data elements and interchange formats &mdash; Information interchange &mdash; Representation of dates and times</a></cite>. ISO.</dd>

0 comments on commit d1cb8a7

Please sign in to comment.