Shuffy

不断的学习，不断的思考，才能不断的进步.Let's do better together!
posts - 102, comments - 43, trackbacks - 0, articles - 19

分页标签：pager-taglib使用指南

Posted on 2008-11-29 20:45 Shuffy 阅读(490) 评论(0)  编辑 收藏 引用 所属分类: Java
[摘自] http://www.javaeye.com/topic/25147

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

我做两个Demo加以说明对比：

二、准备
把pager-taglib.jar放到lib目录下(仅此足亦，完全没必要改web.xml什么的，还有官方war包中的东西都可以不要)
Java代码 复制代码
  1. <%@ taglib uri="http://jsptags.com/tags/navigation/pager" prefix="pg" %>  


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

Java代码 复制代码
  1. <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>   
  2. <%@ taglib uri="/WEB-INF/tld/c.tld" prefix="c"%>   
  3. <%@ taglib uri="http://jsptags.com/tags/navigation/pager" prefix="pg" %>   
  4. <html>   
  5. <head></head>   
  6. <body>   
  7. <pg:pager    
  8. url="/PageAction.do"    
  9. index="half-full"  
  10. maxPageItems = "3"    
  11.     maxIndexPages="5"    
  12. isOffset = "<%=false%>"    
  13.     export = "pageOffset,currentPageNumber=pageNumber"    
  14.     scope = "request">   
  15.        
  16.  <table>     
  17.     <c:forEach items="${userlist}" var="user">   
  18.     <pg:item>   
  19.      <tr>   
  20.       <td height="39">${user.userId}</td>   
  21.       <td height="39">${user.username}</td>   
  22.       <td height="39">${user.password}</td>   
  23.      </tr>        
  24.     </pg:item>   
  25. </c:forEach>   
  26. </table>     
  27.   <pg:index>   
  28.     <center>   
  29.     <table border=0 cellpadding=0 width=10% cellspacing=0>   
  30.     <tr align=center valign=top>   
  31.     <td valign=bottom><font face=arial,sans-serif   
  32.       size=-1>Result Page: </font></td>   
  33.     <pg:prev ifnull="true">   
  34.       <% if (pageUrl != null) { %>   
  35.         <td align=right><A HREF="<%= pageUrl %>"><IMG   
  36.           SRC=http://www.google.com/nav_previous.gif alt="" border=0><br>   
  37.         <b>Previous</b></A></td>   
  38.       <% } else { %>   
  39.         <td><IMG SRC=http://www.google.com/nav_first.gif alt="" border=0></td>   
  40.       <% } %>   
  41.     </pg:prev>   
  42.     <pg:pages>   
  43.       <% if (pageNumber == currentPageNumber) { %>   
  44.         <td><IMG SRC=http://www.google.com/nav_current.gif alt=""><br>   
  45.         <font color=#A90A08><%=pageNumber%></font></td>   
  46.       <% } else { %>   
  47.         <td><A HREF="<%=pageUrl%>"><IMG   
  48.           SRC=http://www.google.com/nav_page.gif alt="" border=0><br>   
  49.         <%= pageNumber %></A></td>   
  50.       <% } %>   
  51.     </pg:pages>   
  52.     <pg:next ifnull="true">   
  53.       <% if (pageUrl != null) { %>   
  54.         <td><A HREF="<%=pageUrl%>"><IMG   
  55.           SRC=http://www.google.com/nav_next.gif alt="" border=0><br>   
  56.         <b>Next</b></A></td>   
  57.       <% } else { %>   
  58.         <td><IMG SRC=http://www.google.com/nav_last.gif alt="" border=0></td>   
  59.       <% } %>   
  60.     </pg:next>   
  61.     </tr>   
  62.     </table>   
  63.     </center>   
  64.   </pg:index>   
  65.   </pg:pager>   
  66. </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：咳。还需要讲么？

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>

Java代码 复制代码
  1. <pg:pager items="${totalRows} " url="/PageAction.do?pagesize=5"  

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


六．以下是Demo代码

Java代码 复制代码
  1. <pg:pager    
  2.  items="${ totalRows }"  
  3.  url="/PageAction.do"  
  4. index="half-full"  
  5.  maxPageItems = "5"    
  6.  maxIndexPages="10" isOffset = "<%=false%>"    
  7.     export = "pageOffset,currentPageNumber=pageNumber"    
  8.     scope = "request">   
  9.  <pg:param name="pagesize"  value="5" />   
  10.        
  11.  <table align="center">     
  12. <c:forEach items="${userlist}" var="user">   
  13.   <!--pg:item-->   
  14.   <tr>   
  15.       <td height="39">${user.userId}</td>   
  16.       <td height="39">${user.username}</td>   
  17.       <td height="39">${user.password}</td>   
  18.      </tr>     
  19.    <!--/pg:item-->   
  20. </c:forEach>   
  21. </table>    
  22.  <pg:index>   
  23.     <center>   
  24.     <table border=0 cellpadding=0 width=10% cellspacing=0>   
  25.     <tr align=center valign=top>   
  26.     <td valign=bottom><font face=arial,sans-serif   
  27.       size=-1>Result Page: </font></td>   
  28.     <pg:prev ifnull="true">   
  29.       <% if (pageUrl != null) { %>   
  30.         <td align=right><A HREF="<%=pageUrl%>&pageNo=<%=pageNumber%>"><IMG   
  31.           SRC=http://www.google.com/nav_previous.gif alt="" border=0><br>   
  32.         <b>Previous</b></A></td>   
  33.       <% } else { %>   
  34.         <td><IMG SRC=http://www.google.com/nav_first.gif alt="" border=0></td>   
  35.       <% } %>   
  36.     </pg:prev>   
  37.     <pg:pages>   
  38.       <% if (pageNumber == currentPageNumber) { %>   
  39.         <td><IMG SRC=http://www.google.com/nav_current.gif alt=""><br>   
  40.         <font color=#A90A08><%= pageNumber %></font></td>   
  41.       <% } else { %>   
  42.         <td><A HREF="<%=pageUrl%>&pageNo=<%=pageNumber%>"><IMG   
  43.           SRC=http://www.google.com/nav_page.gif alt="" border=0><br>   
  44.         <%=pageNumber%></A></td>   
  45.       <% } %>   
  46.     </pg:pages>   
  47.     <pg:next ifnull="true">   
  48.       <% if (pageUrl != null) { %>   
  49.         <td><A HREF="<%=pageUrl%>&pageNo=<%=pageNumber%>"><IMG   
  50.           SRC=http://www.google.com/nav_next.gif alt="" border=0><br>   
  51.         <b>Next</b></A></td>   
  52.       <% } else { %>   
  53.         <td><IMG SRC=http://www.google.com/nav_last.gif alt="" border=0></td>   
  54.       <% } %>   
  55.     </pg:next>   
  56.     </tr>   
  57.     </table>   
  58.     </center>   
  59.   </pg:index>   
  60.   </pg:pager>  


只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理