Overview | Library | Tag | Help
| FRAMES NO FRAMES

## RichFaces ( Legacy URL )
Tag dataTable

The <rich:dataTable> component for tables rendering that allows choosing data from a model and obtains built-in support of Ajax updates.

Tag Information
Tag Class | org.richfaces.taglib.DataTableTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
ajaxKeys | false | false | `javax.el.ValueExpression` (must evaluate to `java.util.Set`) | This attribute defines row keys that are updated after an AJAX request
align | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Deprecated. This attribute specifies the position of the table with respect to the document. The possible values are "left", "center" and "right". The default value is "left".
bgcolor | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Deprecated. This attribute sets the background color for the document body or table cells. This attribute sets the background color of the canvas for the document body (the BODY element) or for tables (the TABLE, TR, TH, and TD elements). Additional attributes for specifying text color can be used with the BODY element. This attribute has been deprecated in favor of style sheets for specifying background color information
binding | false | false | `javax.el.ValueExpression` (must evaluate to `javax.faces.component.UIComponent`) | The attribute takes a value-binding expression for a component property of a backing bean
border | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | This attributes specifies the width of the frame around a component. Default value is "0".
captionClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Space-separated list of CSS style class(es) that are be applied to caption for this component
captionStyle | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style(s) is/are to be applied to caption when this component is rendered
cellpadding | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | This attribute specifies the amount of space between the border of the cell and its contents. Default value is "0".
cellspacing | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | This attribute specifies the amount of space between the border of the cell and its contents. The attribute also specifies the amount of space to leave between cells. Default value is "0".
columnClasses | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Comma-delimited list of CSS style classes that are be applied to the columns of this table. A space separated list of classes may also be specified for any individual column. If the number of elements in this list is less than the number of columns specified in the "columns" attribute, no "class" attribute is output for each column greater than the number of elements in the list. If the number of elements in the list is greater than the number of columns specified in the "columns" attribute, the elements at the position in the list after the value of the "columns" attribute are ignored
columns | false | false | `javax.el.ValueExpression` (must evaluate to `int`) | Number of columns
columnsWidth | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Comma-separated list of width attribute for every column. Specifies a default width for each column in the table. In addition to the standard pixel, percentage, and relative values, this attribute allows the special form "0*" (zero asterisk) which means that the width of the each column in the group should be the minimum width necessary to hold the column's contents. This implies that a column's entire contents must be known before its width may be correctly computed. Authors should be aware that specifying "0*" will prevent visual user agents from rendering a table incrementally
componentState | false | false | `javax.el.ValueExpression` (must evaluate to `org.ajax4jsf.model.DataComponentState`) | It defines EL-binding for a component state for saving or redefinition
dir | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left)
first | false | false | `javax.el.ValueExpression` (must evaluate to `int`) | A zero-relative row number of the first row to display
footerClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Space-separated list of CSS style class(es) that are be applied to footer for this component
frame | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | This attribute specifies which sides of the frame surrounding a table will be visible. Possible values: "void", "above", "below", "hsides", "lhs", "rhs", "vsides", "box" and "border". The default value is "void".
headerClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Space-separated list of CSS style class(es) that are be applied to header for this component
id | false | false | `java.lang.String` | Every component may have a unique id that is automatically created if omitted
lang | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Code describing the language used in the generated markup for this component
onRowClick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer button is clicked on row
onRowContextMenu | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | JavaScript handler to be called on right click. Returning false prevents default browser context menu from being displayed
onRowDblClick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer button is double-clicked on row
onRowMouseDown | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; a pointer button is pressed down on row
onRowMouseMove | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved within of row
onRowMouseOut | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved away of row
onRowMouseOver | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved onto of row
onRowMouseUp | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; a pointer button is released on row
onclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer button is clicked
ondblclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer button is double-clicked
onkeydown | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a key is pressed down
onkeypress | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a key is pressed and released
onkeyup | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a key is released
onmousedown | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; a pointer button is pressed down
onmousemove | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved within
onmouseout | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved away
onmouseover | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved onto
onmouseup | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; a pointer button is released
reRender | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | Id['s] (in format of call UIComponent.findComponent()) of components, rendered in case of AjaxRequest caused by this component. Can be single id, comma-separated list of Id's, or EL Expression with array or Collection
rendered | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | If "false", this component is not rendered
rowClasses | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A comma-delimited list of CSS style classes that is applied to popup table rows. A space separated list of classes may also be specified for any individual row. The styles are applied, in turn, to each row in the table. For example, if the list has two elements, the first style class in the list is applied to the first row, the second to the second row, the first to the third row, the second to the fourth row, etc. In other words, we keep iterating through the list until we reach the end, and then we start at the beginning again
rowKeyConverter | false | false | `javax.el.ValueExpression` (must evaluate to `javax.faces.convert.Converter`) | Converter for a RowKey object.
rowKeyVar | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The attribute provides access to a row key in a Request scope
rows | false | false | `javax.el.ValueExpression` (must evaluate to `int`) | A number of rows to display, or zero for all remaining rows in the table
rules | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | This attribute specifies which rules will appear between cells within a table. The rendering of rules is user agent dependent. Possible values: * none: No rules. This is the default value. * groups: Rules will appear between row groups (see THEAD, TFOOT, and TBODY) and column groups (see COLGROUP and COL) only. * rows: Rules will appear between rows only. * cols: Rules will appear between columns only. * all: Rules will appear between all rows and columns
sortMode | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines mode of sorting. Possible values are 'single' for sorting of one column and 'multi' for some.
sortPriority | false | false | `javax.el.ValueExpression` (must evaluate to `java.util.Collection`) | Defines a set of columns ids in the sorting order
stateVar | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The attribute provides access to a component state on the client side
style | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style(s) is/are to be applied when this component is rendered
styleClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Corresponds to the HTML class attribute
title | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Advisory title information about markup elements generated for this component
value | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | The current value for this component
var | false | false | `java.lang.String` | A request-scope attribute via which the data object for the current row will be used when iterating
width | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | This attribute specifies the desired width of the entire table and is intended for visual user agents. When the value is percentage value, the value is relative to the user agent's available horizontal space. In the absence of any width specification, table width is determined by the user agent

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.