Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[] (0) WF2: Attributes for form submission
git-svn-id: http://svn.whatwg.org/webapps@2318 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Oct 10, 2008
1 parent d54ba81 commit e7d96a8
Show file tree
Hide file tree
Showing 2 changed files with 172 additions and 48 deletions.
105 changes: 77 additions & 28 deletions index
Expand Up @@ -27322,36 +27322,79 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme

<h4 id=attributes-for-form-submission><span class=secno>4.10.14 </span><dfn>Attributes for form submission</dfn></h4>

<p class=XXX>... <dfn id=attr-fs-action title=attr-fs-action>action</dfn> content attribute</p>
<p>Attributes for form submission can be specified both on
<code><a href=#the-form-element>form</a></code> elements and on elements that represent buttons
that submit forms, e.g. an <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a> state. The
attributes on the buttons, when omitted, default to the values given
on the corresponding the <code><a href=#the-form-element>form</a></code> element.</p>

<p class=XXX>... <dfn id=dom-fs-action title=dom-fs-action>action</dfn> DOM attribute</p>
<p>The <dfn id=attr-fs-action title=attr-fs-action><code>action</code></dfn> content
attribute, if specified, must have a value that is a <a href=#valid-url>valid
URL</a>.</p>

<p class=XXX>... <dfn id=concept-fs-action title=concept-fs-action>action</dfn> if present else form's else default</p>
<!-- XXX mozilla bug 297761 -->
<p>The <dfn id=concept-fs-action title=concept-fs-action>action</dfn> of an element is
the value of the element's <code title=attr-fs-action><a href=#attr-fs-action>action</a></code> attribute, if it has one, or
the value of its <a href=#form-owner>form owner</a>'s <code title=attr-fs-action><a href=#attr-fs-action>action</a></code> attribute, if <em>it</em> has
one, or else the empty string.</p>

<p class=XXX>... <dfn id=attr-fs-method title=attr-fs-method>method</dfn> content attribute</p>
<p>The <dfn id=attr-fs-method title=attr-fs-method><code>method</code></dfn> content
attribute is an <a href=#enumerated-attribute>enumerated attribute</a> with the following
keywords and states:</p>

<p class=XXX>... <dfn id=dom-fs-method title=dom-fs-method>method</dfn> DOM attribute</p>
<ul><li>The keyword <dfn id=attr-fs-method-get-keyword title=attr-fs-method-GET-keyword><code>GET</code></dfn>, mapping
to the state <dfn id=attr-fs-method-get title=attr-fs-method-GET>GET</dfn>, indicating
the HTTP GET method.</li>

<p class=XXX>... <dfn id=concept-fs-method title=concept-fs-method>method</dfn> if present else form's else default</p>
<li>The keyword <dfn id=attr-fs-method-post-keyword title=attr-fs-method-POST-keyword><code>POST</code></dfn>, mapping
to the state <dfn id=attr-fs-method-post title=attr-fs-method-POST>POST</dfn>, indicating
the HTTP POST method.</li>

<p class=XXX>... <dfn id=attr-fs-enctype title=attr-fs-enctype>enctype</dfn> content attribute</p>
<li>The keyword <dfn id=attr-fs-method-put-keyword title=attr-fs-method-PUT-keyword><code>PUT</code></dfn>, mapping
to the state <dfn id=attr-fs-method-put title=attr-fs-method-PUT>PUT</dfn>, indicating
the HTTP PUT method.</li>

<p class=XXX>... <dfn id=dom-fs-enctype title=dom-fs-enctype>enctype</dfn> DOM attribute</p>
<li>The keyword <dfn id=attr-fs-method-delete-keyword title=attr-fs-method-DELETE-keyword><code>DELETE</code></dfn>, mapping
to the state <dfn id=attr-fs-method-delete title=attr-fs-method-DELETE>DELETE</dfn>, indicating
the HTTP DELETE method.</li>

