View Source

h2. Overview
_Since 4.0_

The mobi:dataView component renders lists of data in a table. It is more simplified than ace:dataTable and is geared for mobile devices, in terms of the user interface and performance.

h2. Getting Started

The basic use case is very straightforward. The value references a list of data objects, which are rendered as rows, with their properties in {{mobi:dataViewColumn}}'s.

{code:xml}
<h:form>
<mobi:dataView value="#{bean.items}" var="item" rowStripe="true">
<mobi:dataViewColumns>
<mobi:dataViewColumn headerText="Property A" value="#{item.propertyA}" />
<mobi:dataViewColumn headerText="Property B" value="#{item.propertyB}" />
<mobi:dataViewColumn headerText="Property C" value="#{item.propertyC}" />
</mobi:dataViewColumns>
</mobi:dataView>
</h:form>
{code}

h2. Attributes

{tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://res.icesoft.org/docs/v4_latest/mobi/tld/].{tip}

{panel}
The *value* specifies the list or instance of DataViewLazyDataModel that contains the data to be displayed.
{panel}

{panel}
The *var* attribute specifies the variable name to be used when rendering the columns or the details region.
{panel}

{panel}
The *rowStripe* attribute is a flag to enable background shading on the odd numbered rows.
{panel}

h2. Event Listeners

None.

h2. Client Behavior Events

| select | Fired when a row is selected. It enables server-side updates of the details area. |

h2. JavaScript API

None.

h2. Keyboard Support

None.

h2. Known Issues

None.

h2. Additional Resources


h4. Sample Applications

This component appears in the following ICEfaces sample applications:

* *[ICEfaces Mobile Showcase|http://icefaces-showcase.icesoft.org/showcase-mobile.jsf]*

h4. Tutorials

This component appears in the following ICEfaces tutorials:

*None*