Merge pull request #400 from StefanSpieker/clazz_validation

Added examples for client-side validation with the help of `clazz` within `jelly`

Author: krisstern

src/main/resources/io/jenkins/plugins/designlibrary/Validation/index.jelly

@@ -24,5 +24,19 @@
 
       <p class="jdl-paragraph">${%validation.description}</p>
     </s:section>
+
+    <s:section>
+      <p class="jdl-paragraph">${%validation.clazz}</p>
+      <s:group>
+        <s:preview>
+          <form method="post">
+            <f:entry title="${%Non-negative integer}">
+              <f:number min="0" clazz="number"/>
+            </f:entry>
+          </form>
+        </s:preview>
+        <s:code file="sample-clazz.jelly" />
+      </s:group>
+    </s:section>
   </s:layout>
 </j:jelly>

src/main/resources/io/jenkins/plugins/designlibrary/Validation/index.properties

@@ -6,3 +6,6 @@ title=Form field validation can access values of the nearby input controls, \
   so that the validation of the state name refers to the capital name, and the validation of the city name refers to the state name.
 validation.description=To implement this you need to provide a <code>doCheckXXX</code> method, where XXX is the name of your field. \
   This should return a <code>FormValidation</code> object.
+validation.clazz=There is also the possibility to use client side CSS validation inside Jelly, with the help of <code>clazz=</code>. \
+  Existing validations are <code>required</code>, <code>number</code> and <code>positive-number</code>. \
+  They can also be combined, e.g. <code>clazz="required number"</code> to validate a mandatory integer field.

src/main/resources/io/jenkins/plugins/designlibrary/Validation/index_de.properties

@@ -0,0 +1,12 @@
+title=Formularfeld Validierung kann auf die Werte benachbarter Eingabefelder zugreifen, \
+ was nützlich ist, um komplexe, kontextabhängige Validierungen durchzuführen. \
+ Die gleiche Technik kann auch für Funktionen wie Autovervollständigung, das Befüllen von Kombinations- oder Listenfeldern usw. verwendet werden. \
+ Das obige Beispiel ist etwas konstruiert, aber alle Eingabefelder heißen "name" (für Städtenamen und Bundesstaatennamen), \
+ und wir verwenden <code><a href="https://javadoc.jenkins.io/hudson/RelativePath.html">@RelativePath</a></code>, \
+ damit die Validierung des Bundesstaatennamens auf den Hauptstadtnamen verweist, \
+ und die Validierung des Stadtnamens auf den Bundesstaatennamen verweist.
+validation.description=Um dies umzusetzen, müssen Sie eine Methode <code>doCheckXXX</code> bereitstellen, wobei XXX dem Namen Ihres Feldes entspricht. \
+ Diese Methode sollte ein <code>FormValidation</code>-Objekt zurückgeben.
+validation.clazz=Es besteht auch die Möglichkeit, clientseitige CSS-Validierung innerhalb von Jelly mithilfe von <code>clazz=</code> zu verwenden. \
+ Vorhandene Validierungen sind <code>required</code>, <code>number</code> und <code>positive-number</code>. \
+ Diese können auch kombiniert werden, z.B. <code>clazz="required number"</code> um ein Pflichtfeld und Ganzzahl zu validieren.

src/main/webapp/Validation/sample-clazz.jelly

@@ -0,0 +1,3 @@
+<f:entry title="${%Non-negative integer}" field="name">
+  <f:number min="0" clazz="number"/>
+</f:entry>