当前位置：编程文档 >> JSP >> pager-taglib使用指南
首页

pager-taglib使用指南

所属类别：JSP
推荐指数：★★☆
文档人气：62
本周人气：10
发布日期：2008-7-3

一简介， 
Pager-taglib，支持多种风格的分页显示。实际上她是一个Jsp标签库，为在JSP上显示分页信息而设计的一套标签，通过这些标签的不同的组合，会形成多种不一样的分页页面，风格各异，她自带的DEMO就有七种左右的分页风格，包括Google的分页风格。而需要订制自已的风格的分页页面也非常简单。 
分页方式有两种： 
一种是从Action中得到一个List，在页面上通过<pg:item>进行自动分页。 
第二种是通过把 pageSize,pageNo两参数传给后台进行数据库分页。 我做两个Demo加以说明对比：
二、准备 
把pager-taglib.jar放到lib目录下(仅此足亦，完全没必要改web.xml什么的，还有官方war包中的东西都可以不要) 

代码[list=1]<%@ taglib uri=\"http://jsptags.com/tags/navigation/pager\" prefix=\"pg\" %> 


三，jsp （第一种分页方案由<pg:item>自行分页 ）

代码[list=1]<%@ page language=\"java\" import=\"java.util.*\" pageEncoding=\"UTF-8\"%> 
<%@ taglib uri=\"/WEB-INF/tld/c.tld\" prefix=\"c\"%> <%@ taglib uri=\"http://jsptags.com/tags/navigation/pager\" prefix=\"pg\" %> 
<html> <head></head> 
<body> <pg:pager   
url=\"/PageAction.do\"   index=\"half-full\" 
maxPageItems = \"3\"     maxIndexPages=\"5\"   
isOffset = \"<%=false%>\"     export = \"pageOffset,currentPageNumber=pageNumber\"   
  scope = \"request\">     
<table>     <c:forEach items=\"${userlist}\" var=\"user\"> 
  <pg:item>   <tr> 
    <td height=\"39\">${user.userId}</td>     <td height=\"39\">${user.username}</td> 
    <td height=\"39\">${user.password}</td>   </tr>     
  </pg:item> </c:forEach> 
