| |||||||
FRAMES NO FRAMES |
Tag Information | |
Tag Class | org.openfaces.taglib.jsp.table.DataTableJspTag |
TagExtraInfo Class | None |
Body Content | JSP |
Display Name | None |
Attributes | |||||
Name | Required | Binding Type | EL | Default | Description |
align | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | The alignment of the table content. Available values are: "left" "center" "right" |
allRecordsFilterText | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "<All>" | Text that is displayed instead of " |
applyDefaultStyle | false | javax.el.ValueExpression
(must evaluate to boolean )
| true | true | A flag that indicates whether or not to apply the default style. |
autoFilterDelay | false | javax.el.ValueExpression
(must evaluate to int )
| true | 700 | Specifies the delay in milliseconds when the filtering is performed automatically after the user has entered some value in an associated filter, or turns off automatic filtering in case -1 is specified as a value for this attribute. |
bgcolor | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | The background color behind the table content. |
binding | false | javax.el.ValueExpression
(must evaluate to org.openfaces.component.table.DataTable )
| only | null | A value-binding expression that associates the DataTable with a backing bean property. |
bodyOddRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for DataTable odd rows, if it should be different from bodyRowClass. |
bodyOddRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for DataTable odd rows, if should be different from bodyRowStyle. |
bodyRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for DataTable rows. |
bodyRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for DataTable rows. |
bodySectionClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the DataTable body section. |
bodySectionStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the DataTable body section. |
border | false | javax.el.ValueExpression
(must evaluate to int )
| true | Integer.MIN_VALUE | The number of pixels in the DataTable border. The value Integer.MIN_VALUE means there is no border rendered. |
cellpadding | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | The amount of space between the border of the cell and its content. The value null means there is no cell spacing rendered. |
cellspacing | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | The amount of space between the cells in the DataTable. The value null means there is no cell spacing rendered. |
columnIdVar | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| false | null | The name of the variable under which the column identifier is available when specifying a condition for the cell tag. |
columnIndexVar | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| false | null | The name of the variable under which the column index is available when specifying a condition for the cell tag. |
columnsOrder | false | javax.el.ValueExpression
(must evaluate to java.util.List )
| only | null | The order of columns in the DataTable component. This attribute should be bound to a list containing column IDs for each column in the order you want them to be displayed. If the "columnsOrder" attribute is not specified, all the columns are rendered in the order they are defined. |
commonFooterRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the DataTable footer row. |
commonFooterRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the DataTable footer row. |
commonFooterSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "1px solid #a0a0a0" | A style for a line that separates the table footer from the rest of the table. Should be specified as the CSS "border" property but without the prefix "border:". |
commonHeaderRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the DataTable header row. |
commonHeaderRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the DataTable header row. |
commonHeaderSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "1px solid #a0a0a0" | A style for a line that separates the table header from the rest of the table. Should be specified as the CSS "border" property but without the prefix "border:". |
customDataProviding | false | javax.el.ValueExpression
(must evaluate to boolean )
| true | false | If this attribute is set to "true", then it is the responsibility of a developer to provide the paged data through the "value" attribute. In this case, two additional request-scope variables are available when evaluating the "value" attribute: rangeStart and rangeSize. These variables specify which rows the "value" attribute should return. rangeStart is the index of the first returned row, and rangeSize defines the number of rows that should be returned. When this attribute is set to "true", the "totalRowCount" and "rowDataByKey" attributes must also be defined. |
dir | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "LTR" | The reading order of the table columns and content. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left) Available values are: "LTR" — from left to right "RTL" — from right to left |
emptyRecordsFilterText | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "<Empty>" | Text that is displayed instead of " |
focusedClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name of the DataTable component when it is focused. |
focusedStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style of the DataTable component when it is focused. |
footerHorizSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "1px solid #a0a0a0" | A style for a line that separates the footer section from the body section. Should be specified as the CSS "border" property but without the prefix "border:". |
footerRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the column footer row. |
footerRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the column footer row. |
footerSectionClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the DataTable footer section. |
footerSectionStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the DataTable footer section. |
footerVertSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "none, 1px solid #a0a0a0" | A style for vertical lines between column footers. Should be specified as the CSS "border" property but without the prefix "border:". It can also be specified as a list of comma-separated gridline styles when column groups are used and group separators should be different from column separators. See verticalGridLines attribute for details. |
headerHorizSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "1px solid #a0a0a0" | A style for a line that separates the header section from the body section. Should be specified as the CSS "border" property but without the prefix "border:". |
headerRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the column header row. |
headerRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the column header row. |
headerSectionClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the DataTable header section. |
headerSectionStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the DataTable header section. |
headerVertSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "none, 1px solid #a0a0a0" | A style for vertical lines between column headers. Should be specified as the CSS "border" property but without the prefix "border:". It can also be specified as a list of comma-separated gridline styles when column groups are used and group separators should be different from column separators. See verticalGridLines attribute for details. |
horizontalGridLines | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "1px solid #e0e0e0" | A style for horizontal lines in the DataTable body. Should be specified as the CSS "border" property but without the prefix "border:". |
id | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| false | null | The component identifier. |
multiFooterSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "none, 1px solid #a0a0a0" | A style for a line that separates multiple footer rows when column groups are used. It can also be specified as a list of comma-separated gridline styles when there are multiple levels of nested column groups. |
multiHeaderSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "none, 1px solid #a0a0a0" | A style for a line that separates multiple header rows when column groups are used. It can also be specified as a list of comma-separated gridline styles when there are multiple levels of nested column groups. |
noDataMessageAllowed | false | javax.el.ValueExpression
(must evaluate to boolean )
| true | true | A flag that indicates whether or not to show "noDataMessage". |
noDataRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the row that displays "noDataMessage". |
noDataRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the row that displays "noDataMessage". |
nonEmptyRecordsFilterText | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "<Non-empty>" | Text that is displayed instead of " |
onblur | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the DataTable loses focus. |
onclick | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed on the client when the user clicks the left mouse button over the DataTable. |
oncontextmenu | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the user presses right mouse button over the component (or performs the other context menu invocation action depending on the platform). |
ondblclick | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed on the client when the user double-clicks the left mouse button over the DataTable. |
onfocus | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the DataTable receives focus. |
onkeydown | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the user presses a key over the DataTable. |
onkeypress | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed on the client when the user presses and releases a key over the DataTable. |
onkeyup | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the user releases a key over the DataTable. |
onmousedown | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the user clicks over the DataTable with either mouse button. |
onmousemove | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the user moves the mouse pointer over the DataTable. |
onmouseout | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the user moves the mouse pointer away from the DataTable. |
onmouseover | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the user moves the mouse pointer onto the DataTable. |
onmouseup | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | JavaScript code that should be executed when the user releases a mouse button over the DataTable. |
pageIndex | false | javax.el.ValueExpression
(must evaluate to int )
| true | 0 | The number of a currently displayed page. This attribute is effective only if the "pageSize" attribute is specified. |
pageSize | false | javax.el.ValueExpression
(must evaluate to int )
| true | 0 | The number of rows to be displayed on each table page. If it is set to "0", no pagination is available. |
paginationKeyboardSupport | false | javax.el.ValueExpression
(must evaluate to boolean )
| true | true | A flag that indicates whether or not to enable the keyboard support for pagination. |
rendered | false | javax.el.ValueExpression
(must evaluate to boolean )
| true | true | A flag that indicates whether or not the component is visible. |
rolloverClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the DataTable component in the rollover state. |
rolloverRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for a DataTable row in the rollover state. |
rolloverRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for a DataTable row in the rollover state. |
rolloverStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the DataTable component in the rollover state. |
rowDataByKey | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| only | null | A value-binding expression that should return row data by a request-scope rowKey variable. This variable is required when the "customPaging" attribute is set to "true". |
rowIndexVar | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| false | null | The name of the variable under which the current row index is available when declaring components inside columns or specifying a condition for the row and cell tags. |
rowKey | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| only | null | A row key that must uniquely identify an appropriate row. All rowKey objects should be serializable and correctly implement the equals() and hashCode() methods. |
rules | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "none" | Specifies which gridlines are displayed between the cells in the DataTable component. Available values are: "all" — between all rows and columns "cols" — between columns only "groups" — between row groups and column groups only "none" — no grid lines "rows" — between rows only |
sortableHeaderClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name that is applied to the header of a sortable column. |
sortableHeaderRolloverClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name that is applied to the header of a sortable column in the rollover state. |
sortableHeaderRolloverStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style that is applied to the header of a sortable column in the rollover state. |
sortableHeaderStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style that is applied to the header of a sortable column. |
sortAscending | false | javax.el.ValueExpression
(must evaluate to boolean )
| true | true | The sorting order of the data in the DataTable component. The "true" value means the table is sorted in ascending order. |
sortColumnId | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | The identifier of a column by which the DataTable component is sorted. |
sortedAscendingImageUrl | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | URL to the image file that is used to render the image that displays the ascending sort direction. |
sortedColumnBodyClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the sorted column's body. |
sortedColumnBodyStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the sorted column's body. |
sortedColumnClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the entire sorted column. |
sortedColumnFooterClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the sorted column's footer. |
sortedColumnFooterStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the sorted column's footer. |
sortedColumnHeaderClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the sorted column's header. |
sortedColumnHeaderStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the sorted column's header. |
sortedColumnStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the entire sorted column. |
sortedDescendingImageUrl | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | URL to the image file that is used to render the image that displays the descending sort direction. |
style | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the entire DataTable component. |
styleClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the entire DataTable component. |
subHeaderRowClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A CSS class name for the sub-header row (usually contains the filter components). |
subHeaderRowSeparator | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for a line that separates a sub-header row and the column header. |
subHeaderRowStyle | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | A style for the sub-header row (usually contains the filter components). |
tabindex | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | Specifies a numeric value that defines input focus traversing order for this component. |
totalRowCount | false | javax.el.ValueExpression
(must evaluate to int )
| only | null | The number of rows on all table pages according to current filtering options. Must be specified if the "customPaging" attribute is set to "true". |
useAjax | false | javax.el.ValueExpression
(must evaluate to boolean )
| true | true | A flag that indicates whether or not to use Ajax for sorting, filtering and pagination. |
value | false | javax.el.ValueExpression
(must evaluate to java.lang.Object )
| only | null | Specifies a set of rows displayed in the DataTable component. |
var | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| false | null | The name of a request-scope variable under which the current row data is available when specifying columns. |
verticalGridLines | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | "none, 1px solid #e0e0e0" | A style for vertical lines in the DataTable body. Should be specified as the CSS "border" property but without the prefix "border:". This attribute can also accept the comma-separated list of similarly-formatted gridline styles for specifying separators between different levels of column groups. The first item in this list corresponds to separators between the columns, the second one specifies styles for separators between group separators, and so on if more separators are required in case of a deeper hierarchy of column groups. |
width | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| true | null | The width of the DataTable. Can be specified in any units (px, mm, em, etc.). |
Variables | No Variables Defined. |
| |||||||
FRAMES NO FRAMES |