分页pager-taglib使用指南

分页pager-taglib使用指南

一简介
Pager-taglib，是一套分页标签库，可以灵活地实现多种不同风格的分页导航页面，并且可以很好的与服务器分页逻辑分离支持多种风格的分页显示。通过这些标签的不同的组合，会形成多种不一样的分页页面，风格各异，它自带的DEMO就有七种左右的分页风格，包括Google的分页风格。而需要订制自已的风格的分页页面也非常简单。
分页方式有两种：
一种是从Action中得到一个List，在页面上通过<pg:item>进行自动分页。
第二种是通过把 pageSize,pageNo两参数传给后台进行数据库分页。

本文只演示第二种数据库分页：普通form提交方式和对开源ajaxAnywhere的支持

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

<% @ taglib uri = " /WEB-INF/pager-taglib.tld "  prefix = " pg " %>
<% @ taglib prefix = " c "  uri = " /WEB-INF/c.tld " %>

三，form提交方式

１．将公用的部分提出来单独放在公共的jsp文件中pagination_tag.jsp

< table border = 0  cellpadding = 0  cellspacing = 0  align = right >
     < tr align = center valign = top >
         < pg:page export = " first,last " >
             < td >
                $ {first}   -  $ {last}  of $ {total} & nbsp; & nbsp;
             </ td >
         </ pg:page >
         < pg:first export = " pageUrl "  unless = " current " >
             < td >
                 < c: if  test = " ${pageUrl!=null } " >
                     < A HREF = " ${pageUrl} " >   < b > [第一页] </ b >   </ A >
                 </ c: if >
             </ td >
         </ pg:first >
         < pg:prev export = " pageUrl "  ifnull = " ${true } " >
             < td align = right >
                 < c: if  test = " ${pageUrl!=null } " >
                     < A HREF = " ${pageUrl} " >   < b > [前一页] & nbsp; </ b >   </ A >
                 </ c: if >
             </ td >
         </ pg:prev >
         < pg:pages >
             < td align = right >
                 < c:choose >
                     < c:when test = " ${pageNumber == currentPageNumber} " >
                         < font color = #A90A08 > $ {pageNumber} & nbsp; </ font >
                     </ c:when >
                     < c:otherwise >
                         < A HREF = " ${pageUrl} " > $ {pageNumber} & nbsp; </ A >
                     </ c:otherwise >
                 </ c:choose >
             </ td >
         </ pg:pages >
         < pg:next export = " pageUrl "  ifnull = " ${true } " >
             < td >
                 < c: if  test = " ${pageUrl!=null } " >
                     < A HREF = " ${pageUrl} " >   < b > [下一页] </ b >   </ A >
                 </ c: if >
             </ td >
         </ pg:next >
         < pg:last export = " pageUrl "  unless = " current " >
             < td >
                 < c: if  test = " ${pageUrl!=null } " >
                     < A HREF = " ${pageUrl} " >   < b > [最后页] </ b >   </ A >
                 </ c: if >
             </ td >
         </ pg:last >
     </ tr >
</ table >

２．使用方法

< pg:pager url = " /CrmWeb/jsp/integrateAccept/custOrder.do "  items = " ${total} "  maxPageItems = " ${pageSize} "
 maxIndexPages = " ${5} "  isOffset = " ${true} "  export = " offset,currentPageNumber=pageNumber "
 scope = " request " >
  < pg:param name = " method "  value = " qryOrder "   />
< table >      
<c:forEach var="vo" items="${custOrders}">
< tr >
< td  >... </ td >  
</ tr >
</ c:forEach >
</ table >   
< pg:index >
< jsp:include page = " pagination_tag.jsp "  flush = " true "   />
  </ pg:index >
</ pg:pager >

四．对ajaxAnywhere的分页支持

１．将公用的部分提出来单独放在公共的jsp文件中pagination_tag_ajax.jsp

