jPage.js插件使用文档
这一款插件主要是为了bootstrap原生的分页功能效果不理想而诞生的一款插件。
jPage.js代码更新地址为：https://github.com/leslieSie/font-end-tools/tree/master/jquery/bootstrapCss/jPage
*. 插件支持的配置
pageNo:这个参数主要是用来指定当前的页码的，传入的类型为number
count:这个参数是标识总的数据条数，传入的类型为number
pageSize:这个参数是指定每页要渲染的数据条数，这个与count参数配合可以最终确定页数，传入类型为number
color:这个为主题颜色，目前只支持默认的浅蓝色主题，所以现在的无需传参
btnName:这个参数是用来改变确认按钮的文本的，默认的文本是“确定”
skipPart:配置是否支持分页插件的拓展部分，默认值为true
showNum:这个参数主要是用来设定默认分页插件的显示页码数的，默认值为6，传入的类型为number
*. 插件的依赖
这一款插件是依赖于bootstrap、Jquery来实现的，所以在引入插件的同时必须保证bootstrap和jquery已经引入
*. 一个简单的使用案例
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<link rel="stylesheet" href="http://cdn.static.runoob.com/libs/bootstrap/3.3.7/css/bootstrap.min.css">
</head>
<body>
<div id="test"></div>
<script type="text/javascript" src="http://cdn.bootcss.com/jquery/3.1.1/jquery.js"></script>
<script type="text/javascript" src="jPage.js"></script>
<script type="text/javascript">
$("#test").page({count:70,pageSize:3,skipPart:true});
</script>
</body>
</html>
这样就生成了一个总计24页，每页有3条数据的分页组件
*. 插件与ajax的交互
这款插件目前没有在内部实现ajax的交互方式，但是我们可以通过在外添加事件绑定来实现这个需求
例如：要为确定按钮添加一个ajax事件我们可以这样做
$(document).on('click','#test .pagination_search',function(){
if($(document).find("#test .pagination_change_page").val()==""){
alert("跳转页码不能为空");
}else{
var num=parseInt($(document).find("#test .pagination_change_page").val());
$("#test").page({count:12,pageNo:num,pageSize:3,skipPart:true});
}
});
$(document).on("click","#test .pagination li",function(){
var num=$(this).attr("num");
if($(this).attr("class")=="disabled"){
return false;
}
if(num==0 || num==(count+1)){
}else{
$("#test").page({count:12,pageNo:num,pageSize:3,skipPart:true});
}
});
这样我们就实现了ajax交互的功能
以下为jPage-1.2.js版本的详细代码:
| (function($){ | |
| $.fn.page=function(options){ | |
| var defaultOptions={ | |
| pageNo:1, //当前页码，用于点亮对应的页码 | |
| pageSize:10, //每页渲染的最大页码数 | |
| count:0, // | |
| showNum:6, //初始化的显示页码，默认的是显示到6页 | |
| color:'orange', | |
| btnName:'确定', //按钮名称 | |
| skipPart:true, //跳转模块是否添加 | |
| fontSize:16, | |
| // statisMsgPart:false, //静态信息显示，默认为不显示 | |
| } | |
| var that=this; | |
| var settings=$.extend({},defaultOptions,options); | |
| var pageCount=0; | |
| $(this).empty(); | |
| //主函数 | |
| var main=function(){ | |
| var val=ValidatePageCount(); | |
| if(val==false){ | |
| return false; | |
| } | |
| var pageNo=parseInt(settings.pageNo); | |
| var pageSize=parseInt(settings.pageSize); | |
| var count=parseInt(settings.count); | |
| if(count%pageSize==0){ | |
| pageCount=count/pageSize; | |
| }else{ | |
| pageCount=parseInt(count/pageSize)+1; | |
| } | |
| var showNum=parseInt(settings.showNum); | |
| var pageJson=PageAlgorithm(pageNo,pageSize,pageCount,showNum); | |
| PageDraw(pageJson); | |
| $(that).off(); | |
| }; | |
| main(); | |
| //按键触发 | |
| // $(document).on('click','.pagination li',function(e){ | |
| // //alert(2); | |
| // var num=$(this).attr("num"); | |
| // console.log("NUM:"+num); | |
| // if($(this).attr("class")=="disabled"){ | |
| // return false; | |
| // } | |
| // if(num==0 || num==(settings.count+1)){ | |
| // }else{ | |
| // var json=PageAlgorithm(parseInt(num),settings.pageSize,pageCount,settings.showNum); | |
| // //console.log(json); | |
| // PageDraw(json); | |
| // $(".pagination li").off("click"); | |
| // } | |
| // }); | |
| // $(document).on('click','.pagination_search',function(){ | |
| // //alert(3); | |
| // //输入为空不做处理 | |
| // if($(that).find(".pagination_change_page").val()==""){ | |
| // alert("跳转页码不能为空"); | |
| // }else{ | |
| // var num=parseInt($(that).find(".pagination_change_page").val()); | |
| // var json=PageAlgorithm(parseInt(num),settings.pageSize,pageCount,settings.showNum); | |
| // PageDraw(json); | |
| // } | |
| // }); | |
| //验证传入数据是否符合渲染规则 | |
| function ValidatePageCount(){ | |
| if(settings.pagNo<0 || settings.pageSize<0 || settings.count<0){ | |
| console.error("请检查 pagNo,pageSize,count这个三个参数是否存在非法输入"); | |
| return false; | |
| } | |
| //如果showNum为为非法数值，那么设置为默认值 | |
| if(settings.showNum<0){ | |
| setting.showNum=6; | |
| } | |
| } | |
| //分页渲染 | |
| function PageDraw(json){ | |
| if(parseInt(settings.count)>0){ | |
| var html='<ul class="pagination">'; | |
| for(var i in json.algorithm){ | |
| if(json.algorithm[i].status=="disabled"){ | |
| html+='<li class="'+json.algorithm[i].status+'" num="'+json.algorithm[i].num+'" ><a href="javascript:;">'+json.algorithm[i].text+'</a></li>'; | |
| } | |
| else if(json.algorithm[i].status=="active"){ | |
| html+='<li class="'+json.algorithm[i].status+'" num="'+json.algorithm[i].num+'" ><a href="javascript:;">'+json.algorithm[i].text+'</a></li>'; | |
| }else if(json.algorithm[i].num=="more"){ | |
| html+='<li class="disabled" num="'+json.algorithm[i].num+'" ><a href="javascript:;">'+json.algorithm[i].text+'</a></li>'; | |
| }else{ | |
| html+='<li num="'+json.algorithm[i].num+'" ><a href="javascript:;">'+json.algorithm[i].text+'</a></li>'; | |
| } | |
| } | |
| $(that).html(html); | |
| if(settings.skipPart==true){ | |
| $(that).find(".pagination").append('<span class="text-muted" style="margin:5px;margin-left:10px;display:inline-block;font-size:18px;font-size:'+settings.fontSize+'px">共有'+pageCount+'页/'+settings.count+'个</span><div style="display:inline-block" name="changePage"><span class="text-muted" style="margin:5px;margin-left:0px;display:inline-block;font-size:'+settings.fontSize+'px">,到第</span> <input type="number" min="1" max="'+pageCount+'"class="pagination_change_page" style="45px;border-color:#ddd"> <span class="text-muted" style="margin:5px;margin-left:10px;display:inline-block;font-size:font-size:'+settings.fontSize+'px">页</span> <button class="btn btn-default btn-sm pagination_search">'+settings.btnName+'</button></div>'); | |
| } | |
| }else{ | |
| } | |
| } | |
| //分页算法逻辑，主要对分页进行逻辑运算，不做渲染，返回值为JSON | |
| function PageAlgorithm(pageNo,pageSize,count,showNum){ | |
| var data=""; | |
| if(pageNo==1){ | |
| data='{"algorithm":[{"text":"上一页","num":0,"status":"disabled"}'; | |
| }else{ | |
| data='{"algorithm":[{"text":"上一页","num":"'+(pageNo-1)+'","status":"abled"}'; | |
| } | |
| //判断分页类型 | |
| if(count>showNum){ | |
| if(pageNo<=showNum+2){ | |
| //判断pageNo是否在要初始化显示的页码内 | |
| if(pageNo<=showNum){ | |
| for(var i=1;i<=showNum;i++){ | |
| if(pageNo==i){ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"active"}'; | |
| }else{ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"abled"}'; | |
| } | |
| } | |
| if(pageNo==showNum){ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"abled"}'; | |
| } | |
| }else{ | |
| for(var i=1;i<=pageNo;i++){ | |
| if(i==pageNo){ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"active"}'; | |
| }else{ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"abled"}'; | |
| } | |
| } | |
| if(pageNo!=count){ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"abled"}'; | |
| } | |
| } | |
| //选中最后一页时，将省略号隐藏 | |
| if(pageNo!=count){ | |
| if(pageNo!=(count-1)){ | |
| data+=',{"text":"…","num":"more","status":""}'; | |
| } | |
| } | |
| }else if(pageNo>count-showNum){ | |
| data+=',{"text":"1","num":"1","status":"abled"}'; | |
| data+=',{"text":"2","num":"2","status":"abled"}'; | |
| data+=',{"text":"…","num":"more","status":"disabled"}'; | |
| for(var i=count-showNum+1;i<=count;i++){ | |
| if(pageNo==i){ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"active"}'; | |
| }else{ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"abled"}'; | |
| } | |
| } | |
| } | |
| else{ | |
| data+=',{"text":"1","num":"1","status":"abled"}'; | |
| data+=',{"text":"2","num":"2","status":"abled"}'; | |
| data+=',{"text":"…","num":"more","status":"disabled"}'; | |
| for(var i=pageNo-2;i<=pageNo+2;i++){ | |
| if(i==pageNo){ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"active"}'; | |
| }else{ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"abled"}'; | |
| } | |
| } | |
| data+=',{"text":"…","num":"more","status":"disabled"}'; | |
| } | |
| }else{ | |
| for(var i=1;i<=count;i++){ | |
| if(pageNo==i){ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"active"}'; | |
| }else{ | |
| data+=',{"text":"'+i+'","num":"'+i+'","status":"abled"}'; | |
| } | |
| } | |
| } | |
| if(pageNo==count){ | |
| data+=',{"text":"下一页","num":"'+(pageNo+1)+'","status":"disabled"}]}'; | |
| }else{ | |
| data+=',{"text":"下一页","num":"'+(pageNo+1)+'","status":"abled"}]}'; | |
| } | |
| var json_return = JSON.parse(data); | |
| return json_return; | |
| } | |
| } | |
| })(jQuery); |