hixie: Explain the magic name='' values. (whatwg r5206)

hixie: Explain the magic name='' values. (whatwg r5206)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4140&r2=1.4141&f=h
http://html5.org/tools/web-apps-tracker?from=5205&to=5206

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4140
retrieving revision 1.4141
diff -u -d -r1.4140 -r1.4141
--- Overview.html 27 Jul 2010 19:40:20 -0000 1.4140
+++ Overview.html 27 Jul 2010 21:40:29 -0000 1.4141
@@ -28169,7 +28169,7 @@
 
   </div><p>If the <code title="attr-input-value"><a href="#attr-input-value">name</a></code> attribute is
   present and has a value that is a <a href="#case-sensitive">case-sensitive</a> match
-  for the string "<code title="">_charset_</code>", then the element's
+  for the string "<code title="attr-fe-name-charset"><a href="#attr-fe-name-charset">_charset_</a></code>", then the element's
   <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute must be
   omitted.<div class="bookkeeping">
 
@@ -33596,7 +33596,23 @@
   </div><h4 id="attributes-common-to-form-controls"><span class="secno">4.10.19 </span><dfn>Attributes common to form controls</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h5 id="naming-form-controls"><span class="secno">4.10.19.1 </span>Naming form controls</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-fe-name" title="attr-fe-name"><code>name</code></dfn> content
   attribute gives the name of the form control, as used in <a href="#form-submission">form
   submission</a> and in the <code><a href="#the-form-element">form</a></code> element's <code title="dom-form-elements"><a href="#dom-form-elements">elements</a></code> object. If the attribute
-  is specified, its value must not be the empty string.<div class="impl">
+  is specified, its value must not be the empty string.<p>Any non-empty value for <code title="attr-form-name"><a href="#attr-form-name">name</a></code>
+  is allowed, but the names "<code title="attr-fe-name-charset"><a href="#attr-fe-name-charset">_charset_</a></code>" and "<code title="attr-fe-name-isindex"><a href="#attr-fe-name-isindex">isindex</a></code>" are special:<dl><dt><dfn id="attr-fe-name-isindex" title="attr-fe-name-isindex"><code>isindex</code></dfn></dt>
+   <dd>
+    <p>This value, if used as the name of a <a href="#text-state-and-search-state" title="attr-input-type-text">Text</a> control that is the only
+    control in a form that is submitted using the <code title="attr-fs-enctype-urlencoded"><a href="#attr-fs-enctype-urlencoded">application/x-www-form-urlencoded</a></code>
+    mechanism, causes the submission to only include the value of this
+    control, with on name.</p>
+   </dd>
+
+   <dt><dfn id="attr-fe-name-charset" title="attr-fe-name-charset"><code>_charset_</code></dfn></dt>
+   <dd>
+    <p>This value, if used as the name of a <a href="#hidden-state" title="attr-input-type-hidden">Hidden</a> control with no <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, is automatically
+    given a value during submission consisting of the submission
+    character encoding.</p>
+   </dd>
+
+  </dl><div class="impl">
 
   <p>The <dfn id="dom-fe-name" title="dom-fe-name"><code>name</code></dfn> IDL
   attribute must <a href="#reflect">reflect</a> the <code title="attr-fe-name"><a href="#attr-fe-name">name</a></code> content attribute.</p>
@@ -34820,7 +34836,7 @@
     <p>For each entry in the <var title="">form data set</var>,
     perform these substeps:</p>
 
-    <ol><li><p>If the entry's name is "<code title="">_charset_</code>"
+    <ol><li><p>If the entry's name is "<code title="attr-fe-name-charset"><a href="#attr-fe-name-charset">_charset_</a></code>"
      and its type is "<code title="">hidden</code>", replace its value
      with <var title="">charset</var>.</li>
 
@@ -34892,7 +34908,7 @@
 
       </dl></li>
 
-     <li><p>If the entry's name is "<code title="">isindex</code>",
+     <li><p>If the entry's name is "<code title="attr-fe-name-isindex"><a href="#attr-fe-name-isindex">isindex</a></code>",
      its type is "<code title="">text</code>", and this is the first
      entry in the <var title="">form data set</var>, then append the
      value to <var title="">result</var> and skip the rest of the
@@ -34926,7 +34942,7 @@
   <p>Each entry in the <var title="">form data set</var> is a
   <i>field</i>, the name of the entry is the <i>field name</i> and the
   value of the entry is the <i>field value</i>, unless the entry's
-  name is "<code title="">_charset_</code>" and its type is "<code title="">hidden</code>", in which case the <i>field value</i> is the
+  name is "<code title="attr-fe-name-charset"><a href="#attr-fe-name-charset">_charset_</a></code>" and its type is "<code title="">hidden</code>", in which case the <i>field value</i> is the
   character encoding used by the aforementioned algorithm to encode
   the value of the field.</p>
 
@@ -34963,9 +34979,8 @@
    <li><p>Let <var title="">charset</var> be the <a href="#preferred-mime-name">preferred MIME
    name</a> of the selected character encoding.</li>
 
-   <li><p>If the entry's name is "<code title="">_charset_</code>" and
-   its type is "<code title="">hidden</code>", replace its value with
-   <var title="">charset</var>.</li>
+   <li><p>If the entry's name is "<code title="attr-fe-name-charset"><a href="#attr-fe-name-charset">_charset_</a></code>" and its type is
+   "<code title="">hidden</code>", replace its value with <var title="">charset</var>.</li>
 
    <li><p>If the entry's type is "<code title="">file</code>", replace
    its value with the file's filename only.</li>
@@ -57326,7 +57341,7 @@
     <p>Act as if a start tag token with the tag name "input" had been
     seen, with all the attributes from the "isindex" token except
     "name", "action", and "prompt". Set the <code title="attr-fe-name"><a href="#attr-fe-name">name</a></code> attribute of the resulting
-    <code><a href="#the-input-element">input</a></code> element to the value "<code title="">isindex</code>".</p>
+    <code><a href="#the-input-element">input</a></code> element to the value "<code title="attr-fe-name-isindex"><a href="#attr-fe-name-isindex">isindex</a></code>".</p>
 
     <p>Act as if a stream of character tokens had been seen (see
     below for what they should say).</p>

Received on Tuesday, 27 July 2010 21:41:21 UTC