< table border = 0  cellpadding = 0  cellspacing = 0  align = right >
     < tr align = center valign = top >
         < pg:page export = " first,last " >
             < td >
                $ {first}   -  $ {last}  of $ {total} & nbsp; & nbsp;
             </ td >
         </ pg:page >
         < pg:first export = " pageUrl "  unless = " current " >
             < td >
                 < c: if  test = " ${pageUrl!=null } " >
                     < A HREF = " # "  onClick = " javascript:{${ajaxInvoke}('${pageUrl}');} " >   < b > [µÚÒ»Ò³] </ b >   </ A >
                 </ c: if >
             </ td >
         </ pg:first >
         < pg:prev export = " pageUrl "  ifnull = " ${true } " >
             < td align = right >
                 < c: if  test = " ${pageUrl!=null } " >
                     < A HREF = " # "  onClick = " javascript:{${ajaxInvoke}('${pageUrl}');} " >   < b > [Ç°Ò»Ò³] & nbsp; </ b >   </ A >
                 </ c: if >
             </ td >
         </ pg:prev >
         < pg:pages >
             < td align = right >
                 < c:choose >
                     < c:when test = " ${pageNumber == currentPageNumber} " >
                         < font color = #A90A08 > $ {pageNumber} & nbsp; </ font >
                     </ c:when >
                     < c:otherwise >
                         < A HREF = " # "  onClick = " javascript:{${ajaxInvoke}('${pageUrl}');} " > $ {pageNumber} & nbsp; </ A >
                     </ c:otherwise >
                 </ c:choose >
             </ td >
         </ pg:pages >
         < pg:next export = " pageUrl "  ifnull = " ${true } " >
             < td >
                 < c: if  test = " ${pageUrl!=null } " >
                     < A HREF = " # "  onClick = " javascript:{${ajaxInvoke}('${pageUrl}');} " >   < b > [ÏÂÒ»Ò³] </ b >   </ A >
                 </ c: if >
             </ td >
         </ pg:next >
         < pg:last export = " pageUrl "  unless = " current " >
             < td >
                 < c: if  test = " ${pageUrl!=null } " >
                     < A HREF = " # "  onClick = " javascript:{${ajaxInvoke}('${pageUrl}');} " >   < b > [×îºóÒ³] </ b >   </ A >
                 </ c: if >
             </ td >
         </ pg:last >
     </ tr >
</ table >

２．使用方法

<% @ taglib prefix = " aa "  uri = " /WEB-INF/ajaxanywhere.tld " %>
< script src = " <c:url value= " / js / aa.js " /> " ></ script >

< c:set var = " ajaxInvoke "  scope = " request " > ajaxPaginationInvoke </ c:set >

< aa:zone name = " next_step " >
<pg:pager url="/CrmWeb/jsp/integrateAccept/custOrder.do" items="${total}" maxPageItems="${pageSize}"
 maxIndexPages="${5}" isOffset="${true}" export="offset,currentPageNumber=pageNumber"
 scope="request">
 <pg:param name="method" value="qryOrder" />
<table> 
      ......
<c:forEach var="vo" items="${custOrders}">
<tr>
<td >...</td> 
</tr>
</c:forEach>
</ table >   
< pg:index >
< jsp:include page = " pagination_tag_ajax.jsp "  flush = " true "   />
  </ pg:index >
</ pg:pager >
</ aa:zone >

< script >
ajaxAnywhere.formName  =   " ajax_form " ;
function  ajaxPaginationInvoke(url) {
    document.frames['ajax_form'].action=url;
    ajaxAnywhere.submitAJAX();
}
ajaxAnywhere.onAfterResponseProcessing =   function  () {
}
< script >

效果见下图
 

五．标签讲解：从页面里可以看到，这里使用了几个标签

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属性指定即可。
3、<pg:index>这个标签说明分页条显示的内容，在这里你可以设置各种风格的分页显示方式。
4, <pg:prev> , <pg:pages>,<pg:next>这些标签都是导航标签顾名思义,你一看例子就明白了，我就不用讲了吧。