分页标签库Pager

---

N.1 简介

使用Pagers标签库可以实现分页功能。

开发者主页

N.2 用法

JSP中动态生成表格的代码一般如下所示：

<table>
<%...
for(int i =0; i< 行数; i++)
{
%>
<tr>
<td>内容</td>
</tr>
<%...
}
%>
</table>

在本章中我使用pg作为Pager标签库的前缀。

如果要使用Pager标签库进行分页处理的话，需要使用<pg:pager>标签将<table>包括在内，然后在内部使用一系列的Pager标签表示上一页、下一页等控制按钮。常用的控制标签如下表所示：

标签说明pager主标签，包括整个动态表格first第一页skip页面跳转prev上一页pages页码next下一页last最后一页

下面是一个例子，源代码如下所示：

<%...
Vector<String[]> v = (Vector<String[]>)request.getAttribute("table_list");
int maxPageItems=25;
String url="/INtools/Db/ListTable.action";
int item_count= v.size();
int page_count= item_count % maxPageItems==0 ? item_count/ maxPageItems : item_count/ maxPageItems+1;
%>
<formid="form1" name="form1" method="post" action="">
<pg:pager
items="<%= item_count %>"
url="<%= url %>"
index="center"
maxPageItems="<%= maxPageItems %>"
maxIndexPages="10"
isOffset="true"
export="offset,currentPageNumber=pageNumber"
scope="request">
<tableborder="1" cellspacing="0" cellpadding="3" bordercolordark="#ffffff"
bordercolorlight="#000066" width='100%'bgcolor="#76a6c7">
<tr class="table_desc">
<td colspan="3">后台表集合</td>
</tr>
<tr class="table_title">
<td width="33%">表名</td>
<td width="33%">所属模块</td>
<td width="34%">操作</td>
</tr>
<%...
for(int iRow = offset.intValue(), l= Math.min(iRow+ maxPageItems, v.size()); iRow< l; iRow++)
{
String[] row_data= v.get(iRow);
String table_name= row_data[0];
String module_name= row_data[1];
String table_id= row_data[2];
String bgcolor= iRow %2==0 ?"#f4fbff" : "#FFFFDD";
%>
<pg:item>
<tr bgcolor="<%=bgcolor%>" class="table_data">
<td align="left"><%=table_name%></td>
<td align="left"><%=module_name%></td>
<td align="center">
<input type="button" value="修改"/>&nbsp;
<input type="button" value="删除"/>
</td>
</tr>
</pg:item>
<%...
}
%>
<tr class="table_page_break">
<td colspan="3">
记录数:<%= item_count%>&nbsp;
页数：<%= page_count %>&nbsp;
<pg:first export="firstPageUrl=pageUrl" unless="current">
<a href="<%= firstPageUrl %>">|&lt;</a>
</pg:first>
<pg:skip export="skipBackPageUrl=pageUrl" pages="<%= -10 %>">
<a href="<%= skipBackPageUrl %>">&lt;&lt;&lt;</a>
</pg:skip>
<pg:prev export="prevPageUrl=pageUrl">
<a href="<%= prevPageUrl %>">&lt;&lt;</a>
</pg:prev>
<pg:pages><%...
if (pageNumber== currentPageNumber) {
%><b><%= pageNumber %></b><%...
}else {
%><a href="<%= pageUrl %>"><%= pageNumber %></a><%...
}
%></pg:pages>
<pg:next export="nextPageUrl=pageUrl">
<a href="<%= nextPageUrl %>">&gt;&gt;</a>
</pg:next>
<pg:skip export="skipForwardPageUrl=pageUrl" pages="<%= 10 %>">
<a href="<%= skipForwardPageUrl %>">&gt;&gt;&gt;</a>
</pg:skip>
<pg:last export="lastPageUrl=pageUrl" unless="current">
<a href="<%= lastPageUrl %>">&gt;|</a>
</pg:last>
<input type="text" size="4" name="page_no" id="page_no"/>
<input type="button" value="go" onclick="goto_page_no()"/>
</td>
</tr>
<tr class="table_button_row">
<td colspan="3">
<input type="button" value="确定" class="form_button"/>
</td>
</tr>
</table>
</pg:pager>
</form>
<scripttype="text/javascript">...

function goto_page_no()
...{
var em_page_no= document.all["page_no"];
var page_no= parseInt(em_page_no.value);
var offset=<%= maxPageItems%>* (page_no-1);
document.location.href="<%= url %>?pager.offset="+ offset;
}

</script>

分页效果如下图所示：

获取数据

该段代码用于获取显示的页面数据，在此做了如下设定，取得的显示数据的格式为Vector<String[]>，每页显示25行记录，获取页数据时需要重新执行查询，其处理操作为/INtools/Db/ListTable.action，这里我使用了struts框架，这表示一个servlet处理类，也可以是一个JSP文件。并进行了页数计算。

pager标签

• items：表示记录数
• url：表示获取数据时的处理程序
• index：页码的显示方式，可以为center、forward、half-full
• maxPageItems：每页显示的记录数
• maxIndexPages：显示的页码数
• isOffset；
• export：将pager标签支持的变量导出，

N.3 技巧

如果要实现如下功能：

• 指定跳转到某页
• 生成分页内容时需要参数TableName

可写入如下代码：

<formid="form1" name="form1" method="get" action="...">
...
<pg:param name="TableName" value="<%= search_table_name %>"/>
<input type="hidden" name="TableName" id="TableName" value="<%= search_table_name %>"/>
<input type="hidden" name="pager.offset"/>
<input type="button" value="go" onclick="goto_page_no()"/>
...
</form>

<scripttype="text/javascript">...

function goto_page_no()
...{
var offset= 记录偏移值;
var frm= document.form1;
frm.elements["pager.offset"].value= offset;
frm.submit();
}

</script>

其中<pg:param>是用于点击页码翻页时提供查询参数，如果打开生成后的源代码，会发现所有的翻页标记(<a>)都加了一个参数TableName，而<input type="hidden" name="TableName" />则用于指定跳转页时提供查询参数，<input type="hidden" name="pager.offset" />则用于提供指定跳转页时的记录偏移量，其名称格式为“[pager].[pg:pager标签的export属性中的offset表示法]”。

值得注意的是，此处的<form>需要使用“get”方式，如果使用“post”方式，使用跳转按钮提交的“TableName”参数会翻倍，例如，第一次为“a”，第二次则为“a,a”。