分页标签 (page-taglib)使用指南

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

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

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

    <%@ taglib uri= "http://jsptags.com/tags/navigation/pager"  prefix= "pg"  %> 

Java代码  收藏代码

    <%@ taglib uri="http://jsptags.com/tags/navigation/pager" prefix="pg" %> 



三,jsp (第一种分页方案由<pg:item>自行分页 )
Java 代码

    <%@ 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> 
          <% } 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> 

Java代码  收藏代码

    <%@ 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> 
          <% } 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:咳。还需要讲么?

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 代码

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

Java代码  收藏代码

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


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

    <pg:pager items= "${totalRows}"  url= "/PageAction.do" maxIndexPages= "5" > 
     <pg:param name=" pagesize "  value= "5"  /> 

Java代码  收藏代码

    <pg:pager items="${totalRows}" url="/PageAction.do"maxIndexPages="5"> 
     <pg:param name=" pagesize " value="5" /> 

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


六.以下是Demo代码
Java 代码

    <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 ) { %> 
            <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> 

Java代码  收藏代码

    <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) { %> 
            <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> 

你可能感兴趣的:(java,taglib,PAGER)