You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by ds...@apache.org on 2005/09/10 02:49:43 UTC

svn commit: r279925 - in /jakarta/tapestry/trunk: contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/FormConditional.xml doc/src/ComponentReference/contrib.FormConditional.html status.xml

Author: dsolis
Date: Fri Sep  9 17:49:38 2005
New Revision: 279925

URL: http://svn.apache.org/viewcvs?rev=279925&view=rev
Log:
Fix bug:TAPESTRY-489. Document FormConditional component.

Removed:
    jakarta/tapestry/trunk/doc/src/ComponentReference/contrib.FormConditional.html
Modified:
    jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/FormConditional.xml
    jakarta/tapestry/trunk/status.xml

Modified: jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/FormConditional.xml
URL: http://svn.apache.org/viewcvs/jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/FormConditional.xml?rev=279925&r1=279924&r2=279925&view=diff
==============================================================================
--- jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/FormConditional.xml (original)
+++ jakarta/tapestry/trunk/contrib/src/documentation/content/xdocs/tapestry-contrib/ComponentReference/FormConditional.xml Fri Sep  9 17:49:38 2005
@@ -28,11 +28,17 @@
   
   <body>
 
-<p> <strong>THIS PAGE UNDER CONSTRUCTION</strong>
+<p>  FormConditional is a variant of &Conditional; designed to be used in a &Form;, similar to the relationship between &Foreach; and &ListEdit;. It is used to guarantee that the data will be the same during rendering and rewind when a form is submitted avoiding a stale link.
+On render, FormConditional reads condition parameter, stores it into a hidden field, and could render or not according to condition value. On rewind, the FormConditional ignores condition parameter, reads the stored value, and could render or not matching previous render.
 </p>
 
+      <warning>
+          This component has been deprecated; Tapestry 4.0 adds the &If; component which
+          allows conditionalized elements to be safely contained by &Form; components.
+      </warning>
+
 <p>
-  <strong>See also:</strong> 
+  <strong>See also:</strong> &Conditional;, &Form; &If;
 </p>
 
 <section>
@@ -47,26 +53,64 @@
     <th>Default</th>
     <th>Description</th>
   </tr>
+    <tr>
+      <td>condition</td>
+      <td>boolean</td>
+      <td>in</td>
+      <td>yes</td>
+      <td>&nbsp;</td>
+
+      <td>The condition to evaluate.</td>
+    </tr>
+    <tr>
+      <td>element</td>
+      <td>String</td>
+      <td>in</td>
+      <td>no</td>
+      <td>&nbsp;</td>
+
+      <td>The element to emulate. If specified, then the component acts like an &Any;, emitting an open and close tag.
+      Informal parameters are applied to the tag. If no element is specified, informal parameters are ignored.</td>
+    </tr>
+    <tr>
+      <td>listener</td>
+      <td>String</td>
+      <td>in</td>
+      <td>no</td>
+      <td>&nbsp;</td>
+
+      <td>The listener, informed at render.</td>
+    </tr>
+    <tr>
+      <td>conditionValue</td>
+      <td>boolean</td>
+      <td>custom</td>
+      <td>no</td>
+      <td>&nbsp;</td>
+
+      <td>The value of the condition. During render this is obtained from the condition parameter.
+      During rewind it is the submitted condition.</td>
+    </tr>
 
 	</table>
   
 <p>
-  Body: <strong>removed / allowed</strong>
+  Body: <strong>allowed</strong>
 </p>  
 
 <p>
-  Informal parameters: <strong>allowed  / forbidden</strong>
+  Informal parameters: <strong>allowed</strong>
 </p>
 
 <p>
-  Reserved parameters: <em>none</em>
+  Reserved parameters: <em>invert</em>
 </p>
 
 </section>
 
 <section>
   <title>Examples</title>
-
+    <p>Please see the documentation for the &If; component.</p>
 </section>
 </body>
 </document>

Modified: jakarta/tapestry/trunk/status.xml
URL: http://svn.apache.org/viewcvs/jakarta/tapestry/trunk/status.xml?rev=279925&r1=279924&r2=279925&view=diff
==============================================================================
--- jakarta/tapestry/trunk/status.xml (original)
+++ jakarta/tapestry/trunk/status.xml Fri Sep  9 17:49:38 2005
@@ -57,9 +57,10 @@
       <action type="fix" dev="HLS" fixes-bug="TAPESTRY-535">Colons in an OGNL expression may force it to be intepreted as a literal string, not an expression</action>
       <action type="fix" dev="HLS" fixes-bug="TAPESTRY-556">Literal bindings in template override bindings in specification for the same informal parameter</action>
       <action type="fix" dev="DS" fixes-bug="TAPESTRY-459">Document DatePicker component</action>
-      <action type="fix" dev="MB" fixes-bug="TAPESTRY-632">Bug with "ForBean" when upgrade from beta5 to beta6</action>   
-      <action type="fix" dev="MB" fixes-bug="TAPESTRY-469">Document If component</action>   
-      <action type="fix" dev="MB" fixes-bug="TAPESTRY-464">Document For component</action>   
+      <action type="fix" dev="MB" fixes-bug="TAPESTRY-632">Bug with "ForBean" when upgrade from beta5 to beta6</action>
+      <action type="fix" dev="MB" fixes-bug="TAPESTRY-469">Document If component</action>
+      <action type="fix" dev="MB" fixes-bug="TAPESTRY-464">Document For component</action>
+      <action type="fix" dev="DS" fixes-bug="TAPESTRY-489">Document FormConditional component</action>
     </release>
     <release version="4.0-beta-6" date="Sep 7 2005">
       <action type="update" dev="HLS" due-to="Henri Yandell">Convert Tapestry repository from CVS to SVN</action>



---------------------------------------------------------------------
To unsubscribe, e-mail: tapestry-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tapestry-dev-help@jakarta.apache.org