The dataGrid Component is a grid component. It can be compared to the grid found in the list part of the modern file explorer. It allows sorts, resizing, contextual menus ...
| Attributes |
| Name | Required | Request-time | Type | Description |
| id | false | false | java.lang.String |
A string specifying the identifier for this component. This value must be
unique within the closest parent component that is a naming
container.
|
| binding | false | false | java.lang.String |
The value binding expression linking this component to a property in a backing bean.
|
| rendered | false | true | java.lang.String |
A boolean value indicating whether or not this component should be rendered
(during Render Response Phase), or processed on any subsequent
form submit.
|
| value | false | true | java.lang.String |
A string value holding the current value of the component.
|
| hiddenMode | false | true | java.lang.String |
A string value specifying the management of invisible state on the client.
Authorized values are :
-
server : if not visible, nothing is sent to the client
-
phantom : if not visible, the data is sent to the client and the page estate is reserved for a futur eventual display of the component
-
ignore : if not visible, the data is sent to the client but no page estate is reserved
|
| visible | false | true | java.lang.String |
A boolean value indicating wether the composant is visible.
|
| height | false | true | java.lang.String |
A string value (as specified by CSS) for the height of the component.
|
| width | false | true | java.lang.String |
A string value (as specified by CSS) for the width of the component.
|
| helpMessage | false | true | java.lang.String |
A string value specifying the message to be shown by a helpMessageZone Component.
|
| helpURL | false | true | java.lang.String |
An URL that points to a help page for the component. it is used for example by a helpButton Component.
|
| toolTipText | false | true | java.lang.String |
A string value specifying the tooltip for the component (shown when the pointe hover the component).
|
| mouseOutListener | false | true | java.lang.String |
Executed when the pointer leaves the area of the component.
A string that represent a javascript expression to evaluate.
|
| mouseOverListener | false | true | java.lang.String |
Executed when the pointer hover the component's area.
A string that represent a javascript expression to evaluate.
|
| unlockedClientAttributeNames | false | true | java.lang.String |
A string value holding a comma separated list of the client modifiable properties.
|
| lookId | false | true | java.lang.String |
A string value specifying the choosen look of the component.
|
| blurListener | false | true | java.lang.String |
Executed when the focus quits the component.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| focusListener | false | true | java.lang.String |
Executed when the component gets the focus.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| x | false | true | java.lang.String |
A string value (as specified by CSS) for the x position of the component.
|
| y | false | true | java.lang.String |
A string value (as specified by CSS) for the x position of the component.
|
| marginBottom | false | true | java.lang.String |
A string value specifying the margin size for the component's bottom (compliant to CSS margin-bottom).
|
| marginLeft | false | true | java.lang.String |
A string value specifying the margin size for the component's left (compliant to CSS margin-left).
|
| marginRight | false | true | java.lang.String |
A string value specifying the margin size for the component's right (compliant to CSS margin-right).
|
| marginTop | false | true | java.lang.String |
A string value specifying the margin size for the component's top (compliant to CSS margin-top).
|
| backgroundColor | false | true | java.lang.String |
A color value (as specified by CSS) for the background.
|
| foregroundColor | false | true | java.lang.String |
A color value (as specified by CSS) for the text.
|
| keyPressListener | false | true | java.lang.String |
Executed when the component detects a key pressed event.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| keyDownListener | false | true | java.lang.String |
Executed when the component detects a key down event.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| keyUpListener | false | true | java.lang.String |
Executed when the component detects a key up event.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| resetListener | false | true | java.lang.String |
Executed when the reset button is activated on a form.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| styleClass | false | true | java.lang.String |
A space-separated list of CSS style class(es) to be applied to the component. This value will be passed through as the "class" attribute on generated markup.
|
| userEventListener | false | true | java.lang.String |
Executed when the component is called.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| propertyChangeListener | false | true | java.lang.String |
Executed when a component's property is changed (by javascript).
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| initListener | false | true | java.lang.String |
Executed when the component is intialized.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| margins | false | true | java.lang.String |
A string value specifying the margins for the component (compliant to CSS margin).
|
| var | false | true | java.lang.String |
A string value holding the name of a request-scope attribute under which the model data for the
row selected by the current value of the "rowIndex" property (i.e.
also the current value of the "rowData" property) will be exposed.
|
| first | false | true | java.lang.String |
A number identifying the row to be displayed at the top of the component.
|
| rows | false | true | java.lang.String |
An int value specifying the number of rows to display, starting with the one identified by the
"first" property. If this value is set to zero, all available rows in
the underlying data model will be displayed.
|
| selectionListener | false | true | java.lang.String |
Executed when the component is selected.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| selectable | false | true | java.lang.String |
A boolean value indicating wether the component can receive a user's selection
|
| selectionCardinality | false | true | java.lang.String |
A string value specifying the type of multiple selection authorized:
-
zeromany|*: any number of selections or none
-
one|1: one and only one selection
-
onemany|+: one or more selection
-
optionnal|?: none or one selection
|
| checkListener | false | true | java.lang.String |
Executed when the component is checked.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| checkable | false | true | java.lang.String |
A boolean value indcating wether the component can be checked. cf. checkCardinality.
|
| checkCardinality | false | true | java.lang.String |
A string indicating the cardinality (number of check allowed) for this componenent.
|
| doubleClickListener | false | true | java.lang.String |
Executed when the component is double-clicked.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|
| required | false | true | java.lang.String |
A boolean value indicating that the user is required to provide a submitted
value for this input component.
|
| border | false | true | java.lang.String |
A boolean value that indicates if the component should show a border or not.
|
| readOnly | false | true | java.lang.String |
A boolean value indicating that this component will prohibit
changes by the user. The element may receive focus
unless it has also been disabled.
|
| disabled | false | true | java.lang.String |
A boolean value that represents the disabled state of the component.
|
| horizontalScrollPosition | false | true | java.lang.String |
A string value specifying the position of the horizontal scroolbar.
|
| verticalScrollPosition | false | true | java.lang.String |
A string value specifying the position of the vertical scroolbar (Browser dependant).
|
| filterProperties | false | true | java.lang.String |
A binded object that hold the filters to use on the server side. This property is often set via javascript code.
|
| preference | false | true | java.lang.String |
A binded object that holds the preferences for the component.
|
| headerVisible | false | true | java.lang.String |
A boolean value indicating wether the header should be visible.
|
| paged | false | true | java.lang.String |
A boolean value specifying wether the results should be displayed by page (thus letting the user choose what page to display via the pager).
It is ignored if the attribute "rows" is undefined.
The default value is true.
If "rows" is defined and "paged"'s value is set to false, pages are downloaded automatically when the last displayed row is selected.
|
| selectedValues | false | true | java.lang.String |
A table of the values associated with selected nodes for the component. (Binding only)
|
| checkedValues | false | true | java.lang.String |
A table of the values associated with checked nodes for the component. (Binding only)
|
| sortedColumnIds | false | true | java.lang.String |
A string value giving the ordered list of the sorted column ids. read-only
|
| columnsOrder | false | true | java.lang.String |
A list of the columns' id which represents their order from left to right.
|
| rowValueColumnId | false | true | java.lang.String |
An id for the column containing the key for the row.
|
| rowCountVar | false | true | java.lang.String |
A string value specifying the name of the variable receiving the number of rows.
|
| rowIndexVar | false | true | java.lang.String |
A string value specifying the name of the variable receiving the index of the current row.
|
| clientSelectionFullState | false | true | java.lang.String |
A boolean value indicating wether the client should know about the component's full state even if only a part of the data is present (AJAX).
|
| clientCheckFullState | false | true | java.lang.String |
A boolean value indicating wether the client should know about the component's full state even if only a part of the data is present (AJAX).
|
| action | false | true | java.lang.String |
A string that indicates the url to activate on the server when the component is actionned through a key mapping on the faces config file.
|
| actionListener | false | true | java.lang.String |
Executed when the the component is activated by the user.
A string that represent a javascript expression to evaluate and eventually a server action to execute.
the two parts are separated by a semi-column.
If the javascript evaluation return false (by using the return keyword) the server action is not executed.
The server action is represented by a binding.
|