JBoss.orgCommunity Documentation
The <rich:scrollableDataTable> component is used for the table-like component creation. The component just adds the set of additional features described below in comparison with the standard table.
Highly customizable look and feel
Variable content of the table cells
Dynamically fetching the rows from the server when the table is scrolled up and down
Resizing columns by mouse dragging the column bar
Sorting column by clicking the header
Fixed one or more left columns when table is scrolled horizontally
One and multi-selection rows mode
Built-it drag-n-drop support
Table 6.485. rich : scrollableDataTable attributes
Attribute Name | Description |
---|---|
activeClass | A CSS class to be applied to an active row |
activeRowKey | Request scope attribute under which the activeRowKey will be accessible |
ajaxKeys | This attribute defines row keys that are updated after an AJAX request |
binding | The attribute takes a value-binding expression for a component property of a backing bean |
bypassUpdates | If "true", after process validations phase it skips updates of model beans on a force render response. It can be used for validating components input |
columnClasses | 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 |
componentState | It defines EL-binding for a component state for saving or redefinition |
data | Serialized (on default with JSON) data passed on the client by a developer on AJAX request. It's accessible via "data.foo" syntax |
eventsQueue | Name of requests queue to avoid send next request before complete other from same event. Can be used to reduce number of requests of frequently events (key press, mouse move etc.) |
first | A zero-relative row number of the first row to display |
footerClass | Space-separated list of CSS style class(es) that are be applied to any footer generated for this table |
frozenColCount | Defines the number of the fixed columns from the left side that will not be scrolled via horizontal scroll. Default value is "0". |
headerClass | Space-separated list of CSS style class(es) that are be applied to any header generated for this table |
height | Defines a height of the component. Default value is "500px". |
hideWhenScrolling | If "true" data will be hidden during scrolling. Can be used for increase performance. Default value is "false". |
id | Every component may have a unique id that is automatically created if omitted |
ignoreDupResponses | Attribute allows to ignore an Ajax Response produced by a request if the newest 'similar' request is in a queue already. ignoreDupResponses="true" does not cancel the request while it is processed on the server, but just allows to avoid unnecessary updates on the client side if the response isn't actual now |
onRowClick | HTML: a script expression; a pointer button is clicked on row |
onRowDblClick | HTML: a script expression; a pointer button is double-clicked on row |
onRowMouseDown | HTML: script expression; a pointer button is pressed down on row |
onRowMouseUp | HTML: script expression; a pointer button is released on row |
onselectionchange | HTML: script expression to invoke on changing of rows selection |
rendered | If "false", this component is not rendered |
requestDelay | Attribute defines the time (in ms.) that the request will be wait in the queue before it is ready to send. When the delay time is over, the request will be sent to the server or removed if the newest 'similar' request is in a queue already |
reRender | 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 |
rowClasses | 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 | Converter for a row key object |
rowKeyVar | The attribute provides access to a row key in a Request scope |
rows | A number of rows to display, or zero for all remaining rows in the table |
scriptVar | Name of JavaScript variable corresponding to component |
selectedClass | Name of the CSS class for a selected row |
selection | Value binding representing selected rows |
similarityGroupingId | If there are any component requests with identical IDs then these requests will be grouped. |
sortMode | Defines mode of sorting. Possible values are 'single' for sorting of one column and 'multi' for some. |
sortOrder | ValueBinding pointing at a property of a class to manage rows sorting |
stateVar | The attribute provides access to a component state on the client side |
status | ID (in format of call UIComponent.findComponent()) of Request status component |
style | CSS style(s) is/are to be applied when this component is rendered |
styleClass | Corresponds to the HTML class attribute |
timeout | Response waiting time on a particular request. If a response is not received during this time, the request is aborted |
value | The current value for this component |
var | A request-scope attribute via which the data object for the current row will be used when iterating |
width | Defines a width of the component. Default value is "700px". |