</table>   <pg:index> 
  <center>   <table border=0 cellpadding=0 width=10% cellspacing=0> 
  <tr align=center valign=top>   <td valign=bottom><font face=arial,sans-serif   
    size=-1>Result Page: </font></td>   <pg:prev ifnull=\"true\"> 
    <% if (pageUrl != null) { %>     <td align=right><A HREF=\"<%= pageUrl %>\"><IMG 
      SRC=http://www.google.com/nav_previous.gif alt=\"\" border=0><br>     <b>Previous</b></A></td>  [Page]
    <% } else { %>     <td><IMG SRC=http://www.google.com/nav_first.gif alt=\"\" border=0></td> 
    <% } %>   </pg:prev> 
  <pg:pages>     <% if (pageNumber == currentPageNumber) { %> 
    <td><IMG SRC=http://www.google.com/nav_current.gif alt=\"\"><br>     <font color=#A90A08><%=pageNumber%></font></td> 
    <% } else { %>     <td><A HREF=\"<%=pageUrl%>\"><IMG 
      SRC=http://www.google.com/nav_page.gif alt=\"\" border=0><br>     <%= pageNumber %></A></td> 
    <% } %>   </pg:pages> 
  <pg:next ifnull=\"true\">     <% if (pageUrl != null) { %> 
    <td><A HREF=\"<%=pageUrl%>\"><IMG       SRC=http://www.google.com/nav_next.gif alt=\"\" border=0><br> 
    <b>Next</b></A></td>     <% } else { %> 
    <td><IMG SRC=http://www.google.com/nav_last.gif alt=\"\" border=0></td>     <% } %> 
  </pg:next>   </tr> 
  </table>   </center> 
</pg:index> </pg:pager> 
</body></html> 

四．标签讲解：从页面里可以看到，这里使用了几个标签
1、<pg:pager>,在这个标签库里就充当着一个领袖的作用，一切子标签都在它里面工作。就以上出现的参数进行解释一下： 
items：数据的纪录数 
maxPageItems：显示最多的纪录数/页 
maxIndexPages：显示最多的分页数/次，如设为5的话，则会出现这样的情况 1 2 3 4 5 .或 3 4 5 6 7 这样的形式，其实她自带的DEMO都喜欢把页数展现出来排成一排。 
isOffset：与pg:item配套使用 
export：这个属性比较重要，文档也对此作好相对长篇幅的说明。这个属性是让标签给你暴露什么变量，当然这些变量是有选择的，如在Pager标签里，可以暴露出来的变量有pageOffset及pageNumber，即页码偏移量及页码。通过这两个变量名，可以在Jsp或Java里面从Request里获得。Export属性接受的值还有表达式，如currentPage=pageNumber表示，把pageNumber的值暴露出来，并赋给一个叫CurrentPage的变量，这个变量将被保存到Request中，在Jsp或Java中可以得到。 
scope：咳。还需要讲么？ [Page]
2、<pg:param>这个标签很有用，用来设置将要加入到URL的参数。使用Name属性指定即可。在这个Demo中我们还没有用的参数传递，下一个Demo你会看到它的用法。
3、<pg:index>这个标签说明分页条显示的内容，在这里你可以设置各种风格的分页显示方式，本例是google风格的分页条。 
4, <pg:prev> , <pg:pages>,<pg:next>这些标签都是导航标签顾名思义,你一看例子就明白了，我就不用讲了吧。
五，第二种分页方案 
与页面自行分页不同的是还需要给后台传两个参数， 
一个是pageNo（当前页数） 
可以在每一个PageUrl后面都加了&pageNo=<%= pageNumber %>。让我们的URL带上页码的参数，这样程序可以拿到页码去查找所需要的数据，你可以去比较一下两Demo的代码。OK，另一个参数是pagesize,这个原本可以在url=”/PageAction.do?pagesize=5来做可是，<pg>标签不支持这样做它给我们提供了另一个传递变量的方法，对了就是我前面标签讲解中所提到过的标<pg:param>

代码[list=1]<pg:pager items=\"${totalRows} \" url=\"/PageAction.do?pagesize=5\" 

这样传递参数不对，应该写成： 
代码[list=1]<pg:pager items=\"${totalRows}\" url=\"/PageAction.do\"maxIndexPages=\"5\">   
<pg:param name=\" pagesize \" value=\"5\" /> 
另外由于不需要在页面分页所在<pg:param>要去调 
再就是<pg:pager>要有items属性 
六．以下是Demo代码

代码[list=1]<pg:pager   
items=\"${ totalRows }\" url=\"/PageAction.do\" 
index=\"half-full\" maxPageItems = \"5\"   
maxIndexPages=\"10\" isOffset = \"<%=false%>\"     export = \"pageOffset,currentPageNumber=pageNumber\"   
  scope = \"request\"> <pg:param name=\"pagesize\" value=\"5\" /> 
    <table align=\"center\">   
<c:forEach items=\"${userlist}\" var=\"user\"> <!--pg:item--> 
<tr>     <td height=\"39\">${user.userId}</td> 
    <td height=\"39\">${user.username}</td>     <td height=\"39\">${user.password}</td> 
  </tr>     <!--/pg:item--> 
</c:forEach> </table>   
<pg:index>   <center> 
  <table border=0 cellpadding=0 width=10% cellspacing=0>   <tr align=center valign=top> 
  <td valign=bottom><font face=arial,sans-serif       size=-1>Result Page: </font></td> 
  <pg:prev ifnull=\"true\">     <% if (pageUrl != null) { %>  [Page]
    <td align=right><A HREF=\"<%=pageUrl%>&pageNo=<%=pageNumber%>\"><IMG       SRC=http://www.google.com/nav_previous.gif alt=\"\" border=0><br> 
    <b>Previous</b></A></td>     <% } else { %> 
    <td><IMG SRC=http://www.google.com/nav_first.gif alt=\"\" border=0></td>     <% } %> 
  </pg:prev>   <pg:pages> 
    <% if (pageNumber == currentPageNumber) { %>     <td><IMG SRC=http://www.google.com/nav_current.gif alt=\"\"><br> 
    <font color=#A90A08><%= pageNumber %></font></td>     <% } else { %> 
    <td><A HREF=\"<%=pageUrl%>&pageNo=<%=pageNumber%>\"><IMG       SRC=http://www.google.com/nav_page.gif alt=\"\" border=0><br> 
    <%=pageNumber%></A></td>     <% } %> 
  </pg:pages>   <pg:next ifnull=\"true\"> 
    <% if (pageUrl != null) { %>     <td><A HREF=\"<%=pageUrl%>&pageNo=<%=pageNumber%>\"><IMG 
      SRC=http://www.google.com/nav_next.gif alt=\"\" border=0><br>     <b>Next</b></A></td> 
    <% } else { %>     <td><IMG SRC=http://www.google.com/nav_last.gif alt=\"\" border=0></td> 
    <% } %>   </pg:next> 
  </tr>   </table> 
  </center> </pg:index> 
</pg:pager>

文档说明：

     

相关文档


读取评论列表……