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/16 19:55:26 UTC

svn commit: r422484 [3/5] - in /tapestry/tapestry4/trunk: ./ src/changes/ support/ tapestry-contrib/ tapestry-contrib/src/documentation/ tapestry-contrib/src/site/ tapestry-contrib/src/site/xdoc/ tapestry-contrib/src/site/xdoc/ComponentReference/

Propchange: tapestry/tapestry4/trunk/src/changes/changes.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: tapestry/tapestry4/trunk/support/build.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/support/build.xml?rev=422484&r1=422483&r2=422484&view=diff
==============================================================================
--- tapestry/tapestry4/trunk/support/build.xml (original)
+++ tapestry/tapestry4/trunk/support/build.xml Sun Jul 16 10:55:23 2006
@@ -30,7 +30,7 @@
 	<property name="work.dir" value="${export.dir}/${module}"/>
 	
 	<target name="convert-docs" >
-		<xslt basedir="../tapestry-portlet/src/documentation/content/xdocs/tapestry-portlet" destdir="tmp"
+		<xslt basedir="../tapestry-contrib/src/documentation/content/xdocs/tapestry-contrib" destdir="tmp"
 		       extension=".xml" includes="**/*.xml" 
 				excludes="**/site.xml,**/*.ent,**/*.aart,**/tabs.xml"
 				style="forrest2maven-xdoc.xsl" >

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/site.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/site.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/site.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/site.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<project name="Tapestry">
+    <bannerLeft>
+        <name>Tapestry Web Application Framework</name>
+        <href>http://tapestry.apache.org/</href>
+        <src>images/tapestry_banner.gif</src>
+    </bannerLeft>
+    <bannerRight>
+        <name>Apache Software Foundation</name>
+        <href>http://www.apache.org</href>
+        <src>images/asf_logo_wide.gif</src>
+    </bannerRight>
+    
+    <skin>
+        <groupId>org.apache.tapestry</groupId>
+        <artifactId>maven-skin</artifactId>
+        <version>1.0-SNAPSHOT</version>
+    </skin>
+    
+    <publishDate format="dd MMM yyyy" />
+    
+    <body>
+        <links>
+            <item name="Tapestry" href="http://tapestry.apache.org/" />
+            <item name="Hivemind" href="http://jakarta.apache.org/hivemind/" />
+            <item name="Apache" href="http://www.apache.org/" />
+        </links>
+        
+        <head>
+            <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+            <script type="text/javascript">_uacct = "UA-400821-1"; urchinTracker();</script>
+            <link rel="shortcut icon" href="http://tapestry.apache.org/tapestry4.1/favicon.ico" />
+        </head>
+        
+        <menu ref="parent" />
+        
+        <menu name="Quick Links" inherit="top" >
+            <item name="Home" href="/index.html" />
+            <item name="Download" href="http://tapestry.apache.org/tapestry4.1/download.html" />
+            <item name="Wiki" href="http://wiki.apache.org/tapestry/" />
+        </menu>
+        
+        <menu name="Documentation">
+                
+                <item name="Overview" href="/index.html" />
+                
+                <item name="CheckboxGroup" href="/ComponentReference/CheckboxGroup.html" />
+                <item name="ControlCheckbox" href="/ComponentReference/ControlCheckbox.html" />
+                <item name="ControlledCheckbox" href="/ComponentReference/ControlledCheckbox.html" />
+                <item name="DumpObject" href="/ComponentReference/DumpObject.html" />
+                <item name="InspectorButton" href="/ComponentReference/InspectorButton.html" />
+                <item name="MaskEdit" href="/ComponentReference/MaskEdit.html" />
+                <item name="MultiplePropertySelection" href="/ComponentReference/MultiplePropertySelection.html" />
+                <item name="Palette" href="/ComponentReference/Palette.html" />
+                <item name="SimpleTableColumnComponent" href="/ComponentReference/SimpleTableColumnComponent.html" />
+                <item name="SimpleTableColumnFormComponent" href="/ComponentReference/SimpleTableColumnFormComponent.html" />
+                <item name="Table" href="/ComponentReference/Table.html" />
+                <item name="TableColumns" href="/ComponentReference/TableColumns.html" />
+                <item name="TableFormPages" href="/ComponentReference/TableFormPages.html" />
+                <item name="TableFormRows" href="/ComponentReference/TableFormRows.html" />
+                <item name="TablePages" href="/ComponentReference/TablePages.html" />
+                <item name="TableRows" href="/ComponentReference/TableRows.html" />
+                <item name="TableValues" href="/ComponentReference/TableValues.html" />
+                <item name="TableView" href="/ComponentReference/TableView.html" />
+                <item name="Timeout" href="/ComponentReference/Timeout.html" />
+                <item name="XTile" href="/ComponentReference/XTile.html" />
+            
+        </menu>
+        
+        ${reports} 
+    </body>
+    
+</project>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/CheckboxGroup.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/CheckboxGroup.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/CheckboxGroup.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/CheckboxGroup.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>CheckboxGroup</title>
+    </properties>
+    <body>
+
+        <section name="CheckboxGroup">
+
+            <p>
+                A component defining a group of checkboxes that will be controlled together.
+                Typically the ControlCheckbox and ControlledCheckbox components are placed in the
+                body of this component.
+            </p>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="site:ControlCheckbox">ControlCheckbox</a>
+                    ,
+                    <a href="site:ControlledCheckbox">ControlledCheckbox</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <table>
+                    <tr>
+                        <th>Name</th>
+                        <th>Type</th>
+                        <th>Direction</th>
+                        <th>Required</th>
+                        <th>Default</th>
+                        <th>Description</th>
+                    </tr>
+
+                    <tr>
+                        <td colspan="6">No parameters defined.</td>
+                    </tr>
+
+                </table>
+
+                <p>
+                    Body:
+                    <strong>allowed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>forbidden</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+            </subsection>
+
+            <subsection name="Examples">
+
+                <p>Template</p>
+                <source xml:space="preserve">	
+&lt;form jwcid="form"&gt;
+    &lt;span jwcid="checkboxGroup"&gt;
+    	&lt;input jwcid="controlCheckbox"/&gt;	
+    		&lt;input jwcid="controlledCheckbox1"/&gt;
+    		&lt;input jwcid="controlledCheckbox2"/&gt;
+    		&lt;input jwcid="controlledCheckbox3"/&gt;                        
+    &lt;/span&gt;    
+    ...
+&lt;/form&gt;    
+	</source>
+
+                <p>Specification</p>
+                <source xml:space="preserve">
+&lt;property name="state1" persist="session" initial-value="false"/&gt;
+&lt;property name="state2" persist="session" initial-value="false"/&gt;
+&lt;property name="state3" persist="session" initial-value="false"/&gt;        
+	
+   &lt;component id="checkboxGroup" type="contrib:CheckboxGroup"/&gt;    
+   &lt;component id="controlCheckbox" type="contrib:ControlCheckbox"/&gt;
+   
+&lt;component id="controlledCheckbox1" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state1"/&gt;
+&lt;/component&gt;   
+&lt;component id="controlledCheckbox2" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state2"/&gt;
+&lt;/component&gt; 
+&lt;component id="controlledCheckbox3" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state3"/&gt;
+&lt;/component&gt;  
+	</source>
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/CheckboxGroup.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlCheckbox.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlCheckbox.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlCheckbox.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlCheckbox.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>ControlCheckbox</title>
+    </properties>
+    <body>
+
+        <section name="ControlCheckbox">
+
+            <p>
+                Creates a checkbox that will automatically select or deselect all controlled
+                checkboxes in the checkbox group.
+            </p>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="/CheckboxGroup.html">CheckboxGroup</a>
+                    ,
+                    <a href="/ControlledCheckbox.html">ControlledCheckbox</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <table>
+                    <tr>
+                        <th>Name</th>
+                        <th>Type</th>
+                        <th>Direction</th>
+                        <th>Required</th>
+                        <th>Default</th>
+                        <th>Description</th>
+                    </tr>
+                    <tr>
+                        <td>group</td>
+                        <td>
+                            <a
+                                href="../../tapestry-contrib/apidocs/org/apache/tapestry/contrib/form/checkboxes/CheckboxGroup.html">
+                                CheckboxGroup
+                            </a>
+                        </td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>null</td>
+                        <td>
+                            If provided, it specifies the CheckboxGroup this component belongs to.
+                            If it is not specified, then the component is a a part of the
+                            CheckboxGroup that wraps it. Please note that if this parameter is used,
+                            then the CheckboxGroup it refers to must either enclose the current
+                            component, or must be defined after it.
+                        </td>
+                    </tr>
+                </table>
+
+                <p>
+                    Body:
+                    <strong>removed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>allowed</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>type, onclick</em>
+                </p>
+
+            </subsection>
+
+            <subsection name="Examples">
+
+                <p>Template</p>
+                <source xml:space="preserve">	
+&lt;form jwcid="form"&gt;
+    &lt;span jwcid="checkboxGroup"&gt;
+    	&lt;input jwcid="controlCheckbox"/&gt;	
+    		&lt;input jwcid="controlledCheckbox1"/&gt;
+    		&lt;input jwcid="controlledCheckbox2"/&gt;
+    		&lt;input jwcid="controlledCheckbox3"/&gt;                        
+    &lt;/span&gt;    
+    ...
+&lt;/form&gt;    
+	</source>
+
+                <p>Specification</p>
+                <source xml:space="preserve">
+&lt;property name="state1" persist="session" initial-value="false"/&gt;
+&lt;property name="state2" persist="session" initial-value="false"/&gt;
+&lt;property name="state3" persist="session" initial-value="false"/&gt;        
+	
+   &lt;component id="checkboxGroup" type="contrib:CheckboxGroup"/&gt;    
+   &lt;component id="controlCheckbox" type="contrib:ControlCheckbox"/&gt;
+   
+&lt;component id="controlledCheckbox1" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state1"/&gt;
+&lt;/component&gt;   
+&lt;component id="controlledCheckbox2" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state2"/&gt;
+&lt;/component&gt; 
+&lt;component id="controlledCheckbox3" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state3"/&gt;
+&lt;/component&gt;  
+	</source>
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlCheckbox.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlledCheckbox.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlledCheckbox.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlledCheckbox.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlledCheckbox.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,151 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>ControlledCheckbox</title>
+    </properties>
+    <body>
+
+        <section name="ControlledCheckbox">
+
+            <p>
+                A checkbox whose state may be controlled by other checkboxes using JavaScript. The
+                checkbox rendered by this component may be automatically selected or deselected by a
+                ControlCheckbox within the same group.
+            </p>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="/CheckboxGroup.html">CheckboxGroup</a>
+                    ,
+                    <a href="/ControlCheckbox.html">ControlCheckbox</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <table>
+                    <tr>
+                        <th>Name</th>
+                        <th>Type</th>
+                        <th>Direction</th>
+                        <th>Required</th>
+                        <th>Default</th>
+                        <th>Description</th>
+                    </tr>
+                    <tr>
+                        <td>value</td>
+                        <td>boolean</td>
+                        <td>in/out</td>
+                        <td>yes</td>
+                        <td />
+                        <td>
+                            Value editted by the component; read on render, updated on form submit.
+                            This sets the check attribute of the rendered element.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>disabled</td>
+                        <td>boolean</td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>false</td>
+                        <td>
+                            If true, then the checkbox will render as disabled and any input from
+                            the checkbox will be ignored.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>group</td>
+                        <td>
+                            <a
+                                href="../../tapestry-contrib/apidocs/org/apache/tapestry/contrib/form/checkboxes/CheckboxGroup.html">
+                                CheckboxGroup
+                            </a>
+                        </td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>null</td>
+                        <td>
+                            If provided, it specifies the CheckboxGroup this component belongs to.
+                            If it is not specified, then the component is a a part of the
+                            CheckboxGroup that wraps it. Please note that if this parameter is used,
+                            then the CheckboxGroup it refers to must either enclose the current
+                            component, or must be defined after it.
+                        </td>
+                    </tr>
+                </table>
+
+                <p>
+                    Body:
+                    <strong>removed / allowed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>allowed / forbidden</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+            </subsection>
+
+            <subsection name="Examples">
+
+                <p>Template</p>
+                <source xml:space="preserve">	
+&lt;form jwcid="form"&gt;
+    &lt;span jwcid="checkboxGroup"&gt;
+    	&lt;input jwcid="controlCheckbox"/&gt;	
+    		&lt;input jwcid="controlledCheckbox1"/&gt;
+    		&lt;input jwcid="controlledCheckbox2"/&gt;
+    		&lt;input jwcid="controlledCheckbox3"/&gt;                        
+    &lt;/span&gt;    
+    ...
+&lt;/form&gt;    
+	</source>
+
+                <p>Specification</p>
+                <source xml:space="preserve">
+&lt;property name="state1" persist="session" initial-value="false"/&gt;
+&lt;property name="state2" persist="session" initial-value="false"/&gt;
+&lt;property name="state3" persist="session" initial-value="false"/&gt;        
+	
+   &lt;component id="checkboxGroup" type="contrib:CheckboxGroup"/&gt;    
+   &lt;component id="controlCheckbox" type="contrib:ControlCheckbox"/&gt;
+   
+&lt;component id="controlledCheckbox1" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state1"/&gt;
+&lt;/component&gt;   
+&lt;component id="controlledCheckbox2" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state2"/&gt;
+&lt;/component&gt; 
+&lt;component id="controlledCheckbox3" type="contrib:ControlledCheckbox"&gt;
+	&lt;binding name="value" value="state3"/&gt;
+&lt;/component&gt;  
+	</source>
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/ControlledCheckbox.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/DumpObject.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/DumpObject.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/DumpObject.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/DumpObject.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>DumpObject</title>
+    </properties>
+    <body>
+
+        <section name="DumpObject">
+
+            <p>
+                Dumps out an object's serialized representation in a mix of hex and ascii. The
+                output is formatted for a fixed width font and should typically be enclosed in
+                &lt;pre&gt; tags.
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <table>
+                    <tr>
+                        <th>Name</th>
+                        <th>Type</th>
+                        <th>Direction</th>
+                        <th>Required</th>
+                        <th>Default</th>
+                        <th>Description</th>
+                    </tr>
+
+                    <tr>
+                        <td>object</td>
+                        <td>Object</td>
+                        <td>in</td>
+                        <td>yes</td>
+                        <td />
+                        <td>The object to be displayed as HTML.</td>
+                    </tr>
+
+                </table>
+
+                <p>
+                    Body:
+                    <strong>removed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>allowed</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+            </subsection>
+
+            <subsection name="Examples">
+
+                <source xml:space="preserve">
+&lt;span jwcid="@contrib:DumpObject" object="ognl:new java.util.Date()"/&gt;
+	</source>
+                <p>and the output will be like this:</p>
+                <source xml:space="preserve">
+0000: aced0005 7372000e 6a617661 2e757469  |....sr..java.uti|
+0010: 6c2e4461 7465686a 81014b59 74190300  |l.Datehj..KYt...|
+0020: 00787077 08000001 0adac264 3d78      |.xpw.......d=x  |	
+	</source>
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/DumpObject.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/InspectorButton.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/InspectorButton.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/InspectorButton.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/InspectorButton.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>InspectorButton</title>
+    </properties>
+    <body>
+
+        <section name="InspectorButton">
+
+            <p>
+                Adds a link to a page that is used to raise the Tapestry Inspector in a new window.
+                <br />
+                The Tapestry Inspector enables you at runtime to examine composition of a Tapestry
+                application, inspect persistent page properties, clear HttpSessions and Tapestry
+                caches.
+                <br />
+                Pages incorporating a InspectorButton component must also include a Body component.
+            </p>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="../../Body.html">Body</a>
+                    ,
+                    <a href="../../ExceptionDisplay.html">ExceptionDisplay</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <table>
+                    <tr>
+                        <th>Name</th>
+                        <th>Type</th>
+                        <th>Direction</th>
+                        <th>Required</th>
+                        <th>Default</th>
+                        <th>Description</th>
+                    </tr>
+                    <tr>
+                        <td>disabled</td>
+                        <td>boolean</td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>false</td>
+                        <td>
+                            If true, the button does not appear. This is the correct configuration
+                            for a deployed application.
+                        </td>
+                    </tr>
+
+                </table>
+
+                <p>
+                    Body:
+                    <strong>removed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>forbidden</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+            </subsection>
+
+            <subsection name="Examples">
+
+                <p>This example is a simple page with the InspectorButton.</p>
+                <p>
+                    <strong>Template</strong>
+                </p>
+                <source xml:space="preserve">
+&lt;html jwcid="@Shell" title="InspectorButton Example"&gt;
+&lt;head jwcid="$remove$"&gt;
+ &lt;title&gt;InspectorButton Example&lt;/title&gt;
+&lt;/head&gt;
+&lt;body jwcid="@Body"&gt;
+&lt;h1&gt;Hello world&lt;/h1&gt;
+&lt;span jwcid="@contrib:InspectorButton"/&gt;
+&lt;/body&gt;
+&lt;/html&gt;</source>
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/InspectorButton.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MaskEdit.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MaskEdit.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MaskEdit.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MaskEdit.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,138 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>MaskEdit</title>
+    </properties>
+    <body>
+
+        <section name="MaskEdit">
+
+            <p>
+                Provides a mask edit HTML &lt;input type="text"&gt; form element.
+                <br />
+                Mask edit field validates the text the user enters against a mask that encodes the
+                valid forms the text can take. The mask can also format text that is displayed to
+                the user.
+            </p>
+            <table>
+                <tr>
+                    <th>Mask character</th>
+                    <th>Meaning in mask</th>
+                </tr>
+                <tr>
+                    <td>l</td>
+                    <td>Mixed case letter character [a..z, A..Z]</td>
+                </tr>
+                <tr>
+                    <td>L</td>
+                    <td>Upper case letter character [A..Z]</td>
+                </tr>
+                <tr>
+                    <td>a</td>
+                    <td>Mixed case alpha numeric character [a..z, A..Z, 0..1]</td>
+                </tr>
+                <tr>
+                    <td>A</td>
+                    <td>Upper case alpha numeric character [A..Z, 0..9]</td>
+                </tr>
+                <tr>
+                    <td>#</td>
+                    <td>Numeric character [0..9]</td>
+                </tr>
+                <tr>
+                    <td>_</td>
+                    <td>Reserved character for display, do not use.</td>
+                </tr>
+                <tr>
+                    <td>others</td>
+                    <td>Non editable character for display.</td>
+                </tr>
+            </table>
+            <p>This component requires JavaScript to be enabled in the client browser.</p>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="site:Form">Form</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <table>
+                    <tr>
+                        <th>Name</th>
+                        <th>Type</th>
+                        <th>Direction</th>
+                        <th>Required</th>
+                        <th>Default</th>
+                        <th>Description</th>
+                    </tr>
+                    <tr>
+                        <td>mask</td>
+                        <td>string</td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td> </td>
+                        <td>See above.</td>
+                    </tr>
+                    <tr>
+                        <td>value</td>
+                        <td>string</td>
+                        <td>in / out</td>
+                        <td>yes</td>
+                        <td> </td>
+                        <td>The value to be editted, which is is usually a string.</td>
+                    </tr>
+                    <tr>
+                        <td>disabled</td>
+                        <td>boolean</td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>false</td>
+                        <td>
+                            If true, then a disabled attribute will be rendered as part of the
+                            &lt;input&gt; tag, and the component will not update its value parameter
+                            when the form is submitted.
+                        </td>
+                    </tr>
+
+                </table>
+
+                <p>
+                    Body:
+                    <strong>removed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>forbidden</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MaskEdit.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MultiplePropertySelection.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MultiplePropertySelection.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MultiplePropertySelection.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MultiplePropertySelection.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>MultiplePropertySelection</title>
+    </properties>
+    <body>
+
+        <section name="MultiplePropertySelection">
+
+            <p>
+                A component which uses &lt;input type=checkbox&gt; to set a property of some object.
+                Typically, the values for the object are defined using an
+                org.apache.commons.lang.enum.Enum. A MultiplePropertySelection is dependent on an
+                <a
+                    href="../../tapestry-framework/apidocs/org/apache/tapestry/form/IPropertySelectionModel.html">
+                    IPropertySelectionModel
+                </a>
+                to provide the list of possible values.
+                <br />
+                The
+                <a href="/Palette.html">Palette</a>
+                component is more powerful, but requires client-side JavaScript and is not fully
+                cross-browser compatible.
+            </p>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="/Palette.html">Palette</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <table>
+                    <tr>
+                        <th>Name</th>
+                        <th>Type</th>
+                        <th>Direction</th>
+                        <th>Required</th>
+                        <th>Default</th>
+                        <th>Description</th>
+                    </tr>
+                    <tr>
+                        <td>selectedList</td>
+                        <td>java.util.Collection</td>
+                        <td>in-out</td>
+                        <td>yes</td>
+                        <td> </td>
+                        <td>
+                            The property to set. During rendering, this property is read, and sets
+                            the default value of the options in the select. When the form is
+                            submitted, list is cleared, then has each selected option added to it.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>renderer</td>
+                        <td>
+                            <a
+                                href="../../tapestry-contrib/apidocs/org/apache/tapestry/contrib/form/IMultiplePropertySelectionRenderer.html">
+                                IMultiplePropertySelectionRenderer
+                            </a>
+                        </td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>
+                            shared instance of
+                            <a
+                                href="../../tapestry-contrib/apidocs/org/apache/tapestry/contrib/form/CheckBoxMultiplePropertySelectionRenderer.html">
+                                CheckBoxMultiplePropertySelectionRenderer
+                            </a>
+                        </td>
+                        <td>
+                            Defines the object used to render this component. The default renders a
+                            table of checkboxes.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>model</td>
+                        <td>
+                            <a
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/form/IPropertySelectionModel.html">
+                                IPropertySelectionModel
+                            </a>
+                        </td>
+                        <td>in</td>
+                        <td>yes</td>
+                        <td> </td>
+                        <td>
+                            The model provides a list of possible labels, and matches those labels
+                            against possible values that can be assigned back to the property.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>disabled</td>
+                        <td>boolean</td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>false</td>
+                        <td>
+                            Controls whether the &lt;select&gt; is active or not. A disabled
+                            PropertySelection does not update its value parameter.
+                        </td>
+                    </tr>
+
+                </table>
+
+                <p>
+                    Body:
+                    <strong>removed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>forbidden</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/MultiplePropertySelection.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/Palette.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/Palette.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/Palette.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/Palette.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,262 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Palette</title>
+    </properties>
+    <body>
+
+        <section name="Palette">
+
+            <p>
+                A component used to make a number of selections from a list. The general look is a
+                pair of &lt;select&gt; elements. with a pair of buttons between them. The right
+                element is a list of values that can be selected. The buttons move values from the
+                right column ("available") to the left column ("selected").
+                <br />
+                This all takes a bit of JavaScript to accomplish (quite a bit), which means a
+                <a href="../../Body.html">Body</a>
+                component must wrap the Palette. If JavaScript is not enabled in the client browser,
+                then the user will be unable to make (or change) any selections.
+                <br />
+                Cross-browser compatibility is not perfect. In some cases, the
+                <a href="/MultiplePropertySelection.html">MultiplePropertySelection</a>
+                component may be a better choice.
+            </p>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="/MultiplePropertySelection.html">MultiplePropertySelection</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <table>
+                    <tr>
+                        <th>Name</th>
+                        <th>Type</th>
+                        <th>Direction</th>
+                        <th>Required</th>
+                        <th>Default</th>
+                        <th>Description</th>
+                    </tr>
+                    <tr>
+                        <td>selected</td>
+                        <td>java.util.List</td>
+                        <td>in</td>
+                        <td>yes</td>
+                        <td> </td>
+                        <td>
+                            A List of selected values. Possible selections are defined by the model;
+                            this should be a subset of the possible values. This may be null when
+                            the component is renderred. When the containing form is submitted, this
+                            parameter is updated with a new List of selected objects.
+                            <br />
+                            The order may be set by the user, as well, depending on the sortMode
+                            parameter.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>model</td>
+                        <td>
+                            <a
+                                href="../../tapestry/apidocs/org/apache/tapestry/form/IPropertySelectionModel.html">
+                                IPropertySelectionModel
+                            </a>
+                        </td>
+                        <td>in</td>
+                        <td>yes</td>
+                        <td> </td>
+                        <td>
+                            Works, as with a
+                            <a href="site:PropertySelection">PropertySelection</a>
+                            component, to define the possible values.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>sort</td>
+                        <td>
+                            <a
+                                href="../../tapestry-contrib/apidocs/org/apache/tapestry/contrib/palette/SortMode.html">
+                                SortMode
+                            </a>
+                        </td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>
+                            <a
+                                href="../../tapestry-contrib/apidocs/org/apache/tapestry/contrib/palette/SortMode.html#NONE">
+                                SortMode.NONE
+                            </a>
+                        </td>
+                        <td>Controls automatic sorting of the options.</td>
+                    </tr>
+                    <tr>
+                        <td>rows</td>
+                        <td>int</td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>10</td>
+                        <td>
+                            The number of rows that should be visible in the Pallete's
+                            &lt;select&gt; elements.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>tableClass</td>
+                        <td>String</td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>tapestry-palette</td>
+                        <td>
+                            The CSS class for the table which surrounds the other elements of the
+                            Palette.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>selectedTitleBlock</td>
+                        <td>
+                            <a href="site:Block">Block</a>
+                        </td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>"Selected"</td>
+                        <td>
+                            If specified, allows a Block to be placed within the &lt;th&gt; reserved
+                            for the title above the selected items &lt;select&gt; (on the right).
+                            This allows for images or other components to be placed there. By
+                            default, the simple word Selected is used.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>availableTitleBlock</td>
+                        <td>
+                            <a href="site:Block">Block</a>
+                        </td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td>"Available"</td>
+                        <td>
+                            As with selectedTitleBlock, but for the left column, of items which are
+                            available to be selected. The default is the word Available.
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>
+                            selectImage
+                            <br />
+                            selectDisabledImage
+                            <br />
+                            deselectImage
+                            <br />
+                            deselectDisabledImage
+                            <br />
+                            upImage
+                            <br />
+                            upDisabledImage
+                            <br />
+                            downImage
+                            <br />
+                            downDisabledImage
+                        </td>
+                        <td>
+                            <a href="../../tapestry/apidocs/org/apache/tapestry/IAsset.html">
+                                IAsset
+                            </a>
+                        </td>
+                        <td>in</td>
+                        <td>no</td>
+                        <td> </td>
+                        <td>
+                            If any of these are specified then they override the default images
+                            provided with the component. This allows the look and feel to be
+                            customized relatively easily.
+                            <br />
+                            The most common reason to replace the images is to deal with
+                            backgrounds. The default images are anti-aliased against a white
+                            background. If a colored or patterned background is used, the default
+                            images will have an ugly white fringe. Until all browsers have full
+                            support for PNG (which has a true alpha channel), it is necessary to
+                            customize the images to match the background.
+                        </td>
+                    </tr>
+                </table>
+
+                <p>
+                    Body:
+                    <strong>removed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>forbidden</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+                <p>
+                    A Palette requires some CSS entries to render correctly, especially the middle
+                    column, which contains the two or four buttons for moving selections between the
+                    two columns. The width and alignment of this column must be set using CSS.
+                    Additionally, CSS is commonly used to give the Palette columns a fixed width,
+                    and to dress up the titles. Here is an example of some CSS you can use to format
+                    the palette component:
+                    <br />
+                </p>
+                <source xml:space="preserve">
+TABLE.tapestry-palette TH
+ {
+   font-size: 9pt;
+   font-weight: bold;
+   color: white;
+   background-color: #330066;
+   text-align: center;
+ }
+
+ TD.available-cell SELECT
+ {
+   font-weight: normal;
+   background-color: #FFFFFF;
+   width: 200px;
+ }
+
+ TD.selected-cell SELECT
+ {
+   font-weight: normal;
+   background-color: #FFFFFF;
+   width: 200px;
+ }
+
+ TABLE.tapestry-palette TD.controls
+ {
+   text-align: center;
+   vertical-align: middle;
+   width: 60px;
+ }
+     </source>
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/Palette.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnComponent.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnComponent.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnComponent.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnComponent.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>SimpleTableColumnComponent</title>
+    </properties>
+    <body>
+
+        <section name="SimpleTableColumnComponent">
+
+            <p>A component that renders the default column header.</p>
+            <p>
+                If the current column is sortable, it renders the header as a link. Clicking on the
+                link causes the table to be sorted on that column. Clicking on the link again causes
+                the sorting order to be reversed.
+            </p>
+
+            <span class="info">
+                <strong>Note:</strong>
+                <p>
+                The column header rendered by this component has two main css class definitions. The
+                embedded table html markup within each
+                <code>td</code>
+                element for a sorted column has the class
+                <code>tableHeaderImage</code>
+                . The image used to sort table columns has an embedded style class definition for
+                <code>tableHeaderImage</code>
+                that defines
+                <code>align:center</code>
+                .
+                <br />
+
+                You may override these definitions with your own css rules.
+                </p>
+            </span>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="/Table.html">Table</a>
+                    ,
+                    <a href="/TableView.html">TableView</a>
+                    ,
+                    <a href="/TablePages.html">TablePages</a>
+                    ,
+                    <a href="/TableRows.html">TableRows</a>
+                    ,
+                    <a href="/TableValues.html">TableValues</a>
+                    ,
+                    <a href="/TableColumns.html">TableColumns</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <p>
+                    <em>No parameters</em>
+                </p>
+
+                <p>
+                    Body:
+                    <strong>removed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>allowed</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnComponent.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnFormComponent.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnFormComponent.xml?rev=422484&view=auto
==============================================================================
--- tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnFormComponent.xml (added)
+++ tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnFormComponent.xml Sun Jul 16 10:55:23 2006
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>SimpleTableColumnFormComponent</title>
+    </properties>
+    <body>
+
+        <section name="SimpleTableColumnFormComponent">
+
+            <p>A component that renders the default column header in a form.</p>
+
+            <p>
+                If the current column is sortable, it renders the header as a link. Clicking on the
+                link causes the table to be sorted on that column. Clicking on the link again causes
+                the sorting order to be reversed.
+            </p>
+
+            <p>
+                This component renders links that cause the form to be submitted. This ensures that
+                the updated data in the other form fields is preserved.
+            </p>
+
+            <span class="info">
+                <strong>Note:</strong>
+                <p>
+                The column header rendered by this component has two main css class definitions. The
+                embedded table html markup within each
+                <code>td</code>
+                element for a sorted column has the class
+                <code>tableHeaderImage</code>
+                . The image used to sort table columns has an embedded style class definition for
+                <code>tableHeaderImage</code>
+                that defines
+                <code>align:center</code>
+                .
+
+                <br />
+                You may override these definitions with your own css rules.
+                </p>
+            </span>
+
+            <p>
+                <strong>
+                    See also:
+                    <a href="/Table.html">Table</a>
+                    ,
+                    <a href="/TableView.html">TableView</a>
+                    ,
+                    <a href="/TablePages.html">TablePages</a>
+                    ,
+                    <a href="/TableRows.html">TableRows</a>
+                    ,
+                    <a href="/TableValues.html">TableValues</a>
+                    ,
+                    <a href="/TableColumns.html">TableColumns</a>
+                </strong>
+            </p>
+
+            <subsection name="Parameters">
+
+
+                <p>
+                    <em>No parameters</em>
+                </p>
+
+                <p>
+                    Body:
+                    <strong>removed</strong>
+                </p>
+
+                <p>
+                    Informal parameters:
+                    <strong>allowed</strong>
+                </p>
+
+                <p>
+                    Reserved parameters:
+                    <em>none</em>
+                </p>
+
+            </subsection>
+
+        </section>
+
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/tapestry-contrib/src/site/xdoc/ComponentReference/SimpleTableColumnFormComponent.xml
------------------------------------------------------------------------------
    svn:eol-style = native