The <rich:dataTable> component is used to render a table, including the table's caption. It works in conjunction with the <rich:column> and <rich:columnGroup> components to list the contents of a data model.
@author Anton Belevich| Info | Value |
|---|---|
| Component Type | org.richfaces.DataTable |
| Handler Class | org.richfaces.taglib.DataTableHandler |
| Renderer Type | org.richfaces.DataTableRenderer |
| Description | The <rich:dataTable> component is used to render a table, including the table's caption. It works in conjunction with the <rich:column> and <rich:columnGroup> components to list the contents of a data model. @author Anton Belevich |
| Name | Required | Type | Description |
|---|---|---|---|
binding |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
| The value binding expression used to wire up this component to a component property of a JavaBean class |
captionClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Assigns one or more space-separated CSS class names to the component caption |
cellClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the cells of the table |
columnClasses |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Assigns one or more space-separated CSS class names to the columns of the table. If the CSS class names are comma-separated, each class will be assigned to a particular column in the order they follow in the attribute.If you have less class names than columns, the class will be applied to every n-fold column where n is the order in which the class is listed in the attribute. If there are more class names than columns, the overflow ones are ignored. |
columnFooterCellClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the cells of the subfooter of the table |
columnFooterClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the rows of the subfooter of the table |
columnHeaderCellClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the cells of the subheader of the table |
columnHeaderClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the rows of the subheader of the table |
columnHeaderFirstClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the first row of the subheader of the table |
data |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| Serialized (on default with JSON) data passed to the client by a developer on an AJAX request. It's accessible via "event.data" syntax. Both primitive types and complex types such as arrays and collections can be serialized and used with data |
filterVar |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Name of the variable used in EL expression provided in filterExpression in order to decide about displaying particular row. |
first |
false
| javax.el.ValueExpression
(must evaluate to int)
| A zero-relative row number of the first row to display |
firstColumnFooterClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the first row of the subheader of the table |
firstRowClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the first row of the table |
footerCellClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the cells of the footer of the table |
footerClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to any footer generated for this column. |
footerFirstClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the first row of the footer of the table |
headerCellClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the cells of the header of the table |
headerClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to any header generated for this column. |
headerFirstClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) that will be applied to the first row of the header of the table |
id |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The component identifier for this component. This value must be unique within the closest parent component that is a naming container. |
iterationStatusVar |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Provides access to the iteration status in a Request scope |
keepSaved |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| Boolean attribute that defines whether this iteration component will reset saved children's state before rendering. By default state is reset if there are no faces messages with severity error or higher |
limitRender |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If "true", render only those ids specified in the "render" attribute, forgoing the render of the auto-rendered panels |
noDataLabel |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The label to be displayed when table contains no rows (no data provided). |
onbeforedomupdate |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called after the ajax response comes back, but before the DOM is updated |
oncomplete |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called after the DOM is updated |
onrowclick |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is clicked over table row. |
onrowdblclick |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is double clicked over table row. |
onrowkeydown |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is pressed down over table row. |
onrowkeypress |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is pressed and released over table row. |
onrowkeyup |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is released over table row. |
onrowmousedown |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is pressed down over table row. |
onrowmousemove |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved within table row. |
onrowmouseout |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved away from table row. |
onrowmouseover |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved onto table row. |
onrowmouseup |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is released over table row. |
render |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| IDs of components that will participate in the "render" portion of the Request Processing Lifecycle. Can be a single ID, a space or comma separated list of Id's, or an EL Expression evaluating to an array or Collection. Any of the keywords "@this", "@form", "@all", "@none", "@region" may be specified in the identifier list. Some components make use of additional keywords |
rendered |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true. |
rowClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Assigns one or more space-separated CSS class names to the table cells |
rowClasses |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Assigns one or more space-separated CSS class names to the rows of the table. If the CSS class names are comma-separated, each class will be assigned to a particular row in the order they follow in the attribute.If you have less class names than rows, the class will be applied to every n-fold row where n is the order in which the class is listed in the attribute. If there are more class names than rows, the overflow ones are ignored. |
rowKeyConverter |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.convert.Converter)
| Converter for a row key object |
rowKeyVar |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Provides access to the row key in a Request scope |
rows |
false
| javax.el.ValueExpression
(must evaluate to int)
| The number of rows to display, or zero for all remaining rows in the table |
sortMode |
false
| javax.el.ValueExpression
(must evaluate to org.richfaces.model.SortMode)
| Specifies when table will be sorted according to one column (single) or multiple columns (multi). Default value - "multi" |
sortPriority |
false
| javax.el.ValueExpression
(must evaluate to java.util.Collection)
| Comma-separated list of column names determining priority of row sorting. |
stateVar |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Provides access to the state in a Request scope |
style |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| CSS style(s) to be applied when this component is rendered. |
styleClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. |
value |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| Points to the data model |
var |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| A request-scope attribute via which the data object for the current row will be used when iterating |
Output generated by Vdldoc View Declaration Language Documentation Generator.