Documentation

Search 

Contents

  1. Introduction
  2. Getting Started
  3. ICEfaces Concepts
  4. Code View Support
  5. Design View Support
  6. Tag Object Toolbars
  7. Server Behaviors
  8. Property Inspectors
Selected 9. ICEfaces Tag Reference

10. ICEfaces Tag Reference

Contents > ICEfaces Tag Reference > ice:dataPaginator

< ice:commandSortHeader ice:dataTable >

ice:dataPaginator

The ice:dataPaginator tag is used in conjunction with a data table. The dataPaginator may be used to render a set of page navigation facets and access attributes of the underlying DataModel specified in the associated data table. Using the dataPaginator, a data table containing a large DataModel can be viewed as multiple "pages" of table rows instead of as one large table.

Example

<ice:dataTable value="#{BackingBean.carList}" var="car" id="cars" rows="2">
  <ice:column>
    <f:facet name="header">
      <ice:outputText value="Make" />
    </f:facet>
    <ice:outputText value="#{car.make}" />
  </ice:column> 
</ice:dataTable>
<ice:dataPaginator for="cars" id="scroll" vertical="false" paginator="true" styleClass="carNumber">
  <f:facet name="first">
    <ice:outputText value="First" />
  </f:facet>
  <f:facet name="last"> 
    <ice:outputText value="Last" />
  </f:facet>
  <f:facet name="previous">
    <ice:outputText value="Previous" />
  </f:facet>
  <f:facet name="next"> 
    <ice:outputText value="Next" /> 
  </f:facet>
</ice:dataPaginator>

Rendered Output

Rendered ice:dataPaginator tag

Tag Attributes

actionListener Text
 
The actionListener attribute accepts a method-binding expression for a backing bean action listener method that will be notified when this component is activated by the user. An action listener method must be a public method with an javax.faces.event.ActionEvent parameter and a void return type.
binding Expression
 
The value-binding expression linking this component tag to a backing bean property.
disabled Boolean
 
The disabled attribute is a boolean flag that when set to true indicates that this component should not receive focus or be included in a form submit.
displayedRowsCountVar Text
 
The displayedRowsCountVar attribute sets the name of a request-scope attribute exposing the actual display rows count in the underlying data model.
enabledOnUserRole Text
 
The enabledOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed and will function. If the user does not have a role, then the component will be disabled (will not function) and will be grayed out.
fastStep Text
 
The fastStep attribute sets the step (pages) used for fastforward and fastrewind.
firstRowIndexVar Text
 
The firstRowIndexVar attribute sets the name of a request-scope attribute exposing the actual first displayed row index in the underlying data model.
for Text
 
The for attribute sets the id of the data table.
id Text
 
The unique identifier value for this component. The value must be unique within the closest naming container.
immediate Boolean
 
The immediate attribute is a boolean flag indicating that component events should be sent to registered event listeners immediately rather than after the validation phase of the JSF request processing lifecycle. The immediate flag allows you bypass JSF validation for a particular component.
lastRowIndexVar Text
 
The lastRowIndexVar attribute sets the name of a request-scope attribute exposing the actual last displayed row index in the underlying data model.
pageCountVar Text
 
The pageCountVar attribute sets the name of a request-scope attribute exposing the actual page count in the underlying data model.
pageIndexVar Text
 
The pageIndexVar attribute sets the name of a request-scope attribute exposing the actual page index in the underlying data model.
paginator Boolean
 
The paginator attribute is a boolean flag that when set to "true" will display the page number links.
paginatorMaxPages Text
 
The paginatorMaxPages attribute sets the maximum number of pages to be displayed in the paginator.
renderFacetsIfSinglePage Boolean
 
The renderFacetsIfSinglePage attribute is a boolean flag that when set to "false" will not display the data scroller when only a single page of data exists.
rendered Boolean
 
A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
renderedOnUserRole Text
 
The renderedOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed. If the user does not have a role, then the component will not be displayed.
rowsCountVar Text
 
The rowsCountVar attribute sets the name of a request-scope attribute exposing the actual number of rows in the underlying data model.
style CSS Style
 
The style attribute sets the CSS style definition to be applied to this component when it is rendered.
styleClass CSS Class
 
The styleClass attribute sets a space-separated list of CSS style class(es) to be applied when this element is rendered. If the component is enabled, then use "iceDatPgrScrBtn", "iceDatPgrScrOut", "iceDatPgrSrcCol", "iceDatPgrCol", and "iceDatPgrTbl". If the component is disabled, the use "iceDatPgrScrBtn-dis", "iceDatPgrScrOut-dis", "iceDatPgrSrcCol-dis", "iceDatPgrCol-dis", and "iceDatPgrTbl-dis".
vertical Text
 
The vertical attribute is a boolean flas that when set to "true" will display the data vertically. The defaul value is "false".
< ice:commandSortHeader ice:dataTable >