blob: 7b99d1cd2ecee4ca3b8fa5ae530f1284ec5a9b2c [file] [log] [blame]
<!--
Tbis HTML document provides a base template for Component Reference pages.
* All ??? text should be replaced.
* Examples should illustrate near real world use of the component, see other
existing component page examples for formatting and style guidelines.
* Use Tapestry 2.2 Beta 1+ "expression" binding syntax instead of
"property-path" syntax.
* Include links to Tapestry Javadoc API where appropriate.
* Include Tapestry Developers Guide multi-page version where appropriate.
-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- $Id$ -->
<html>
<head>
<title>contrib:TableFormRows</title>
<link rel="stylesheet" type="text/css" href="Tapestry.css" title="style">
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<!-- Previous component in alphabetical order. -->
<td align="left"><a href="contrib.TableFormPages.html"><img alt="contrib:TableFormPages" src="common-images/prev.png"></a></td>
<td align="middle"><a href="index.html"><img alt="Component Index" src="common-images/home.png" ></a></td>
<!-- Next component in alphabetical order. -->
<td align="right"><a href="contrib.TablePages.html"><img alt="contrib.TablePages" src="common-images/next.png"></a></td>
<tr>
<tr>
<td colspan="3"><hr></td>
</tr>
<tr>
<td colspan="3">
<table border="0" cellpadding="4" cellspacing="4" width="100%">
<tr valign="top">
<td>
<table>
<tr>
<td><font size="+2"><b>contrib:TableFormRows</b></font></td>
</tr>
<tr>
<td>
<A href="../api/org/apache/tapestry/contrib/table/components/TableFormRows.html">org.apache.tapestry.contrib.table.components.TableFormRows</a>
</td>
</tr>
</table>
</td>
<td>
<table align="right" valign="middle" bgcolor="#c0c0c0" cellpadding="8">
<tr>
<td>Non Visual Component</td>
</tr>
</table>
</td>
</tr>
<tr valign="center">
<td colspan="2">&nbsp;</td>
</tr>
<tr>
<td colspan="2">
<b>Description</b>
<br>
A version of the <A HREF="contrib.TableRows.html">TableRows</A> designed for operation in a form.
This is a low level Table component that generates the rows of the current page in the table.
Each row is stored as a hidden value in the form, which eliminates the chance of a stale link during rewinding.
This component must be wrapped by <A HREF="../api/org/apache/tapestry/contrib/table/components/TableView.html"><CODE>TableView</CODE></A>.
<p>
The component iterates over the rows of the current page in the table.
The rows are wrapped in 'tr' tags by default.
You can define columns manually within, or
you can use <A HREF="../api/org/apache/tapestry/contrib/table/components/TableValues.html"><CODE>TableValues</CODE></A>
to generate the columns automatically.
</td>
</tr>
<tr>
<td colspan="2">
<b>See Also</b>
<br>
<A href="contrib.Table.html">Table</a>,
<A href="contrib.TableColumns.html">TableColumns</a>,
<A href="contrib.TablePages.html">TablePages</a>,
<A href="contrib.TableRows.html">TableRows</a>
<A href="contrib.TableValues.html">TableValues</a>,
<A href="contrib.TableView.html">TableView</a>,
<A href="contrib.FormTable.html">FormTable</a>,
<A href="contrib.TableFormPages.html">TableFormPages</a>
</td>
</tr>
<tr>
<td colspan="2">
<b>Parameters</b>
<br>
<table border="1" cellpadding="4" cellspacing="4" class="parameters">
<tr>
<th>Name</th>
<th>Type</th>
<th>Direction</th>
<th>Required</th>
<th>Default</th>
<th>Description</th>
</tr>
<tr>
<td>row</td>
<td>Object</td>
<td>out</td>
<td>no</td>
<td>&nbsp;</td>
<td align="left">The value object of the current row.</td>
</tr>
<tr>
<td>convertor</td>
<td><A HREF="../api/org/apache/tapestry/contrib/table/model/IPrimaryKeyConvertor.html"><CODE>IPrimaryKeyConvertor</CODE></A></td>
<td>in</td>
<td>no</td>
<td>&nbsp;</td>
<td align="left">An interface defining how the items iterated upon by this component
will be stored in the form as Hidden values.
This interface allows only the primary key of the items to be stored, rather than
the whole item.</td>
</tr>
<tr>
<td>element</td>
<td>String</td>
<td>in</td>
<td>no</td>
<td>tr</td>
<td align="left">The tag to use to wrap the rows in.</td>
</tr>
</table>
<p>
Body: <strong>removed</strong><br>
Informal parameters: <strong>allowed</strong><br>
<!-- component-specification "reserved-parameter" -->
Reserved parameters: none
</p>
</td>
</tr>
<tr>
<td colspan="2">
<b>Examples</b>
<p>
This example is under construction.
</p>
</td></tr></table>
</td></tr>
<tr>
<td colspan="3"><hr></td>
</tr>
<tr>
<!-- Previous component in alphabetical order. -->
<td align="left"><a href="contrib.TablePages.html"><img alt="contrib:TablePages" src="common-images/prev.png"></a></td>
<td align="middle"><a href="index.html"><img alt="Component Index" src="common-images/home.png" ></a></td>
<!-- Next component in alphabetical order. -->
<td align="right"><a href="contrib.TableValues.html"><img alt="contrib.TableValues" src="common-images/next.png"></a></td>
</tr>
</table>
</body>
</html>