[e] (0) Try to explain type=image better.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=13448 git-svn-id: http://svn.whatwg.org/webapps@6433 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Aug 12, 2011 · 8791a81 · 8791a81
1 parent 29973f5
commit 8791a81
Show file tree

Hide file tree

Showing 3 changed files with 58 additions and 0 deletions.
diff --git a/complete.html b/complete.html
@@ -46830,6 +46830,11 @@ <h6 id=image-button-state><span class=secno>4.10.7.1.20 </span><dfn title=attr-i
   specifically a <a href=#concept-submit-button title=concept-submit-button>submit
   button</a>.</p>
 
+  <p class=note>The coordinate is sent to the server <a href=#constructing-the-form-data-set title="constructing the form data set">during form submission</a>
+  by sending two entries for the element, derived from the name of the
+  control but with "<code title="">.x</code>" and "<code title="">.y</code>" appended to the name with the <var title="">x</var> and <var title="">y</var> components of the
+  coordinate respectively.</p>
+
   <hr><p>The image is given by the <dfn id=attr-input-src title=attr-input-src><code>src</code></dfn> attribute. The <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute must be present, and
   must contain a <a href=#valid-non-empty-url-potentially-surrounded-by-spaces>valid non-empty URL potentially surrounded by
   spaces</a> referencing a non-interactive, optionally animated,
@@ -47033,6 +47038,19 @@ <h6 id=image-button-state><span class=secno>4.10.7.1.20 </span><dfn title=attr-i
   to read that section, where many of the same requirements are
   described in more detail.</p>
 
+  <div class=example>
+
+   <p>Take the following form:</p>
+
+   <pre>&lt;form action="process.cgi"&gt;
+ &lt;input type=image src=map.png name=where&gt;
+&lt;/form&gt;</pre>
+
+   <p>If the user clicked on the image at coordinate (127,40) then the
+   URL used to submit the form would be "<code title="">process.cgi?where.x=127&amp;where.y=40</code>".</p>
+
+  </div>
+
 
 
   <h6 id=reset-button-state><span class=secno>4.10.7.1.21 </span><dfn title=attr-input-type-reset>Reset Button</dfn> state</h6>

diff --git a/index b/index
@@ -46697,6 +46697,11 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
   specifically a <a href=#concept-submit-button title=concept-submit-button>submit
   button</a>.</p>
 
+  <p class=note>The coordinate is sent to the server <a href=#constructing-the-form-data-set title="constructing the form data set">during form submission</a>
+  by sending two entries for the element, derived from the name of the
+  control but with "<code title="">.x</code>" and "<code title="">.y</code>" appended to the name with the <var title="">x</var> and <var title="">y</var> components of the
+  coordinate respectively.</p>
+
   <hr><p>The image is given by the <dfn id=attr-input-src title=attr-input-src><code>src</code></dfn> attribute. The <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute must be present, and
   must contain a <a href=#valid-non-empty-url-potentially-surrounded-by-spaces>valid non-empty URL potentially surrounded by
   spaces</a> referencing a non-interactive, optionally animated,
@@ -46900,6 +46905,19 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
   to read that section, where many of the same requirements are
   described in more detail.</p>
 
+  <div class=example>
+
+   <p>Take the following form:</p>
+
+   <pre>&lt;form action="process.cgi"&gt;
+ &lt;input type=image src=map.png name=where&gt;
+&lt;/form&gt;</pre>
+
+   <p>If the user clicked on the image at coordinate (127,40) then the
+   URL used to submit the form would be "<code title="">process.cgi?where.x=127&amp;where.y=40</code>".</p>
+
+  </div>
+
 
 
   <h6 id=reset-button-state><span class=secno>4.10.7.1.21 </span><dfn title=attr-input-type-reset>Reset Button</dfn> state</h6>

diff --git a/source b/source
@@ -52272,6 +52272,14 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
   specifically a <span title="concept-submit-button">submit
   button</span>.</p>
 
+  <p class="note">The coordinate is sent to the server <span
+  title="constructing the form data set">during form submission</span>
+  by sending two entries for the element, derived from the name of the
+  control but with "<code title="">.x</code>" and "<code
+  title="">.y</code>" appended to the name with the <var
+  title="">x</var> and <var title="">y</var> components of the
+  coordinate respectively.</p>
+
   <hr>
 
   <p>The image is given by the <dfn
@@ -52536,6 +52544,20 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
   to read that section, where many of the same requirements are
   described in more detail.</p>
 
+  <div class="example">
+
+   <p>Take the following form:</p>
+
+   <pre>&lt;form action="process.cgi">
+ &lt;input type=image src=map.png name=where>
+&lt;/form></pre>
+
+   <p>If the user clicked on the image at coordinate (127,40) then the
+   URL used to submit the form would be "<code
+   title="">process.cgi?where.x=127&where.y=40</code>".</p>
+
+  </div>
+
 
 
   <h6><dfn title="attr-input-type-reset">Reset Button</dfn> state</h6>