推荐一款PHP+jQuery制作的列表分页的功能模块_php实例

做了一个列表分页的功能模块，主要的文件包括分页类 page.class.php 和 控制 ajax 分页的ajax.js，主要功能有：

1.可以选择 3 种常见的 url 分页格式；

2.可以选择 url 分页 还是 ajax 分页；

3.两种分页方式都可以自定义分页 a 标签的文字；

4.url 分页方式可以自定义分页偏移量；

5.url 分页方式可以选择手动跳转方式：手动输入页码跳转 或 下拉菜单选择页码跳转。

列表分页功能含有但不一定全部包含的元素包括：

首页、下一页、上一页、末页、具体页码、手动输入的跳转至第几页、下拉菜单选择跳转至第几页、信息( 共多少页、共多少条、当前是第几页 )等。

其中必须包含的元素有：上一页、下一页、具体页码。

先看看其他网站是怎么做的( 百度搜索、虎扑、淘宝、虾米、织梦官网 )：

1.百度搜索就是由最简单的"上一页"、"下一页"和具体页码构成。分页偏移量为前5页后4页

2.虎扑话题( http://bbs.hupu.com/topic-5)的页码包括了"上一页"、"下一页"、具体页码、手动输入跳转至第几页、信息等元素，还包括首页和末页，只不过这里的首页和末页不是用文字而是用具体页码表现出来。分页偏移量前后都是4页。博客园的列表页( http://www.cnblogs.com/cate/php/#p12) 是相同的处理方式。

3.淘宝网宝贝列表页( http://s.taobao.com/list?spm=a217v.7289245.1997888733.7.4JHYae&seller_type=taobao&sort=sale-desc&cat=50029216&sd=0&tid=0&olu=yes&isnew=2&navid=city&smc=1&_input_charset=utf-8&tab=all&app=list&s=0&auction_tag[]=12034)，包含"上一页"、"下一页"、具体页码、信息、手动输入跳转至第几页 ( 还有个小小的效果，点击去第几页的输入框时会弹出确定按钮 )，也包含首页，只不过首页是用页码1代替。分页偏移量前后都是2页

4.虾米列表( http://www.xiami.com/collect/recommend?spm=a1z1s.2943601.6856193.30.dqFWiZ)，包含"上一页"、"下一页"、具体页码、可跳转的省略页码( ... )、信息，也包括以页码1显示的首页。分页偏移量为前2页后5页

最后是织梦官网文章列表页( http://www.dedecms.com/news/list_133_11.html)，包含了"首页"、"上一页"、"下一页"、具体页码、"末页"、下拉菜单选择跳转至第几页、信息。分页偏移量前后都是5页：

浏览至第11页时非常遗憾，宽度过宽导致版式出现问题：

这个分页功能的做法和效果是：

1.url 分页 style1：

①手动输入跳转页码的方式：

始终显示最后一页

"..."跳转至 当前显示的除末页的最大页码的下一页，鼠标放在上面给出提示

前后偏移量可自定义，可相同可不同，前面的"..."跳转至最前页除首页的页码的前一页

②下拉菜单选择跳转的方式：

2.url 分页 style2：

使用"首页"和"末页"代替页码"1"和最后一页页码，使用前n页、后n页代替"..."

为了使"前10页"和"后10页"同时出现，增加了数据库的数据

同样有下拉菜单跳转方式

3.ajax 分页：

出现的元素只有"首页"、"上一页"、"下一页"和"末页"。

首页时：

中间时：

末页时：

模块的文件结构图：

ROOT:
├─conn
│ └─conn.php
│
├─libs -- smarty库
│
├─templates
│ │
│ ├─demo.html -- 功能页模板文件
│ │
│ ├─css
│ │ ├─common.css
│ │ └─style1.css
│ │
│ ├─images
│ │ └─loading.gif -- ajax分页时请求数据接收到之前的加载图
│ └─js
│ ├─jquery-1.8.3.min.js
│ └─ajax.js -- 当分页方式为ajax时模板demo.html加载的js
│
├─templates_c
│
├─init.inc.php -- smarty配置文件
│
├─page.class.php -- 分页类
│
├─demo.php
│
└─ajaxpage.php -- ajax分页时接受请求的php文件

要注意的地方：

1.偏移量的显示设置，主要是什么时候 url 分页方式1，什么时候显示"..." ：当前页码 - 前偏移量 - 1 > 1 时，应当显示前面的"..."； 当前页码 + 后偏移量 + 1

2.选择性加载 js ：当使用 ajax 方式进行分页时，才加载 ajax.js

3.外部的 js 无法解析 smarty 的标签，所以在使用外部 js 时的传值要进行处理

4.ajax 分页时，默认是第一页，也就是一定首先会出现 "下一页" 和 "末页"，所以 "上一页" 和 "首页" 的添加和点击函数应当包含在"下一页" 和 "末页" 的点击函数中。

主要代码：

page.class.php:

";    
  private $preFonts = "totalNum = $totalNum;
    $this->perpageNum = $perpageNum;
    $this->prePage = $prePage;
    $this->floPage = $floPage;
    $this->skipStyle = $skipStyle;
    $this->pageStyle = $pageStyle;
    $this->page_n = $page_n;
    $this->page_act = $page_act;

    $this->getPageNow($p);

    $this->totalPage = $this->getTotalPage(); //总页数

    $this->pageShow = "";
    $this->getUrl();
  }
      

  /************定义__toString方法,把对象解析成字符串******/
  public function __toString(){
  
    return $this->pageShow;
  }

  /************获得当前页页码,$p用来接收$_GET['p']*******/
  public function getPageNow($p){
  
    if(!isset($p)){
      
      $this->pageNow = 1;
    }else if($p>0){
      
      $this->pageNow = $p;  
    }else{
    
      die("page number error");
    }

    return $this->pageNow;
  }



  /***********************设置当前页面链接***************/
  public function getUrl(){

    $url = "http://".$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'];
    
    //判断是否带参数
    if(strpos($url,"?") === false){ //不带参数

      return $this->url = $url."?";
    }else{ //带参数
    
      $url = explode("?",$url);
      //参数
      $param = $url[1];

      //判断是否有多个参数
      if(strpos($param,"&") === false){ //只有一个参数
  
        //判断参数是否为p
        if(strpos($param,"p=") === false){ //不含参数p
        
          //合并url
          $url = implode("?",$url);  

          return $this->url = $url."&";

        }else{
        
          //把参数p去掉
          $url = $url[0];

          return $this->url = $url."?";
        }
        
      }else{ //多个参数
      
        $param = explode("&",$param);

        //遍历参数数组
        foreach($param as $k=>$v){

          if(strpos($v,"p=") === false){
            
            continue;
          }else{
      
            //当含有参数p时，把它从数组中删除
            unset($param[$k]);
          }
        }

          //删除参数p之后组合数组
          $param = implode("&",$param);
          $url[1] = $param;
          $url = implode("?",$url);

          return $this->url = $url."&";
      }
    }
  }

  /************************前偏移量处理********************/
  public function preOffset($preFonts){
  

    //前偏移量的处理
    if($this->pageNow!=1 && ($this->pageNow - $this->prePage -1 pageShow .= "url."p=".($this->pageNow-1)."\">".($preFonts == ""?$this->preFonts:$preFonts)."";

      
      //页码
      for($i=1;$ipageNow-1;$i++){    

        //ajax方式不显示
        if($this->page_act != 1){

          $this->pageShow .= "url."p=".$i."\">".$i."";  
        }
      }

    }else if($this->pageNow - $this->prePage -1 > 1){ //pageNow至少大于2时才会出现"1..."
      
      //样式1.加上'首页'
      if($this->pageStyle == 2 || $this->page_act == 1){
        
        //首页
        $this->pageShow .= "url."p=1\">".$this->firstFonts."";

        //style2.前n页
        if($this->page_n == 1 && $this->page_act != 1){
        
          if($this->pageNow>$this->pn){
          
            $this->pageShow .= "url."p=".($this->pageNow-$this->pn)."\">".$this->pn_fonts."";
          }
        }
      }
      
      
      //上一页
      $this->pageShow .= "url."p=".($this->pageNow-1)."\">".($preFonts == ""?$this->preFonts:$preFonts)."";
      
      //样式1.加上第一页'1'、'...'
      if($this->pageStyle == 1){
        $this->pageShow .= "url."\">1url."p=".($this->pageNow-$this->prePage-1)." \" title=\"第".($this->pageNow-$this->prePage-1)."页\">…";
      }

      for($i=$this->prePage;$i>=1;$i--){    

        //当前页和'...'之间的页码，ajax方式不显示
        if($this->page_act != 1){

          $this->pageShow .= "url."p=".($this->pageNow-$i)."\">".($this->pageNow-$i)."";  
        }
      }
    }
  }

  /**********************页码和后偏移量处理***************************/
  public function floOffset($nextFonts){
  
    if($this->totalPage > $this->floPage){ //总页数大于后偏移量时
    
      for($i=0;$ifloPage;$i++){
      
        $page = $this->pageNow+$i;
        
        if($pagetotalPage){

          //页码,ajax方式不显示
          if($this->page_act != 1){

            $this->pageShow .= "url."p=".$page."\">".$page."";
          }
        }
      }

      if($this->pageNow totalPage){

        
        //当前页+后偏移量+1小于总页数时出现"..."
        if(($this->pageNow+$this->floPage+1)totalPage){
      
          //样式1.显示'...'
          if($this->pageStyle == 1){
            $this->pageShow .= "url."p=".($page+1)."\" title=\"第".($page+1)."页\">…";
          }
        }
        
        
        //当前页+后偏移量+1小于等于总页数时出现最后一页的快捷标签
        if(($this->pageNow+$this->floPage+1)totalPage){
        
          //最后一页
          //样式1.始终出现'最后一页页码'
          if($this->pageStyle == 1){
            $this->pageShow .= "url."p=".$this->totalPage."\" title=\"总共".$this->totalPage."页\">".$this->totalPage."";
          }
        }            

        $this->pageShow .= "url."p=".($this->pageNow+1)."\">".($nextFonts == ""?$this->nextFonts:$nextFonts).""; //当实例化对象时用户传递的文字为空时则调用类预设的"下一页",否则输出用户传递的值

        //style2.加上后n页
        if($this->pageStyle == 2 && $this->page_n == 1 && $this->page_act != 1){
        
          if(($this->pageNow+10)totalPage){
          
            $this->pageShow .= "url."p=".($this->pageNow+$this->fn)."\">".$this->fn_fonts."";
          }
        }

        //显示'末页'
        if($this->pageStyle == 2){
        
          if(($this->pageNow+$this->floPage+1)totalPage){

            $this->pageShow .= "url."p=".$this->totalPage."\">末页";
          }
        }

      }else if($this->pageNow > $this->totalPage){
      
        die("超出页码范围");
      }

    }else{ //总页数小于后偏移量时
      
      for($i=0;$itotalPage;$i++){
      
        $page = $this->pageNow+$i;
        //页码后边界
        $this->pageShow .= "url."p=".$page."\">".$page."";
      }
    }
  }

  /********************其它页面信息***********************/
  public function getOtherInfo(){
  
    //ajax方式不显示手动跳转信息
    if($this->page_act != 1){

      $this->pageShow .= " 跳转至 ";

      //跳转类型
      if($this->skipStyle =="" ){ //不加跳转
    
        $this->pageShow .= "";
      }else if($this->skipStyle == 1){ //输入框
    
        $this->pageShow .= "pageNow."\">";
    
        $this->pageShow .= "GO";
      }else if($this->skipStyle == 2){ //下拉菜单
    
        //选择下拉菜单自动跳转
        $this->pageShow .= "";
      
        for($i=1;$itotalPage;$i++){
      
          $this->pageShow .= "url."p=".$i."\""; 
        
          //下拉菜单默认显示当前页
          if($i == $this->pageNow){
        
            $this->pageShow .= " selected";
          }
        
          $this->pageShow .= ">".$i."";
        }
      
        $this->pageShow .= "";
      }
    }

    $this->pageShow .= "  当前第".$this->pageNow."页";
    $this->pageShow .= "/共".$this->totalPage."页";
    $this->pageShow .= " 共".$this->totalNum."条";
  }

  
  /*****************获取每页第一条信息*****************/
  public function getFirstRow(){
  
    $firstRow = $this->perpageNum * ($this->pageNow-1) + 1;//当前页第一条是总条数中第几条

    return $firstRow;
  }
  
  /********************获得总页数***********************/
  public function getTotalPage(){
  
    $totalPage = ceil($this->totalNum / $this->perpageNum);
    return $totalPage;
  }

  /* ****************获取上一页、下一页文字*************** */

  public function getPreFonts($preFonts){
  
      return ($preFonts=="")?$this->preFonts:$preFonts;
  }
  
  public function getNextFonts($nextFonts){
  
      return ($nextFonts=="")?$this->nextFonts:$nextFonts;
  } 

}

demo.php:

getRowsNum($sql_all);

//实例化
$mypageurl = new MyPageUrl($totalNum,$perpageNum,$perPage,$preFonts,$floPage,$nextFonts,$p,$skipStyle,$pageStyle,$page_n,$page_act);


//每页第一条
$firstRow = $mypageurl->getFirstRow();

//总条数
$totalPage = $mypageurl->getTotalPage();

//输出列表
$sql = "select title from ips_archives order by pubdate desc limit ".$firstRow.",".$perpageNum;

//取出数据(二维数组)
$rowsArray = $conne->getRowsArray($sql);

//显示页码
$pageShow = $mypageurl->preOffset($preFonts).$mypageurl->floOffset($nextFonts).$mypageurl->getOtherInfo();

$smarty->assign("Template_Dir",Template_Dir);
$smarty->assign("page_act",$page_act); //传递分页方式
$smarty->assign("pageNow",$p); //传递当前页
$smarty->assign("perpageNum",$perpageNum); //传递每页几条数据
$smarty->assign("totalPage",$totalPage); //传递总页数
$smarty->assign("preFonts",$mypageurl->getPreFonts($preFonts)); //传递上一页文字信息
$smarty->assign("rowsArray",$rowsArray);
$smarty->assign("mypage",$mypageurl);
$smarty->display("demo.html");

使用方法在demo.php的注释里

demo.html：

ajaxpage.php:

getRowsArray($sql);

//把二维数组转换成json格式
echo json_encode($rowsArray);

ajax.js:

//删除原先的li,插入gif
function ajaxpre(){

  //删除原先的title
  $("#newsul li").remove();

  //插入gif图
  $loading = $("");

  $loading.appendTo($("#newsul"));
}

//隐藏翻页信息
function infoAct(){

  //当前页到达尾页时，"下一页"和"末页"
  if(parseInt($("#pageNow").val()) == parseInt($("#totalPage").val())){
    
    $("#flo_page").hide();
    $("#last_page").hide();
    
    $("#pre_page").show();
    $("#first_page").show();
    
  }else if(parseInt($("#pageNow").val()) == 1){ //当前页到达时隐藏"首页"和"上一页"
  
    $("#pre_page").hide();
    $("#first_page").hide();
    
    $("#flo_page").show();
    $("#last_page").show();
  }else{
  
    if($("#pre_page").is(":hidden") || $("#pre_page").length == 0){
      $("#pre_page").show();
    }
    if($("#first_page").is(":hidden") || $("#first_page").length == 0){
      $("#first_page").show();
    }
    if($("#flo_page").is(":hidden") || $("#flo_page") == 0){
      $("#flo_page").show();
    }
    if($("#last_page").is(":hidden") || $("#last_page").length == 0){
      $("#last_page").show();
    }
  }
}

//点击"下一页"、"末页"时出现"首页"和"上一页"
function showPage(){

  //首页
  $firstPage = $("首页");
  
  if($("#first_page").length == 0){
    $firstPage.insertBefore($("#flo_page"));
  }

  //上一页
  $pre_page = $(""+$preFonts+"");
  
  if($("#pre_page").length == 0){
    $pre_page.insertBefore($("#flo_page"));
  }
}

//ajax请求数据
function ajaxpost(){

  $.post("ajaxpage.php",{
    
    pageNow : parseInt($("#pageNow").val()),
    perpageNum : parseInt($("#perpageNum").val())
  },function(data,textStatus){

    //接收json数据
    var dataObj=eval("("+data+")"); //转换为json对象 
    
    //删除gif
    $(".loading").remove();

    $.each(dataObj,function(idx,item){ 
                    
      $li_new = $("

"+item.title+"

"); $li_new.appendTo($("#newsul")); }) $("#list ul").children("li:last").css("border-bottom",0); }); } //初始值=1 apagenow = parseInt($("#pageNow").val()); //ajax "首页" 因为"首页"和"上一页"一开始是不出现的，所以只有在"下一页"和"末页"的的点击函数中调用"首页"和"上一页"函数 function firstPageAct(){ if($("#first_page").is(":visible")){ $("#first_page").click(function(){ //删除更新前的 ajaxpre(); //pageNow设为1 $("#pageNow").val(1); apagenow = parseInt($("#pageNow").val()); //修改页码信息 $("#pagenow_info").html(" 当前第1页"); //ajax请求数据 ajaxpost(); //到达"首页"之后隐藏"首页"和"上一页" infoAct(); }); } } //ajax "上一页" function prePageAct(){ if($("#pre_page").is(":visible")){ $("#pre_page").click(function(){ //删除更新前的 ajaxpre(); //每点击"下一次",隐藏域值-1 if(parseInt(apagenow) != 1){ apagenow = parseInt(apagenow) - parseInt(1); } $("#pageNow").val(apagenow); //隐藏域的页码值大于1时 if(parseInt($("#pageNow").val()) > parseInt(1)){ //修改页码信息 $("#pagenow_info").html(" 当前第"+$("#pageNow").val()+"页"); } //ajax请求数据 ajaxpost(); //第一页时隐藏"首页"和"下一页" infoAct(); }); } } //ajax "下一页" if($("#flo_page").length>0){ //去掉a的href属性 $("#flo_page").removeAttr("href"); $("#flo_page").click(function(){ ajaxpre(); //每点击"下一次",隐藏域值+1 apagenow = parseInt(apagenow) + parseInt(1); $("#pageNow").val(apagenow); //隐藏域的页码值小于总页码时 if(parseInt($("#pageNow").val()) 0){ //去掉a的href属性 $("#last_page").removeAttr("href"); $("#last_page").click(function(){ ajaxpre(); //修改隐藏域当前页信息 apagenow = parseInt($("#totalPage").val()); $("#pageNow").val(apagenow); //修改页码信息 $("#pagenow_info").html(" 当前第"+$("#totalPage").val()+"页"); //ajax请求数据 ajaxpost(); //点击"末页"之后出现"首页" if($("#first_page").length == 0){ showPage(); firstPageAct(); prePageAct(); } infoAct(); return false; }); } //取消a标签跳转 $("#first_page").click(function(){ return false; }); $("#pre_page").click(function(){ return false; });

common.css:

a{ font-size:14px; font-family:Tahoma; color:#444; text-decoration:none; cursor:pointer;}
ul{ list-style-type:none;}

/* ***************************列表样式******************** */
#list{

  width:1000px;
  margin-bottom:20px;
  border:1px solid #95071b;
}

#list ul{

  margin:5px 20px;
  padding:0px;
}

#list li{

  line-height:24px;
  border-bottom:1px solid #95071b;
}

/* ****************************跳转样式******************** */
#skip{

  width:36px;
  text-align:center;
}

/* ****************************ajax************************* */
.loading{

  position:absolute;
  top:20%;
  left:35%;
}

style1.css:

#page a.pagenum{

  margin-left:3px;
  margin-right:3px;
  padding:1px 7px;
  border:1px solid #ccc;
}

#page a.pagenum:hover{

  background-color:#95071b;
  color:#fff;
}

.selected{

  background-color:#95071b;
  color:#fff;
}

init.inc.php:

setTemplateDir(ROOT.'templates/')
    ->setCompileDir(ROOT.'templates_c/')
    ->setPluginsDir(ROOT.'plugins/')
    ->setCacheDir(ROOT.'cache/')
    ->setConfigDir(ROOT.'configs');

$smarty->caching = false;
$smarty->cache_lifetime = 60*60*24; //模版缓存有效时间为1天
$smarty->left_delimiter = 'right_delimiter = '}>';

/***********************************************************/

//根目录url方式
$PHP_SELF=$_SERVER['PHP_SELF'];
$ROOT_URL='http://'.$_SERVER['HTTP_HOST'].substr($PHP_SELF,0,strrpos($PHP_SELF,'/')+1);
define(ROOT_URL,$ROOT_URL);

//模版目录url方式
define("Template_Dir",$ROOT_URL.'templates');

代码下载地址：https://github.com/dee0912/PageClass