[e] (0) example for formnovalidate

git-svn-id: http://svn.whatwg.org/webapps@3322 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jun 26, 2009 · 02428ae · 02428ae
1 parent 648ec06
commit 02428ae
Show file tree

Hide file tree

Showing 2 changed files with 62 additions and 0 deletions.
diff --git a/index b/index
@@ -31698,6 +31698,10 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
   <p>The <code title=attr-fs-formaction><a href=#attr-fs-formaction>formaction</a></code>, <code title=attr-fs-formenctype><a href=#attr-fs-formenctype>formenctype</a></code>, <code title=attr-fs-formmethod><a href=#attr-fs-formmethod>formmethod</a></code>, <code title=attr-fs-formnovalidate><a href=#attr-fs-formnovalidate>formnovalidate</a></code>, and <code title=attr-fs-formtarget><a href=#attr-fs-formtarget>formtarget</a></code> attributes are <a href=#attributes-for-form-submission>attributes
   for form submission</a>.</p>
 
+  <p class=note>The <code title=attr-fs-formnovalidate><a href=#attr-fs-formnovalidate>formnovalidate</a></code> attribute can
+  be used to make submit buttons that do not trigger the constraint
+  validation.</p>
+
   <div class="bookkeeping impl">
 
    <p>The following common <code><a href=#the-input-element>input</a></code> element content
@@ -33006,6 +33010,10 @@ You cannot complete this form until the field is correct.</samp></pre>
   attribute controls focus. The <code title=attr-fs-formaction><a href=#attr-fs-formaction>formaction</a></code>, <code title=attr-fs-formenctype><a href=#attr-fs-formenctype>formenctype</a></code>, <code title=attr-fs-formmethod><a href=#attr-fs-formmethod>formmethod</a></code>, <code title=attr-fs-formnovalidate><a href=#attr-fs-formnovalidate>formnovalidate</a></code>, and <code title=attr-fs-formtarget><a href=#attr-fs-formtarget>formtarget</a></code> attributes are
   <a href=#attributes-for-form-submission>attributes for form submission</a>.</p>
 
+  <p class=note>The <code title=attr-fs-formnovalidate><a href=#attr-fs-formnovalidate>formnovalidate</a></code> attribute can
+  be used to make submit buttons that do not trigger the constraint
+  validation.</p>
+
   <p>The <dfn id=attr-button-value title=attr-button-value><code>value</code></dfn>
   attribute gives the element's value for the purposes of form
   submission. The <code title=attr-button-value><a href=#attr-button-value>value</a></code>
@@ -34773,6 +34781,27 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
   is present, or if the element's <a href=#form-owner>form owner</a>'s <code title=attr-fs-novalidate><a href=#attr-fs-novalidate>novalidate</a></code> attribute is present,
   and false otherwise.</p>
 
+  <div class=example>
+
+   <p>This attribute is useful to include "save" buttons on forms that
+   have validation constraints, to allow users to save their progress
+   even though they haven't fully entered the data in the form. The
+   following example shows a simple form that has two required
+   fields. There are three buttons: one to submit the form, which
+   requires both fields to be filled in; one to save the form so that
+   the user can come back and fill it in later; and one to cancel the
+   form altogether.</p>
+
+   <pre>&lt;form action="editor.cgi" method="post"&gt;
+ &lt;p&gt;&lt;label&gt;Name: &lt;input required name=fn&gt;&lt;/label&gt;&lt;/p&gt;
+ &lt;p&gt;&lt;label&gt;Essay: &lt;textarea name=essay&gt;&lt;/label&gt;&lt;/p&gt;
+ &lt;p&gt;&lt;input type=submit name=submit value="Submit essay"&gt;&lt;/p&gt;
+ &lt;p&gt;&lt;input type=submit formnovalidate name=save value="Save essay"&gt;&lt;/p&gt;
+ &lt;p&gt;&lt;input type=submit formnovalidate name=cancel value="Cancel"&gt;&lt;/p&gt;
+&lt;/form&gt;</pre>
+
+  </div>
+
   <div class=impl>
 
   <hr><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
@@ -71330,6 +71359,7 @@ time:empty { binding: <i title="">time</i>; }</pre>
   Johan Herland,
   John Boyer,
   John Bussjaeger,
+  John Carpenter,
   John Fallows,
   John Harding,
   John Keiser,

diff --git a/source b/source
@@ -35222,6 +35222,11 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
   title="attr-fs-formtarget">formtarget</code> attributes are <span>attributes
   for form submission</span>.</p>
 
+  <p class="note">The <code
+  title="attr-fs-formnovalidate">formnovalidate</code> attribute can
+  be used to make submit buttons that do not trigger the constraint
+  validation.</p>
+
   <div class="bookkeeping impl">
 
    <p>The following common <code>input</code> element content
@@ -36803,6 +36808,11 @@ You cannot complete this form until the field is correct.</samp></pre>
   title="attr-fs-formtarget">formtarget</code> attributes are
   <span>attributes for form submission</span>.</p>
 
+  <p class="note">The <code
+  title="attr-fs-formnovalidate">formnovalidate</code> attribute can
+  be used to make submit buttons that do not trigger the constraint
+  validation.</p>
+
   <p>The <dfn title="attr-button-value"><code>value</code></dfn>
   attribute gives the element's value for the purposes of form
   submission. The <code title="attr-button-value">value</code>
@@ -38945,6 +38955,27 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
   title="attr-fs-novalidate">novalidate</code> attribute is present,
   and false otherwise.</p>
 
+  <div class="example">
+
+   <p>This attribute is useful to include "save" buttons on forms that
+   have validation constraints, to allow users to save their progress
+   even though they haven't fully entered the data in the form. The
+   following example shows a simple form that has two required
+   fields. There are three buttons: one to submit the form, which
+   requires both fields to be filled in; one to save the form so that
+   the user can come back and fill it in later; and one to cancel the
+   form altogether.</p>
+
+   <pre>&lt;form action="editor.cgi" method="post">
+ &lt;p>&lt;label>Name: &lt;input required name=fn>&lt;/label>&lt;/p>
+ &lt;p>&lt;label>Essay: &lt;textarea name=essay>&lt;/label>&lt;/p>
+ &lt;p>&lt;input type=submit name=submit value="Submit essay">&lt;/p>
+ &lt;p>&lt;input type=submit formnovalidate name=save value="Save essay">&lt;/p>
+ &lt;p>&lt;input type=submit formnovalidate name=cancel value="Cancel">&lt;/p>
+&lt;/form></pre>
+
+  </div>
+
   <div class="impl">
 
   <hr>
@@ -84151,6 +84182,7 @@ time:empty { binding: <i title="">time</i>; }</pre>
   Johan Herland,
   John Boyer,
   John Bussjaeger,
+  John Carpenter,
   John Fallows,
   John Harding,
   John Keiser,