From d53167b00a576de2b4b05ce32f22eb8114d889ed Mon Sep 17 00:00:00 2001
From: Jeremy Grelle <jgrelle@vmware.com>
Date: Fri, 11 Apr 2008 16:13:56 +0000
Subject: [PATCH] Added validateAllOnClick example.

---
 spring-webflow-reference/src/spring-faces.xml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/spring-webflow-reference/src/spring-faces.xml b/spring-webflow-reference/src/spring-faces.xml
index 4c16f640..5f1e9135 100644
--- a/spring-webflow-reference/src/spring-faces.xml
+++ b/spring-webflow-reference/src/spring-faces.xml
@@ -580,5 +580,20 @@
                 component, giving the user a clear indicator if the field is left blank or is not a valid date.
             </para>
         </sect2>
+        <sect2 id="spring-faces-validate-all">
+        <title>Preventing an Invalid Form Submission</title>
+        <para>The <code>validateAllOnClick</code> component can be used to intercept the "onclick" event of a child 
+        component and suppress the event if all client-side validations do not pass.</para>
+        <programlisting><![CDATA[ 
+<sf:validateAllOnClick>
+    <sf:commandButton id="proceed" action="proceed" processIds="*" value="Proceed"/>&#160;
+</sf:validateAllOnClick>]]>
+            </programlisting>
+            <para>
+                This will prevent the form from being submitted when the user clicks the "proceed" button if the form
+                is invalid.  When the validations are executed, the user is given clear and immediate indicators of the
+                problems that need to be corrected.
+            </para>
+        </sect2>
     </sect1>
 </chapter>