Sunbor 分页标签

此分页Taglib是为数据列表中的分页功能而设计的。

sunbor:page 标签

标签的使用比较简单，sunbor:page 标签例子如下：

<sunbor:page name="queryPage" url="/customer/customer.do?" pageListSize = "10">
</sunbor:page>

将生成类似下图的页面：

其中， name 属性指定 Page 对象在 request 上下文中的 Attribute 名称，此属性为必须。

url 指定翻页或者到指定页的基本路径。标签将在此路径的基础上添加分页参数如&pageno=1&rowsize=15。

url 为可选属性，如果不指定url属性，则必须在标签体里面指定url，如：

<sunbor:page name="queryPage" addContextPath="false" pageListSize = "10">
<sunbor:url><c:url value="/customer/customer.do" />?method=列表</sunbor:url>
</sunbor:page>

pageListSize 属性指定页面上列出的可转向页的数量.如上例,设为 10 ,则将显示类似如下的页面:

[ 1,2,3,4,5,6,7,8,9,10 >>]

分页功能依赖于类Page。类Page必须具有以下属性：

• 页号属性：可用参数 pagenoProperty 设定，缺省为 pageno。
• 每页行数属性：可用参数 rowsizeProperty 设定，缺省为 rowsize。
• 总页数：可用参数 totalPageProperty 设定，缺省为 total。
• 总行数：可用参数 totalrowsProperty 设定，缺省为 totalrows。

当然，也可以按照自己所需要的格式输出，如：

<sunbor:page name="queryPage" addContextPath="false" pageListSize = "10">
<sunbor:url><c:url value="/customer/customer.do" />?method=列表</sunbor:url>
<bean:message key="page.the"/>第 {0} 页 | 共 {2} 页 | 总共 {3} 行 |
<a href="{4}">第一页</a> | <a href="{5}">前一页</a> | [ {11} ] |
<a href="{6}">后一页</a> | <a href="{7}">最后页</a> ||
每页行数:{8} | <a href="javascript:{10}">转到</a> 第{9}页
</sunbor:page>

其中，大括号包含数字的为替换参数。各个参数的替换如下：

{0}页号
{1}每页行数
{2}总页数
{3}总行数
{4}转到第一页的链接
{5}转到前一页的链接
{6}转到下一页的链接
{7}转到最后页的链接
{8}每页行数的文本输入框
{9}转到页号文本输入框
{10}按输入的每页行数和转到页号，实现转向的 javascript 脚本
{11}形如 << 1,2,3 >> 的列表

sunbor:columnHead 标签

此标签为列表表头标签，可以显示列表的可排序表头。使用例子如下：

<sunbor:columnHead url="/customer/customer.do?">
<sunbor:column property="name">名称</sunbor:column>
<sunbor:column property="address">地址</sunbor:column>
</sunbor:columnHead>

其中 url 属性意义同 sunbor:page 标签。

sunbor:columnHead 标签具有的其他可选属性如下：

• htmlTag: sunbor:column 标签生成的html标记，缺省为 th.生成的html标签将类似 <th class="">...</th>.
• sortableStyleClass:未排序的列的css类型,缺省为 sortable
• sortedUpStyleClass:正向排序的列的css类型,缺省为 order1 sortable sorted
• sortedDownStyleClass:反向排序的列的css类型, 缺省为 order2 sortable sorted

sunbor:column标签

指定列的标题.其中属性 property 对应将要排序的对象的属性.此标签必须包含在 sunbor:columnHead 标签内.