[html5] r5206 - [e] (0) Explain the magic name='' values.

whatwg at whatwg.org whatwg at whatwg.org
Tue Jul 27 14:40:25 PDT 2010


Author: ianh
Date: 2010-07-27 14:40:23 -0700 (Tue, 27 Jul 2010)
New Revision: 5206

Modified:
   complete.html
   index
   source
Log:
[e] (0) Explain the magic name='' values.

Modified: complete.html
===================================================================
--- complete.html	2010-07-27 19:40:15 UTC (rev 5205)
+++ complete.html	2010-07-27 21:40:23 UTC (rev 5206)
@@ -38218,7 +38218,7 @@
 
   <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.</p>
 
@@ -44516,8 +44516,26 @@
   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.</p>
 
-  <div class=impl>
+  <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:</p>
 
+  <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>
 
@@ -45876,7 +45894,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>
 
@@ -45948,7 +45966,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
@@ -45986,7 +46004,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>
 
@@ -46027,9 +46045,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>
@@ -82760,7 +82777,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>

Modified: index
===================================================================
--- index	2010-07-27 19:40:15 UTC (rev 5205)
+++ index	2010-07-27 21:40:23 UTC (rev 5206)
@@ -38145,7 +38145,7 @@
 
   <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.</p>
 
@@ -44443,8 +44443,26 @@
   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.</p>
 
-  <div class=impl>
+  <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:</p>
 
+  <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>
 
@@ -45803,7 +45821,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>
 
@@ -45875,7 +45893,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
@@ -45913,7 +45931,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>
 
@@ -45954,9 +45972,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>
@@ -75802,7 +75819,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>

Modified: source
===================================================================
--- source	2010-07-27 19:40:15 UTC (rev 5205)
+++ source	2010-07-27 21:40:23 UTC (rev 5206)
@@ -42537,7 +42537,8 @@
 
   <p>If the <code title="attr-input-value">name</code> attribute is
   present and has a value that is a <span>case-sensitive</span> match
-  for the string "<code title="">_charset_</code>", then the element's
+  for the string "<code
+  title="attr-fe-name-charset">_charset_</code>", then the element's
   <code title="attr-input-value">value</code> attribute must be
   omitted.</p>
 
@@ -49843,6 +49844,34 @@
   title="dom-form-elements">elements</code> object. If the attribute
   is specified, its value must not be the empty string.</p>
 
+  <p>Any non-empty value for <code title="attr-form-name">name</code>
+  is allowed, but the names "<code
+  title="attr-fe-name-charset">_charset_</code>" and "<code
+  title="attr-fe-name-isindex">isindex</code>" are special:</p>
+
+  <dl>
+
+   <dt><dfn title="attr-fe-name-isindex"><code>isindex</code></dfn></dt>
+   <dd>
+    <p>This value, if used as the name of a <span
+    title="attr-input-type-text">Text</span> control that is the only
+    control in a form that is submitted using the <code
+    title="attr-fs-enctype-urlencoded">application/x-www-form-urlencoded</code>
+    mechanism, causes the submission to only include the value of this
+    control, with on name.</p>
+   </dd>
+
+   <dt><dfn title="attr-fe-name-charset"><code>_charset_</code></dfn></dt>
+   <dd>
+    <p>This value, if used as the name of a <span
+    title="attr-input-type-hidden">Hidden</span> control with no <code
+    title="attr-input-value">value</code> attribute, is automatically
+    given a value during submission consisting of the submission
+    character encoding.</p>
+   </dd>
+
+  </dl>
+
   <div class="impl">
 
   <p>The <dfn title="dom-fe-name"><code>name</code></dfn> IDL
@@ -51492,7 +51521,7 @@
 
     <ol>
 
-     <li><p>If the entry's name is "<code title="">_charset_</code>"
+     <li><p>If the entry's name is "<code title="attr-fe-name-charset">_charset_</code>"
      and its type is "<code title="">hidden</code>", replace its value
      with <var title="">charset</var>.</p></li>
 
@@ -51576,7 +51605,7 @@
 
      </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">isindex</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
@@ -51622,7 +51651,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
+  name is "<code title="attr-fe-name-charset">_charset_</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>
@@ -51669,9 +51698,10 @@
    <li><p>Let <var title="">charset</var> be the <span>preferred MIME
    name</span> of the selected character encoding.</p></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>.</p></li>
+   <li><p>If the entry's name is "<code
+   title="attr-fe-name-charset">_charset_</code>" and its type is
+   "<code title="">hidden</code>", replace its value with <var
+   title="">charset</var>.</p></li>
 
    <li><p>If the entry's type is "<code title="">file</code>", replace
    its value with the file's filename only.</p></li>
@@ -94482,7 +94512,7 @@
     "name", "action", and "prompt". Set the <code
     title="attr-fe-name">name</code> attribute of the resulting
     <code>input</code> element to the value "<code
-    title="">isindex</code>".</p>
+    title="attr-fe-name-isindex">isindex</code>".</p>
 
     <p>Act as if a stream of character tokens had been seen (see
     below for what they should say).</p>




More information about the Commit-Watchers mailing list