You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by jk...@apache.org on 2006/07/03 02:38:26 UTC
svn commit: r418666 [2/2] - in /tapestry/tapestry4/trunk/src/site:
resources/images/QuickStart/ resources/images/UsersGuide/
resources/images/examples/ xdoc/QuickStart/ xdoc/UsersGuide/
Modified: tapestry/tapestry4/trunk/src/site/xdoc/UsersGuide/validation.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/UsersGuide/validation.xml?rev=418666&r1=418665&r2=418666&view=diff
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/UsersGuide/validation.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/UsersGuide/validation.xml Sun Jul 2 17:38:25 2006
@@ -24,7 +24,7 @@
The tapestry validation system provides a very powerful means of validating data intuitively on most
of the form element components, such as <a href="site:TextField">TextField</a>, <a href="site:TextArea">TextArea</a>, <a href="site:Checkbox">Checkbox</a>, and so forth. All of these
components implement the interface
- <a href="../tapestry/apidocs/org/apache/tapestry/form/IFormComponent.html">IFormComponent</a>, and include the necessary hooks to fit into
+ <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/IFormComponent.html">IFormComponent</a>, and include the necessary hooks to fit into
the overall validation framework.
</p>
<p>
@@ -69,7 +69,7 @@
<p>
However, this is not all there is to FieldLabel. An important part of validation is <em>decoration</em> of fields, to mark
- when they contain errors. This is one of the responsibilities <a href="../tapestry/apidocs/org/apache/tapestry/valid/IValidationDelegate.html">IValidationDelegate</a> ... decorating fields and labels.
+ when they contain errors. This is one of the responsibilities <a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/IValidationDelegate.html">IValidationDelegate</a> ... decorating fields and labels.
</p>
<p>
@@ -86,7 +86,7 @@
</source>
<p>
- By subclassing the default implementation of <a href="../tapestry/apidocs/org/apache/tapestry/valid/IValidationDelegate.html">IValidationDelegate</a> (the <a href="../tapestry/apidocs/org/apache/tapestry/valid/ValidationDelegate.html">ValidationDelegate</a> class), you can change how these
+ By subclassing the default implementation of <a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/IValidationDelegate.html">IValidationDelegate</a> (the <a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/ValidationDelegate.html">ValidationDelegate</a> class), you can change how these
decorations are rendered. It then becomes a matter of providing this custom validation delegate to the <a href="site:Form">Form</a> component, via
its delegate parameter. This is covered in more detail shortly.
</p>
@@ -102,7 +102,7 @@
</p>
<p>
- The validators parameter provides a list of validator objects, objects that implement the <a href="../tapestry/apidocs/org/apache/tapestry/form/validator/Validator.html">Validator</a> interface.
+ The validators parameter provides a list of validator objects, objects that implement the <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">Validator</a> interface.
Why a list? Unlike Tapestry 3 validation, each individual validator checks just a single <em>constraint</em>.
Contraints are things like minimum string length, maximum string length, minimum numeric value, etc. This is a very fine
grained approach, and one that is easily extensible to new contraints.
@@ -120,7 +120,7 @@
<p>
The validators: binding prefix is a powerful shorthand for
- constructing a list of configured <a href="../tapestry/apidocs/org/apache/tapestry/form/validator/Validator.html">Validator</a> objects. It allows a very declarative style; for
+ constructing a list of configured <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">Validator</a> objects. It allows a very declarative style; for
example, to state that a field is required with a minimum length of four characters,
the following parameter binding could be used (in a page or component specification):
</p>
@@ -151,9 +151,9 @@
<p>
Most validator classes are <em>configurable</em>: they have a property that matches their
- name. For example, <a href="../tapestry/apidocs/org/apache/tapestry/form/validator/MinDate.html">MinDate</a> (which is named "minDate"
+ name. For example, <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/MinDate.html">MinDate</a> (which is named "minDate"
has a <code>minDate</code> property. A few validators are not configurable ("required" =>
- <a href="../tapestry/apidocs/org/apache/tapestry/form/validator/Required.html">Required</a>, for example).
+ <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Required.html">Required</a>, for example).
</p>
<p>
Validators are expected to have a public no-args constructor. They are also expected to have a
@@ -181,13 +181,13 @@
<table>
<tr>
<th>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/Validator.html">Validator</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">Validator</a>
</th>
<th>attributes</th>
</tr>
<tr>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/BaseValidator.html">BaseValidator</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/BaseValidator.html">BaseValidator</a>
</td>
<td>
<code>message</code>
@@ -195,7 +195,7 @@
</tr>
<tr>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/Email.html">Email</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Email.html">Email</a>
</td>
<td>
<code>none, uses standard email regexp "^\\w[-._\\w]*\\w@\\w[-._\\w]*\\w\\.\\w{2,6}$"</code>
@@ -203,7 +203,7 @@
</tr>
<tr>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/Max.html">Max</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Max.html">Max</a>
</td>
<td>
<code>max=<maximum value, 10></code>
@@ -211,7 +211,7 @@
</tr>
<tr>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/MaxDate.html">MaxDate</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/MaxDate.html">MaxDate</a>
</td>
<td>
<code>maxDate=<maximum date, 06/09/2010></code>
@@ -219,7 +219,7 @@
</tr>
<tr>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/MaxLength.html">MaxLength</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/MaxLength.html">MaxLength</a>
</td>
<td>
<code>maxLength=<maximum length, 23></code>
@@ -227,7 +227,7 @@
</tr>
<tr>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/Min.html">Min</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Min.html">Min</a>
</td>
<td>
<code>min=<minimum value, 0.718></code>
@@ -235,7 +235,7 @@
</tr>
<tr>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/MinDate.html">MinDate</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/MinDate.html">MinDate</a>
</td>
<td>
<code>minDate=<minimum date, 04/23/05></code>
@@ -243,7 +243,7 @@
</tr>
<tr>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/form/validator/MinLength.html">MinLength</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/MinLength.html">MinLength</a>
</td>
<td>
<code>minLength=<minmum length, 15></code>
@@ -338,7 +338,7 @@
<p>
For <a href="site:ValidField">ValidField</a>, validation is specified through a single parameter, validator.
- The validator parameter is an object that implements the <a href="../tapestry/apidocs/org/apache/tapestry/valid/IValidator.html">IValidator</a> interface. In Tapestry 3.0, it was necessary to
+ The validator parameter is an object that implements the <a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/IValidator.html">IValidator</a> interface. In Tapestry 3.0, it was necessary to
provide a configured Java object as the validator, using Java code, or
the specification's <bean> element.
</p>
@@ -381,35 +381,35 @@
<tr>
<th>Name</th>
<th>
-<a href="../tapestry/apidocs/org/apache/tapestry/valid/IValidator.html">IValidator</a> implementation class</th>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/IValidator.html">IValidator</a> implementation class</th>
</tr>
<tr>
<td>string</td> <td>
-<a href="../tapestry/apidocs/org/apache/tapestry/valid/StringValidator.html">StringValidator</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/StringValidator.html">StringValidator</a>
</td>
</tr>
<tr>
<td>date</td>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/valid/DateValidator.html">DateValidator</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/DateValidator.html">DateValidator</a>
</td>
</tr>
<tr>
<td>email</td>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/valid/EmailValidator.html">EmailValidator</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/EmailValidator.html">EmailValidator</a>
</td>
</tr>
<tr>
<td>url</td>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/valid/UrlValidator.html">UrlValidator</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/UrlValidator.html">UrlValidator</a>
</td>
</tr>
<tr>
<td>int</td>
<td>
-<a href="../tapestry/apidocs/org/apache/tapestry/valid/IntValidator.html">IntValidator</a>
+<a href="../tapestry-framework/apidocs/org/apache/tapestry/valid/IntValidator.html">IntValidator</a>
</td>
</tr>
</table>