Page -taglib -2.0分页简介,配置,属性介绍

一简介,
Pager-taglib,支持多种风格的分页显示。实际上她是一个Jsp标签库,为在 JSP上显示分页信息而设计的一套标签,通过这些标签的不同的组合,会形成多种不一样的分页页面,风格各异,她自带的DEMO就有七种左右的分页风格,包括Google的分页风格。而需要订制自已的风格的分页页面也非常简单。
分页方式有两种:
一种是从Action中得到一个List,在页面上通过<pg:item>进行自动分页。
第二种是通过把 pageSize,pageNo两参数传给后台进行数据库分页。

二、准备
把pager-taglib.jar放到lib目录下(仅此足亦,完全没必要改web.xml什么的,还有官方war包中的东西都可以不要)

之后,在JSP页面中使用如下代码:
  1. <%@tagliburi="http://jsptags.com/tags/navigation/pager"prefix="pg"%>

三、标签

1、<pg:pager>,在这个标签库里就充当着一个领袖的作用,一切子标签都在它里面工作。就以上出现的参数进行解释一下:
url:分页的链接根地址,pager标签会在这个链接的基础上附加分页参数。该URL不可带参数,因为Pager会在给出的URL后面加上"?page.offset="来标识当前偏移量。
items:总记录数,pager标签正是根据这个值来计算分页参数的

maxPageItems:每页显示的行数,默认为10

maxIndexPages:在循环输出页码的时候,最大输出多少个页码,默认是10 。如设为5的话,则会出现这样的情况 1 2 3 4 5 .或 3 4 5 6 7 这样的形式,其实她自带的DEMO都喜欢把页数展现出来排成一排。

isOffset:与pg:item配套使用,pg:item是用来显示数据的,实际上大多数情况是我们不需要这个标签,该值默认即可
export: 这个属性比较重要,官方文档也对此作好相对长篇幅的说明。这个属性是让标签给你暴露什么变量,当然这些变量是有选择的,如在Pager标签里,可以暴露出 来的变量有pageOffset及pageNumber,即页码偏移量及页码。通过这两个变量名,可以在Jsp或Java里面从Request里获得。 Export属性接受的值还有表达式,如currentPage=pageNumber表示,把pageNumber的值暴露出来,并赋给一个叫 CurrentPage的变量,这个变量将被保存到Request中,在Jsp或Java中可以得到。scope:有Reuqest、page可选。

2、<pg:param>这个标签很有用,用来设置将要加入到URL的参数。使用Name属性指定即可。另一个参数是 pagesize,这个原本可以在url=”/PageAction.do?pagesize=5来做可是,<pg>标签不支持这样做它给我 们提供了另一个传递变量的方法,对了就是我前面标签讲解中所提到过的标<pg:param>

代码

<pg:pageritems="${totalRows}"url="/PageAction.do?pagesize=5"


这样传递参数不对,应该写成:

代码

<pg:pageritems="${totalRows}"url="/PageAction.do"maxIndexPages="5">

<pg:paramname="pagesize"value="5"/>

另外由于不需要在页面分页所在<pg:param>要去调
再就是<pg:pager>要有items属性

3、<pg:index>这个标签说明分页条显示的内容,在这里你可以设置各种风格的分页显示方式,本例是google风格的分页条。

4、pg:first【第一页的标签】重要参数说明:
export变量的意义:
pageUrl - 分页链接URL地址(最重要的export参数)
pageNumber - 页码
firstItem - 首页第一行的索引值
lastItem - 首页最后一行的索引值

5、pg:pre【上一页标签】重要参数说明:
export变量的意义:
pageUrl - 分页链接URL地址(最重要的export参数)
pageNumber - 页码
firstItem - 前页第一行的索引值
lastItem - 前页最后一行的索引值

6、pg:next【下一页标签】重要参数说明:
export变量的意义:
pageUrl - 分页链接URL地址(最重要的export参数)
pageNumber - 页码
firstItem - 下页第一行的索引值
lastItem - 下页最后一行的索引值

7、pg:last重要参数说明:
export变量的意义:
pageUrl - 分页链接URL地址(最重要的export参数)
pageNumber - 页码
firstItem - 尾页第一行的索引值
lastItem - 尾页最后一行的索引值

8、pg:pages【这个标签用来循环输出页码信息】重要参数说明:
export变量的意义:
pageUrl - 分页链接URL地址(最重要的export参数)
pageNumber - 页码
firstItem - pageNumber这个页码指定的那一页的第一行的索引值
lastItem - pageNumber这个页码指定的那一页的最后一行的索引值

简单的一个网页标签的使用:
<pg:pager items="1001" export="currentPageNumber=pageNumber">
<pg:first><a href="http://zghbwjl.blog.163.com/blog/${pageUrl}">首页</a></pg:first>
<pg:prev><a href="http://zghbwjl.blog.163.com/blog/${pageUrl}">前页</a></pg:prev>
<pg:pages>
<c:choose>
<c:when test="${pageNumber eq currentPageNumber }">
<font color="red">${pageNumber }</font>
</c:when>
<c:otherwise>
<a href="http://zghbwjl.blog.163.com/blog/${pageUrl }">${pageNumber}</a>
</c:otherwise>
</c:choose>
</pg:pages>
<pg:next><a href="http://zghbwjl.blog.163.com/blog/${pageUrl}">下页</a></pg:next>
<pg:last><a href="http://zghbwjl.blog.163.com/blog/${pageUrl}">尾页</a></pg:last>
</pg:pager>

你可能感兴趣的:(taglib)