<p class=XXX>... <dfn id=concept-fs-enctype title=concept-fs-enctype>enctype</dfn> if present else form's else default</p>
</ul><p>The <i>missing value default</i> is the <a href=#attr-fs-method-get title=attr-fs-method-GET>GET</a> state.</p>

<p class=XXX>... <dfn id=attr-fs-target title=attr-fs-target>target</dfn> content attribute</p>
<p>The <dfn id=concept-fs-method title=concept-fs-method>method</dfn> of an element is
one of those four states. If the element has a <code title=attr-fs-method><a href=#attr-fs-method>method</a></code> attribute, then the element's
<a href=#concept-fs-method title=concept-fs-method>method</a> is that attribute's
state; otherwise, it is the <a href=#form-owner>form owner</a>'s <code title=attr-fs-method><a href=#attr-fs-method>method</a></code> attribute's state.</p>

<p class=XXX>... <dfn id=dom-fs-target title=dom-fs-target>target</dfn> DOM attribute</p>
<p>The <dfn id=attr-fs-enctype title=attr-fs-enctype><code>enctype</code></dfn>
content attribute is an <a href=#enumerated-attribute>enumerated attribute</a> with the
following keywords and states:</p>

<p class=XXX>... <dfn id=concept-fs-target title=concept-fs-target>target</dfn> if present else form's else base target else default</p> <!-- c.f. hyperlink following -->
<ul><li>The "<dfn id=attr-fs-enctype-urlencoded title=attr-fs-enctype-urlencoded><code>application/x-www-form-urlencoded</code></dfn>" keyword and corresponding state.</li>
<li>The "<dfn id=attr-fs-enctype-formdata title=attr-fs-enctype-formdata><code>multpart/form-data</code></dfn>" keyword and corresponding state.</li>
<li>The "<dfn id=attr-fs-enctype-text title=attr-fs-enctype-text><code>text/plain</code></dfn>" keyword and corresponding state.</li>
</ul><p>The <i>missing value default</i> is the <code title=attr-fs-enctype-urlencoded><a href=#attr-fs-enctype-urlencoded>application/x-www-form-urlencoded</a></code>
state.</p>

<p>Attributes for form submission can be specified both on
<code><a href=#the-form-element>form</a></code> elements and on elements that represent buttons
that submit forms, e.g. an <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a> state. The
attributes on the buttons, when omitted, default to the values given
on the corresponding the <code><a href=#the-form-element>form</a></code> element.</p>
<p>The <dfn id=concept-fs-enctype title=concept-fs-enctype>enctype</dfn> of an element is
one of those four states. If the element has a <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code> attribute, then the element's
<a href=#concept-fs-enctype title=concept-fs-enctype>enctype</a> is that attribute's
state; otherwise, it is the <a href=#form-owner>form owner</a>'s <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code> attribute's state.</p>

<p>The <dfn id=attr-fs-target title=attr-fs-target><code>target</code></dfn> content
attribute, if present, must be a <a href=#valid-browsing-context-name-or-keyword>valid browsing context name
or keyword</a>.

<p>The <dfn id=concept-fs-target title=concept-fs-target>target</dfn> of an element is
the value of the element's <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attribute, if it has one; or
the value of its <a href=#form-owner>form owner</a>'s <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attribute, if <em>it</em> has
one; or, if one of the child nodes of <a href=#the-head-element-0>the <code>head</code>
element</a> is a <code><a href=#the-base-element>base</a></code> element with a <code title=attr-base-target><a href=#attr-base-target>target</a></code> attribute, then the the value
of the <code title=attr-base-target><a href=#attr-base-target>target</a></code> attribute of the
first such <code><a href=#the-base-element>base</a></code> element; or, if there is no such
element, the empty string.</p> <!-- c.f. hyperlink following -->

