PagingToolbar是一个分页条，功能和PagingLink相似，可以为DataGrid和DataView提供分页的功能。
表 30.108. 构件信息
| Component Type | org.operamasks.faces.component.widget.UIPagingToolbar |
| Component Family | org.operamasks.faces.component.widget.UIPager |
| Component Class | org.operamasks.faces.component.widget.UIPagingToolbar |
| Tag Class | org.operamasks.faces.webapp.toolbar.UIPagingToolbarTag |
| Renderer Type | org.operamasks.faces.component.widget.UIPagingToolbar |
| Renderer Class | org.operamasks.faces.render.widget.ajax.AjaxPagingToolbarRenderer |
+java.lang.Object
++javax.faces.component.UIComponent
+++javax.faces.component.UIComponentBase
++++org.operamasks.faces.component.widget.base.UIPagerBase
+++++org.operamasks.faces.component.widget.UIPager
++++++org.operamasks.faces.component.toolbar.base.UIPagingToolbarBase
+++++++org.operamasks.faces.component.widget.UIPagingToolbar
表 30.109. 属性
| afterPageText | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 分页器上页数输入框之后的文字 | ||||
| beforePageText | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 分页器上页数输入框之前的文字 | ||||
| binding | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | javax.el.ValueExpression(javax.faces.component.UIComponent) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个值表达式，用于把该组件链接到一个ManagedBean的某个属性。 | ||||
| displayInfo | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.Boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 是否显示提示信息. 设置为true时显示提示信息 | ||||
| displayMsg | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 所显示的提示, default: 'Displaying {0} - {1} of {2}'; | ||||
| emptyMsg | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 没有记录的时候显示的提示, : default: 'No data to display'; | ||||
| firstText | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 分页器首页按钮的tooltip | ||||
| for | 定义类 | org.operamasks.faces.component.widget.base.UIPagerBase | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件所对应的目标组件ID | ||||
| id | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内，必须是唯一的。 | ||||
| jsvar | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 客户端脚本使用的javascript变量名，使用此变量名可以引用脚本中javascript对象 | ||||
| lastText | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 分页器末页按钮的tooltip | ||||
| nextText | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 分页器下一页按钮的tooltip | ||||
| pageSize | 定义类 | org.operamasks.faces.component.widget.base.UIPagerBase | ||
| 类型 | javax.el.ValueExpression(java.lang.Integer) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 每页显示的记录数, default: 20 ; | ||||
| prevText | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 分页器上一页按钮的tooltip | ||||
| refreshText | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 分页器刷新按钮的tooltip | ||||
| rendered | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | boolean(boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个标志，指出该组件是否要在任何随后的form提交过程中被渲染或处理。 这个属性的缺省值是true。 | ||||
| style | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件渲染时应用到构件的CSS风格， 对应于元素的style属性 | ||||
| styleClass | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件上的CSS样式类 | ||||
| target | 定义类 | org.operamasks.faces.component.widget.UIPagingToolbar | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 分页器所依附的容器的id。若未指定，如果pagingToolbar位于dataGrid内部，则默认为该dataGrid，否则这个pagingToolbar将独立出现。 | ||||
以DataView为例子，先定义一个w:dataView，如下：
<w:dataView id="view-example" jsvar="productView" value="#{products}" var="p">
<w:outputColumn id="title" value="#{p.title}"/>
<w:outputColumn id="listPrice" value="#{p.listPrice}"/>
<w:outputColumn id="yourPrice" value="#{p.yourPrice}"/>
<w:outputColumn id="image" value="#{p.image}"/>
<f:facet name="template">
<h:panelGroup layout="block" styleClass="product">
<h:panelGrid columns="2">
<f:verbatim><img src="{image}" title="{title}" class="image"/></f:verbatim>
<h:panelGrid columns="1">
<f:verbatim><span class="title">{title}</span></f:verbatim>
<f:verbatim><span>List Price: </span><span class="listPrice">{listPrice}</span></f:verbatim>
<f:verbatim><span>Your Price: </span><span class="yourPrice">{yourPrice}</span></f:verbatim>
</h:panelGrid>
</h:panelGrid>
</h:panelGroup>
</f:facet>
<f:facet name="empty">
<f:verbatim>No data to display.</f:verbatim>
</f:facet>
</w:dataView>接着定义一个分页条：
<w:pagingToolbar for="view-example" pageSize="1"/>