- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 27 Jul 2010 21:40:32 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv5928
Modified Files:
Overview.html
Log Message:
Explain the magic name='' values. (whatwg r5206)
Index: Overview.html
===================================================================
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:40:35 UTC