<p>The <dfn id=dom-fs-action title=dom-fs-action><code>action</code></dfn>, <dfn id=dom-fs-method title=dom-fs-method><code>method</code></dfn>, <dfn id=dom-fs-enctype title=dom-fs-enctype><code>enctype</code></dfn>, and <dfn id=dom-fs-target title=dom-fs-target><code>target</code></dfn> DOM attributes must
<a href=#reflect>reflect</a> the respective content attributes of the same
name.</p>



Expand Down Expand Up @@ -27645,6 +27688,12 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme

<li><p>Let <var title="">action</var> be the <var title="">submitter</var> element's <a href=#concept-fs-action title=concept-fs-action>action</a>.</li>

<li><p>If <var title="">action</var> is the empty string, let <var title="">action</var> be <span>the document's address</span><!--
XXXDOCURL -->.</p> <!-- Don't ask me why. But that's what IE
does. It even treats action="" differently from action=" " or
action="#" (the latter two resolve to the base URL, the first one
resolves to the doc URL) -->

<li><p><a href=#resolve-a-url title="resolve a url">Resolve</a> the
<a href=#url>URL</a> <var title="">action</var>. If this fails, abort
these steps.</li>
Expand All @@ -27668,10 +27717,10 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
defined below the table.</p>

<table><tr><td>
<th> <span title=attr-fs-method-GET>GET</span>
<th> <span title=attr-fs-method-POST>POST</span>
<th> <span title=attr-fs-method-PUT>PUT</span>
<th> <span title=attr-fs-method-DELETE>DELETE</span>
<th> <a href=#attr-fs-method-get title=attr-fs-method-GET>GET</a>
<th> <a href=#attr-fs-method-post title=attr-fs-method-POST>POST</a>
<th> <a href=#attr-fs-method-put title=attr-fs-method-PUT>PUT</a>
<th> <a href=#attr-fs-method-delete title=attr-fs-method-DELETE>DELETE</a>
<tr><th> <code title="">http</code>
<td> <a href=#submit-mutate-action title=submit-mutate-action>Mutate action</a>
<td> <a href=#submit-body title=submit-body>Submit as entity body</a>
Expand Down Expand Up @@ -27820,15 +27869,15 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
<p>Let <var title="">MIME type</var> be determined as
follows:</p>

<dl><dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-urlencoded>application/x-www-form-urlencoded</code></dt>
<dl><dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-urlencoded><a href=#attr-fs-enctype-urlencoded>application/x-www-form-urlencoded</a></code></dt>

<dd>Let <var title="">MIME type</var> be "<code title="">application/x-www-form-urlencoded</code>".</dd>

<dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-formdata>multpart/form-data</code></dt>
<dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-formdata><a href=#attr-fs-enctype-formdata>multpart/form-data</a></code></dt>

<dd>Let <var title="">MIME type</var> be "<code title="">multipart/form-data</code>".</dd>

<dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-text>text/plain</code></dt>
<dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-text><a href=#attr-fs-enctype-text>text/plain</a></code></dt>

<dd>Let <var title="">MIME type</var> be "<code title="">text/plain</code>".</dd>

Expand Down Expand Up @@ -27926,17 +27975,17 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
<p>The <dfn id=appropriate-form-encoding-algorithm>appropriate form encoding algorithm</dfn> is
determined as follows:</p>

<dl><dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-urlencoded>application/x-www-form-urlencoded</code></dt>
<dl><dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-urlencoded><a href=#attr-fs-enctype-urlencoded>application/x-www-form-urlencoded</a></code></dt>

<dd>Use the <a href=#application/x-www-form-urlencoded-encoding-algorithm><code title="">application/x-www-form-urlencoded</code> encoding
algorithm</a>.</dd>

<dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-formdata>multpart/form-data</code></dt>
<dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-formdata><a href=#attr-fs-enctype-formdata>multpart/form-data</a></code></dt>

