org.apache.tapestry5.corelib.components
Class GridRows

java.lang.Object
  org.apache.tapestry5.corelib.components.GridRows

public class GridRows
extends Object

Renders out a series of rows within the table.

Inside a Form, a series of row index numbers are stored into the form ( as ComponentActions). This can be a problem in situations where the data set can shift between the form render and the form submission, with a risk of applying changes to the wrong objects.

For this reason, when using GridRows inside a Form, you should generally provide a ValueEncoder (via the encoder parameter), or use an entity type for the "row" parameter for which Tapestry can provide a ValueEncoder automatically. This will allow Tapestry to use a unique ID for each row that doesn't change when rows are reordered.

Component Parameters

Name	Description	Type	Flags	Default	Default Prefix	Since
columnIndex	Optional output parameter that stores the current column index.	int			prop
currentPage	The current page number within the available pages (indexed from 1).	int	Required		prop
encoder	A ValueEncoder used to convert server-side objects (provided by the "row" parameter) into unique client-side strings (typically IDs) and back. In general, when using Grid and Form together, you should either provide the encoder parameter or use a "row" type for which Tapestry is configured to provide a ValueEncoder automatically. Otherwise Tapestry must fall back to using the plain index of each row, rather than the ValueEncoder-provided unique ID, for recording state into the form.	org.apache.tapestry5.ValueEncoder			prop
gridModel	Object that provides access to the bean and data models used to render the Grid.	org.apache.tapestry5.grid.GridModel		componentResources.container	prop
lean	If true, then the CSS class on each TD cell will be omitted, which can reduce the amount of output from the component overall by a considerable amount. Leave this as false, the default, when you are leveraging the CSS to customize the look and feel of particular columns.	boolean			prop
overrides	Where to search for property override blocks.	org.apache.tapestry5.PropertyOverrides	Required, Not Null		prop
row	The current row being rendered, this is primarily an output parameter used to allow the Grid, and the Grid's container, to know what object is being rendered.	Object	Required		prop
rowClass	Parameter used to set the CSS class for each row (each tr element) within the tbody). This is not cached, so it will be recomputed for each row.	String	Not Cached		prop
rowIndex	Optional output parameter (only set during rendering) that identifies the current row index. This is the index on the page (i.e., always numbered from zero) as opposed to the row index inside the org.apache.tapestry5.grid.GridDataSource.	int			prop
rowsPerPage	Number of rows displayed on each page. Long result sets are split across multiple pages.	int	Required		prop
volatile	If true and the component is enclosed by a Form, then the normal state saving logic is turned off. Defaults to false, enabling state saving logic within Forms. This can be set to false when form elements within the Grid are not related to the current row of the grid, or where another component (such as org.apache.tapestry5.corelib.components.Hidden) is used to maintain row state.	boolean			prop

Constructor Summary

GridRows()

Method Summary

String	getCellClass()
String	getPropertyName()
List<String>	getPropertyNames()
String	getRowClass()
void	setPropertyName(String propertyName)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GridRows

public GridRows()

Method Detail

getRowClass

public String getRowClass()

getCellClass

public String getCellClass()

getPropertyNames

public List<String> getPropertyNames()

getPropertyName

public String getPropertyName()

setPropertyName

public void setPropertyName(String propertyName)