Author: dsolis
Date: Fri Sep 23 13:05:23 2005
New Revision: 291199
URL: http://svn.apache.org/viewcvs?rev=291199&view=rev
Log:
fixes-bug:TAPESTRY-488, TAPESTRY-494, TAPESTRY-513. Document DateField,
NumericField, ValidatingTextField components
Modified:
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/DateField.xml
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/NumericField.xml
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/ValidatingTextField.xml
jakarta/tapestry/trunk/status.xml
Modified:
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/DateField.xml
URL:
http://svn.apache.org/viewcvs/jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/DateField.xml?rev=291199&r1=291198&r2=291199&view=diff
==============================================================================
---
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/DateField.xml
(original)
+++
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/DateField.xml
Fri Sep 23 13:05:23 2005
@@ -28,13 +28,18 @@
<body>
-<p> <strong>THIS PAGE UNDER CONSTRUCTION</strong>
+<p> Backwards compatible version of the 1.0.7 DateField component.
</p>
<p>
- <strong>See also:</strong>
+ <strong>See also: &ValidField;</strong>
</p>
+<warning>
+ This component has been deprecated; Tapestry 4.0 adds even better support
for validation to &TextField;, &TextArea; and most other
+ form element component.
+</warning>
+
<section>
<title>Parameters</title>
@@ -47,26 +52,71 @@
<th>Default</th>
<th>Description</th>
</tr>
+ <tr>
+ <td>text</td>
+ <td>String</td> <td>in/out</td> <td>yes</td> <td> </td>
+ <td>
+ The date property to edit.
+ </td>
+ </tr>
+ <tr>
+ <td>required</td>
+ <td>boolean</td> <td>in</td> <td>no</td> <td>false</td>
+ <td>
+ If true, then a value must be entered.
+ </td>
+ </tr>
+ <tr>
+ <td>minimum</td>
+ <td>java.util.Date</td> <td>in</td> <td>no</td> <td> </td>
+ <td>
+ If provided, the date entered must be equal to or later than the
provided minimum date.
+ </td>
+ </tr>
+ <tr>
+ <td>maximum</td>
+ <td>java.util.Date</td> <td>in</td> <td>no</td> <td> </td>
+ <td>
+ If provided, the date entered must be less than or equal to the
provided maximum date.
+ </td>
+ </tr>
+ <tr>
+ <td>displayName</td>
+ <td>String</td> <td>in</td> <td>yes</td> <td> </td>
+ <td>
+ A textual name for the field that is used when formulating error
messages.
+ </td>
+ </tr>
+ <tr>
+ <td>format</td>
+ <td>java.text.DateFormat</td> <td>in</td> <td>no</td> <td>MM/dd/yyyy</td>
+ <td>
+ The format used to display and parse dates.
+ </td>
+ </tr>
+ <tr>
+ <td>displayFormat</td>
+ <td>String</td> <td>in</td> <td>no</td> <td>MM/dd/yyyy</td>
+ <td>
+ The format string presented to the user if the date entered is in an
incorrect format. e.g. the format object throws a ParseException.
+ </td>
+ </tr>
</table>
<p>
- Body: <strong>removed / allowed</strong>
+ Body: <strong>removed</strong>
</p>
<p>
- Informal parameters: <strong>allowed / forbidden</strong>
+ Informal parameters: <strong>allowed</strong>
</p>
<p>
- Reserved parameters: <em>none</em>
+ Reserved parameters: <em>name, type, value, size, maxlength</em>
</p>
</section>
-<section>
- <title>Examples</title>
-
-</section>
</body>
</document>
Modified:
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/NumericField.xml
URL:
http://svn.apache.org/viewcvs/jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/NumericField.xml?rev=291199&r1=291198&r2=291199&view=diff
==============================================================================
---
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/NumericField.xml
(original)
+++
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/NumericField.xml
Fri Sep 23 13:05:23 2005
@@ -28,13 +28,18 @@
<body>
-<p> <strong>THIS PAGE UNDER CONSTRUCTION</strong>
+<p> Backwards compatible version of the 1.0.7 NumericField component.
</p>
<p>
- <strong>See also:</strong>
+ <strong>See also: &ValidField;</strong>
</p>
+<warning>
+ This component has been deprecated; Tapestry 4.0 adds even better support
for validation to &TextField;, &TextArea; and most other
+ form element component.
+</warning>
+
<section>
<title>Parameters</title>
@@ -47,26 +52,66 @@
<th>Default</th>
<th>Description</th>
</tr>
-
+ <tr>
+ <td>text</td>
+ <td>java.lang.Number</td> <td>in/out</td> <td>yes</td> <td> </td>
+ <td>
+ The value to be updated.
+When the form is submitted, this parameter is only updated if the value is
valid.
+When rendering, a null value will render as the empty string. A value of zero
will render normally.
+When the form is submitted, the type of the binding is used to determine what
kind of object to convert the string to.
+ </td>
+ </tr>
+ <tr>
+ <td>minimum</td>
+ <td>java.lang.Number</td> <td>in</td> <td>no</td> <td> </td>
+ <td>
+ The minimum value accepted for the field.
+ </td>
+ </tr>
+ <tr>
+ <td>maximum</td>
+ <td>java.lang.Number</td> <td>in</td> <td>no</td> <td> </td>
+ <td>
+ The maximum value accepted for the field.
+ </td>
+ </tr>
+ <tr>
+ <td>required</td>
+ <td>boolean</td> <td>in</td> <td>no</td> <td>false</td>
+ <td>
+ If true, then a non-null value must be provided. If the field is not
required, and a null (all whitespace) value is supplied in the field, then the
value parameter is not updated.
+ </td>
+ </tr>
+ <tr>
+ <td>displayName</td>
+ <td>String</td> <td>in</td> <td>yes</td> <td> </td>
+ <td>
+ A textual name for the field that is used when formulating error
messages.
+ </td>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>String</td> <td>in</td> <td>yes</td> <td> </td>
+ <td>
+ The class name used to convert the value entered. See
NumberValidator.setValueType(String)
+ </td>
+ </tr>
</table>
<p>
- Body: <strong>removed / allowed</strong>
+ Body: <strong>removed</strong>
</p>
<p>
- Informal parameters: <strong>allowed / forbidden</strong>
+ Informal parameters: <strong>allowed</strong>
</p>
<p>
- Reserved parameters: <em>none</em>
+ Reserved parameters: <em>name</em>
</p>
</section>
-<section>
- <title>Examples</title>
-
-</section>
</body>
</document>
Modified:
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/ValidatingTextField.xml
URL:
http://svn.apache.org/viewcvs/jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/ValidatingTextField.xml?rev=291199&r1=291198&r2=291199&view=diff
==============================================================================
---
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/ValidatingTextField.xml
(original)
+++
jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/ValidatingTextField.xml
Fri Sep 23 13:05:23 2005
@@ -28,13 +28,18 @@
<body>
-<p> <strong>THIS PAGE UNDER CONSTRUCTION</strong>
+<p> Backwards compatible version of the 1.0.7 ValidatingTextField component.
</p>
<p>
- <strong>See also:</strong>
+ <strong>See also: &ValidField;</strong>
</p>
+<warning>
+ This component has been deprecated; Tapestry 4.0 adds even better support
for validation to &TextField;, &TextArea; and most other
+ form element component.
+</warning>
+
<section>
<title>Parameters</title>
@@ -47,26 +52,50 @@
<th>Default</th>
<th>Description</th>
</tr>
-
- </table>
+ <tr>
+ <td>text</td>
+ <td>String</td> <td>in/out</td> <td>yes</td> <td> </td>
+ <td>
+ The text inside the text field. When the form is submitted, the binding
is only updated if the value is valid.
+ </td>
+ </tr>
+ <tr>
+ <td>required</td>
+ <td>boolean</td> <td>in</td> <td>no</td> <td>false</td>
+ <td>
+ If true, then a value must be entered.
+ </td>
+ </tr>
+ <tr>
+ <td>minimumLength</td>
+ <td>int</td> <td>in</td> <td>no</td> <td>0</td>
+ <td>
+ The minimum length (number of characters read) for the field. The value
provided in the request is trimmed of leading and trailing whitespace.
+ If a field is not required and no value is given, then minimumLength is
ignored. Minimum length only applies if some non-null value is given.
+ </td>
+ </tr>
+ <tr>
+ <td>displayName</td>
+ <td>String</td> <td>in</td> <td>yes</td> <td> </td>
+ <td>
+ A textual name for the field that is used when formulating error
messages.
+ </td>
+ </tr>
+</table>
<p>
- Body: <strong>removed / allowed</strong>
+ Body: <strong>removed</strong>
</p>
<p>
- Informal parameters: <strong>allowed / forbidden</strong>
+ Informal parameters: <strong>allowed</strong>
</p>
<p>
- Reserved parameters: <em>none</em>
+ Reserved parameters: <em>type, value</em>
</p>
</section>
-<section>
- <title>Examples</title>
-
-</section>
</body>
</document>
Modified: jakarta/tapestry/trunk/status.xml
URL:
http://svn.apache.org/viewcvs/jakarta/tapestry/trunk/status.xml?rev=291199&r1=291198&r2=291199&view=diff
==============================================================================
--- jakarta/tapestry/trunk/status.xml (original)
+++ jakarta/tapestry/trunk/status.xml Fri Sep 23 13:05:23 2005
@@ -68,7 +68,8 @@
<action type="fix" dev="HLS" fixes-bug="TAPESTRY-639">Expose the
ServletContext as service tapestry.globals.ServletContext</action>
<action type="fix" dev="HLS" fixes-bug="TAPESTRY-655">In some
circumstances, using the classpath: or context: prefixes on paths fails to
work</action>
<action type="update" dev="HLS">Rename certain test-related classes to
be picked up properly by the Ant build scripts</action>
- <action type="remove"" dev="HLS">Remove some code that is no longer
used</action>
+ <action type="remove" dev="HLS">Remove some code that is no longer
used</action>
+ <action type="fix" dev="DS" fixes-bug="TAPESTRY-488, TAPESTRY-494,
TAPESTRY-513">Document DateField, NumericField, ValidatingTextField
components</action>
</release>
<release version="4.0-beta-7" date="Sep 17 2005">
<action type="fix" dev="HLS" fixes-bug="TAPESTRY-341">Need better
line-precise reporting for listener method</action>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