<dd>Use the <a href=#multipart/form-data-encoding-algorithm><code title="">multipart/form-data</code> encoding
algorithm</a>.</dd>

<dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-text>text/plain</code></dt>
<dt>If <var title="">enctype</var> is <code title=attr-fs-enctype-text><a href=#attr-fs-enctype-text>text/plain</a></code></dt>

<dd>Use the <a href=#text/plain-encoding-algorithm><code title="">text/plain</code> encoding
algorithm</a>.</dd>
Expand Down
115 changes: 95 additions & 20 deletions source
Expand Up @@ -30675,38 +30675,106 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {

<h4><dfn>Attributes for form submission</dfn></h4>

<p class="XXX">... <dfn title="attr-fs-action">action</dfn> content attribute</p>
<p>Attributes for form submission can be specified both on
<code>form</code> elements and on elements that represent buttons
that submit forms, e.g. an <code>input</code> element whose <code
title="attr-input-type">type</code> attribute is in the <span
title="attr-input-type-submit">Submit Button</span> state. The
attributes on the buttons, when omitted, default to the values given
on the corresponding the <code>form</code> element.</p>

<p class="XXX">... <dfn title="dom-fs-action">action</dfn> DOM attribute</p>
<p>The <dfn title="attr-fs-action"><code>action</code></dfn> content
attribute, if specified, must have a value that is a <span>valid
URL</span>.</p>

<p class="XXX">... <dfn title="concept-fs-action">action</dfn> if present else form's else default</p>
<!-- XXX mozilla bug 297761 -->
<p>The <dfn title="concept-fs-action">action</dfn> of an element is
the value of the element's <code
title="attr-fs-action">action</code> attribute, if it has one, or
the value of its <span>form owner</span>'s <code
title="attr-fs-action">action</code> attribute, if <em>it</em> has
one, or else the empty string.</p>

<p class="XXX">... <dfn title="attr-fs-method">method</dfn> content attribute</p>
<p>The <dfn title="attr-fs-method"><code>method</code></dfn> content
attribute is an <span>enumerated attribute</span> with the following
keywords and states:</p>

<p class="XXX">... <dfn title="dom-fs-method">method</dfn> DOM attribute</p>
<ul>

<p class="XXX">... <dfn title="concept-fs-method">method</dfn> if present else form's else default</p>
<li>The keyword <dfn
title="attr-fs-method-GET-keyword"><code>GET</code></dfn>, mapping
to the state <dfn title="attr-fs-method-GET">GET</dfn>, indicating
the HTTP GET method.</li>

<p class="XXX">... <dfn title="attr-fs-enctype">enctype</dfn> content attribute</p>
<li>The keyword <dfn
title="attr-fs-method-POST-keyword"><code>POST</code></dfn>, mapping
to the state <dfn title="attr-fs-method-POST">POST</dfn>, indicating
the HTTP POST method.</li>

<p class="XXX">... <dfn title="dom-fs-enctype">enctype</dfn> DOM attribute</p>
<li>The keyword <dfn
title="attr-fs-method-PUT-keyword"><code>PUT</code></dfn>, mapping
to the state <dfn title="attr-fs-method-PUT">PUT</dfn>, indicating
the HTTP PUT method.</li>

<p class="XXX">... <dfn title="concept-fs-enctype">enctype</dfn> if present else form's else default</p>
<li>The keyword <dfn
title="attr-fs-method-DELETE-keyword"><code>DELETE</code></dfn>, mapping
to the state <dfn title="attr-fs-method-DELETE">DELETE</dfn>, indicating
the HTTP DELETE method.</li>

<p class="XXX">... <dfn title="attr-fs-target">target</dfn> content attribute</p>
</ul>

<p class="XXX">... <dfn title="dom-fs-target">target</dfn> DOM attribute</p>
<p>The <i>missing value default</i> is the <span
title="attr-fs-method-GET">GET</span> state.</p>

<p class="XXX">... <dfn title="concept-fs-target">target</dfn> if present else form's else base target else default</p> <!-- c.f. hyperlink following -->
<p>The <dfn title="concept-fs-method">method</dfn> of an element is
one of those four states. If the element has a <code
title="attr-fs-method">method</code> attribute, then the element's
<span title="concept-fs-method">method</span> is that attribute's
state; otherwise, it is the <span>form owner</span>'s <code
title="attr-fs-method">method</code> attribute's state.</p>

<p>Attributes for form submission can be specified both on
<code>form</code> elements and on elements that represent buttons
that submit forms, e.g. an <code>input</code> element whose <code
title="attr-input-type">type</code> attribute is in the <span
title="attr-input-type-submit">Submit Button</span> state. The
attributes on the buttons, when omitted, default to the values given
on the corresponding the <code>form</code> element.</p>
<p>The <dfn title="attr-fs-enctype"><code>enctype</code></dfn>
content attribute is an <span>enumerated attribute</span> with the
following keywords and states:</p>

<ul>
<li>The "<dfn title="attr-fs-enctype-urlencoded"><code>application/x-www-form-urlencoded</code></dfn>" keyword and corresponding state.</li>
<li>The "<dfn title="attr-fs-enctype-formdata"><code>multpart/form-data</code></dfn>" keyword and corresponding state.</li>
<li>The "<dfn title="attr-fs-enctype-text"><code>text/plain</code></dfn>" keyword and corresponding state.</li>
</ul>

<p>The <i>missing value default</i> is the <code
title="attr-fs-enctype-urlencoded">application/x-www-form-urlencoded</code>
state.</p>

<p>The <dfn title="concept-fs-enctype">enctype</dfn> of an element is
one of those four states. If the element has a <code
title="attr-fs-enctype">enctype</code> attribute, then the element's
<span title="concept-fs-enctype">enctype</span> is that attribute's
state; otherwise, it is the <span>form owner</span>'s <code
title="attr-fs-enctype">enctype</code> attribute's state.</p>

<p>The <dfn title="attr-fs-target"><code>target</code></dfn> content
attribute, if present, must be a <span>valid browsing context name
or keyword</span>.

<p>The <dfn title="concept-fs-target">target</dfn> of an element is
the value of the element's <code
title="attr-fs-target">target</code> attribute, if it has one; or
the value of its <span>form owner</span>'s <code
title="attr-fs-target">target</code> attribute, if <em>it</em> has
one; or, if one of the child nodes of <span>the <code>head</code>
element</span> is a <code>base</code> element with a <code
title="attr-base-target">target</code> attribute, then the the value
of the <code title="attr-base-target">target</code> attribute of the
first such <code>base</code> element; or, if there is no such
element, the empty string.</p> <!-- c.f. hyperlink following -->

<p>The <dfn title="dom-fs-action"><code>action</code></dfn>, <dfn
title="dom-fs-method"><code>method</code></dfn>, <dfn
title="dom-fs-enctype"><code>enctype</code></dfn>, and <dfn
title="dom-fs-target"><code>target</code></dfn> DOM attributes must
<span>reflect</span> the respective content attributes of the same
name.</p>



Expand Down Expand Up @@ -31092,6 +31160,13 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
title="">submitter</var> element's <span
title="concept-fs-action">action</span>.</p></li>

<li><p>If <var title="">action</var> is the empty string, let <var
title="">action</var> be <span>the document's address</span><!--
XXXDOCURL -->.</p> <!-- Don't ask me why. But that's what IE
does. It even treats action="" differently from action=" " or
action="#" (the latter two resolve to the base URL, the first one
resolves to the doc URL) -->

<li><p><span title="resolve a url">Resolve</span> the
<span>URL</span> <var title="">action</var>. If this fails, abort
these steps.</p></li>
Expand Down

0 comments on commit e7d96a8

Please sign in to comment.