Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICEfaces EE Composite Components
Tag richDataGrid

## The Rich Data Grid Composite Component

### Features

- Direct, inline editing of row data
- Column filtering
- Create new rows
- Delete rows
- Column reordering
- Column auto-sorting
- Column resizing
- Auto-pagination and pagination info
- Complete event model and listener callbacks for all table events
- Hide and show columns
- Edits are done in a safe 'edit space' and the direct objects are untouched until the data is saved
- When a row is selected for editing, it becomes locked in edit mode until the changes are either saved or cancelled
- Supports editing of text, list, date, and boolean data
- Columns can be made editable or non-editable

### How To Use

1. Add the <ice-cc:richDataGrid/> tag to your page. Nest <ice-cc:css/> in your page <head> tag.
2. Bind the 'bean' attribute to an instance of RichDataGridBean
3. If you would like to receive event notifications, implement the IEditableTableEventListener class and pass it to the constructor of the RichDataGridBean
4. For auto-generation of columns, simply pass in a List of items to the RichDataGridBean constructor
5. To specify columns, pass in an array of IRichDataColumn objects to the RichDataGridBean constructor

Example:

    <ice-cc:richDataGrid id="richDataGrid" bean="#{richDataGridExampleBean.richDataGridBean}"/>

Tag Information
Tag Class | javax.faces.webapp.FacetTag
TagExtraInfo Class | None
Body Content | tagdependent
Display Name | Rich Data Grid

Attributes
Name | Required | Request-time | Type | Description
id | true | false | `java.lang.String` | A unique id for the component.
bean | true | false | `com.icesoft.faces.facelets.component.table.richdatagrid.RichDataGridBean` | A value binding to the RichDataGridBean instance.
rendered | false | false | `java.lang.Boolean` | Flag indicating whether this component should be rendered (during Render Response Phase), or processed on any subsequent form submit (default true).
deleteRows | false | false | `java.lang.Boolean` | Component level ability to delete table rows. Defaults to true.
addRows | false | false | `java.lang.Boolean` | Component level ability to add table rows. Defaults to true.
editRows | false | false | `java.lang.Boolean` | Component level ability to edit table rows. Defaults to true.
style | false | false | `java.lang.String` | CSS style(s) to be applied when this component is rendered
rows | false | false | `java.lang.Integer` | Passed through to the ice:dataTable
showDataPagerInfo | false | false | `java.lang.Boolean` | Flag indicating whether or not the info dataPaginator in the header above the dataTable should be rendered (default true).
showDataPager | false | false | `java.lang.Boolean` | Flag indicating whether or not the dataPaginator in the dataTable footer should be rendered (default true).
showRowControls | false | false | `java.lang.Boolean` | Flag indicating whether or not the row controls in the dataTable footer should be rendered (default true).
panelStyle | false | false | `java.lang.String` | Passed through to the style attribute on the footer ice:panelGroup containing the dataPaginator and row controls.
cellpadding | false | false | `java.lang.String` | Definition of how much space the user agent should leave between the border of each cell and its contents.
cellspacing | false | false | `java.lang.String` | Definition of how much space the user agent should leave between the left side of the table and the leftmost column, the top of the table and the top of the top side of the topmost row, and so on for the right and bottom of the table. It also specifies the amount of space to leave between cells.
columnClasses | false | false | `java.lang.String` | Comma-delimited list of CSS style classes that will 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 posisiton in the list after the value of the "columns" attribute are ignored. If the value of this attribute is not being set, the tableRenderer would render the default classes using the following pattern (e.g.) |  |  |  | .... The above class pattern would allow you to define the base style in the "column" class and if you want to customize any of the specific column you can override the column+index class.
rowClasses | false | false | `java.lang.String` | Comma-delimited list of CSS style classes that will be applied to the rows of this table. A space separated list of classes may also be specified for any individual row. Thes 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. The default classes rendered as iceDatTblRow1, iceDatTblRow2 alternatively.
footerClass | false | false | `java.lang.String` | Space-separated list of CSS style class(es) that will be applied to any footer generated for this table. The default classe rendered as iceDatTblFtr.
headerClass | false | false | `java.lang.String` | Space-separated list of CSS style class(es) that will be applied to any header generated for this table. The default class would rendered as iceDatTblHdr.
headerClasses | false | false | `java.lang.String` | This attribute can be used to define the separate style classes for the each header of the each column. The default would rendered as : iceDatTblColHdr1, iceDatTblColHdr2 alternatively Note: The attribute has been deprecated.
rules | false | false | `java.lang.String` | Code specifying which rules will appear between cells within this table. Valid values are: none (no rules, default value); groups (between row groups); rows (between rows only); cols (between columns only); and all (between all rows and columns).
summary | false | false | `java.lang.String` | Summary of this table's purpose and structure, for user agents rendering to non-visual media such as speech and Braille.
styleClass | false | false | `java.lang.String` | Space-separated list of CSS style class(es) to be applied when this element is rendered.
title | false | false | `java.lang.String` | Passed through to underlying component
multiple | false | false | `java.lang.Boolean` | Pass through attribute to ice:rowSelector component
preStyleOnSelection | false | false | `java.lang.Boolean` | Pass through attribute to ice:rowSelector component
pagerStyle | false | false | `java.lang.String` | Style passed through to the data pager
readOnly | false | false | `java.lang.Boolean` | If set to true (default false) will not allow row editing, creation, or deletion
disableMenus | false | false | `java.lang.Boolean` | If set to true (default false) will not display richt click popup menus for adding a new row, or hiding or showing columns
titleProperty | false | false | `java.lang.String` | The property of the row item to be rendered as the row-level column ouput title
fastStep | false | false | `java.lang.Integer` | Passed through to ice:dataPaginator

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.