# r

## Tag dataGrid

- Description:

    The <r:dataGrid> component is used to arrange data objects in a grid. Values in the grid can be updated dynamically from the data model, and Ajax updates can be limited to specific rows. The component supports header, footer, and caption facets.

    @author Anton Belevich

- Component Information
  Info | Value
  --- | ---
  Component Type | `org.richfaces.ui.DataGrid`
  Display Name | None
  Handler Class | `org.richfaces.ui.iteration.dataGrid.DataGridHandler`
  Renderer Type | `org.richfaces.ui.DataGridRenderer`
  Description | The <r:dataGrid> component is used to arrange data objects in a grid. Values in the grid can be updated dynamically from the data model, and Ajax updates can be limited to specific rows. The component supports header, footer, and caption facets. @author Anton Belevich

- Attributes
  Name | Required | Type | Description
  --- | --- | --- | ---
  `binding` | `false` | `javax.el.ValueExpression` (must evaluate to `javax.faces.component.UIComponent`) | The value binding expression used to wire up this component to a component property of a JavaBean class
  `columns` | `false` | `javax.el.ValueExpression` (must evaluate to `int`) | Number of columns to display
  `elements` | `false` | `javax.el.ValueExpression` (must evaluate to `int`) | Number of elements displayed in the grid
  `first` | `false` | `javax.el.ValueExpression` (must evaluate to `int`) | A zero-relative row number of the first row to display
  `id` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
  `iterationStatusVar` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Provides access to the iteration status in a Request scope
  `keepSaved` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Boolean attribute that defines whether this iteration component will reset saved children's state before rendering. By default state is reset if there are no faces messages with severity error or higher.
  `rendered` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.
  `rowKeyConverter` | `false` | `javax.el.ValueExpression` (must evaluate to `javax.faces.convert.Converter`) | Converter for a row key object
  `rowKeyVar` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Provides access to the row key in a Request scope
  `stateVar` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The attribute provides access to a component state on the client side
  `style` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style(s) to be applied when this component is rendered.
  `styleClass` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
  `title` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Advisory title information about markup elements generated for this component.
  `value` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | Points to the data model
  `var` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A request-scope attribute via which the data object for the current row will be used when iterating

Output generated by Vdldoc View Declaration Language Documentation Generator.