bootstrap-paginator插件的使用

时间:2020-03-16
本文章向大家介绍bootstrap-paginator插件的使用,主要包括bootstrap-paginator插件的使用使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

先看效果展示:

1、下载相应jquery、bootstrap已经bootstrap-pagination插件

  <script src="js/basic/jquery-3.4.1.js"></script>
  <script src="js/basic/bootstrap.min.js"></script>
  <script src="js/basic/bootstrap-paginator.js"></script>

2、在html中引入组件

<!-- pagination section -->
<div class="pagination_main" id="paginationMain">
    <nav class="text-right"> <!--text-right 右对齐,bootstrap中样式-->
        <ul id="pagination" class="pagination"></ul>
  </nav>
</div>

3、js中定义属性

<script>
    //分页功能
      var setPaginator = function (totalPages,curPage) {
          $('#pagination').bootstrapPaginator({
              bootstrapMajorVersion: 3, //对应bootstrap版本
              alignment: 'center',
              size: 'small', //分页大小
              currentPage: curPage, //当前页
              numberOfPages: 5, //显示的页数
              totalPages: totalPages, // 总页数
              itemTexts: function (type, page, current) {
                   switch (type) {
                       case "first":
                           return "首页";
                       case "prev":
                           return "上一页";
                       case "next":
                           return "下一页";
                       case "last":
                           return "末页";
                       case "page":
                           return page;
                   }

               },
               /**
                * 分页点击事件
                * @param event [jquery对象]
                * @param originalEvent [dom原生对象]
                * @param type [按钮类型]
                * @param page [点击按钮对应的页码]
                */
               onPageClicked: function (event, originalEvent, type, page) {
                   curPage = page;//根据点击页数渲染页面
                   getListInfo(curPage);//重新渲染数据
              }
          })
      };
  </script>
<script>
        var pageSize = 10; // 页条数
        var curPage = 1; // 页码
        // 渲染分页插件
      setPaginator(totalPages,curPage)
  </script>            

4、相关参数介绍

gitHub 官网地址:https://github.com/lyonlai/bootstrap-paginator

参数介绍:

参数名数据类型默认值描述
bootstrapMajorVersion number 2 搭配使用的Bootstrap版本,2.X 的 分页必须使用div元素,3.X分页的必须使用ul元素。请注意与所使用的bootstrap版本对应上。
size string   "normal"    设置控件的显示大小,是个字符串. 允许的值: minismallnormal,large。值:mini版的、小号的、正常的、大号的。
alignment string  "left" 设置控件的对齐方式,是个字符串, 允许的值用: leftcenter andright. 即:左对齐、居中对齐、右对齐。
itemContainerClass function  

该参数接收一个函数,返回一个字符串,该字符串是一个我们自定义的class类样式。当控件内的每个操纵按钮被渲染(render)时,都会调用该函数,

同时把有关该按钮的信息作为参数传入。参数:type,pagecurrent 。type为该控件的操作按钮的类型,如上图所示的五种类型:first、prev、page、next、last。

page为该按钮所属第几页。current 指示整个控件的当前页是第几页。

currentPage number 1 设置当前页.
numberOfPages number 5 设置控件显示的页码数.即:类型为"page"的操作按钮的数量。
totalPages number 1 设置总页数.
pageUrl function  

实际上,控件内的每个操作按钮最终会被渲染成超链接,该参数的作用就是设置超链接的链接地址。该参数是个函数,参数为:type,pagecurrent。

这样我们就可以通过这个函数为每个操作按钮动态设置链接地址。如:"http://example.com/list/page/"+page

shouldShowPage boolean/function true

该参数用于设置某个操作按钮是否显示,可是个布尔值也可是个函数。当为true时,显示。当为false时,不显示。如果该参数是个函数,需要返回个布尔值,

通过这个返回值判断是否显示。函数有3个参数: typepagecurrent。使用函数的好处是,可以对每个操作按钮进行显示控制。

itemTexts function  

控制每个操作按钮的显示文字。是个函数,有3个参数: typepagecurrent。通过这个参数我们就可以将操作按钮上的英文改为中文,

如first-->首页,last-->尾页。

tooltipTitles function   设置操作按钮的title属性。是个函数,有3个参数: typepagecurrent。
useBootstrapTooltip boolean false

设置是否使用Bootstrap内置的tooltip。 true是使用,false是不使用,默认是不使用。

注意:如果使用,则需要引入bootstrap-tooltip.js插件。

bootstrapTooltipOptions object  
    Default:
    {
        animation: true,
        html: true,
        placement: 'top',
        selector: false,
        title: "",
        container: false }

该参数是个js对象。当参数useBootstrapTooltip为true时,会将该对象传给Bootstrap的bootstrap-tooltip.js插件。

onPageClicked function   为操作按钮绑定click事件。回调函数的参数:eventoriginalEventtype,page。
onPageChanged function   为操作按钮绑定页码改变事件,回调函数的参数:eventoldPagenewPage。

 公共命令:

  另外该插件还提供了几个公共的命令,可以通过如下方法调用,如:$('#example').bootstrapPaginator("show",3) 调用show命令、$('#example').bootstrapPaginator("getPages") 调用getPages命令。

命令名参数返回值描述
show   page    

show命令用于直接跳转到特定的page,与直接点击操作按钮的效果是一样的。使用方法,

如:$('#example').bootstrapPaginator("show",3) 直接跳转到第3页,

$('#example').bootstrapPaginator("show",100)直接跳转到100页。 

showFirst     showFirst 命令用于直接跳转到首页,与点击first按钮相同。使用方法:$('#example').bootstrapPaginator("showFirst") 
showPrevious     showPrevious 命令用于直接跳转到上一页。使用方法:$('#example').bootstrapPaginator("showPrevious") 
showNext     showNext命令用于直接跳转到下一页。
showLast     showLast 命令用于直接跳转到上一页。
getPages      object   getPages命令用于返回当前控件中显示的页码,以数组形式返回。使用方法:var arra = $('#example').bootstrapPaginator("getPages") 
setOptions object   setOptions 命令用于重新设置参数,使用方法:$('#example').bootstrapPaginator("setOptions",newoptions)

事件Events:

   Bootstrap Paginator 提供了俩个事件:page-clickedpage-changed。这俩个事件作为参数使用,分别对应onPageClickedonPageChanged

事件名回调函数描述
page-clicked function(eventoriginalEventtypepage) 同上文。另外,参数eventoriginalEvent是俩个jquery事件对象,可参考jquery相关文档
page-changed function(eventoldPagenewPage) 同上文

原文地址:https://www.cnblogs.com/liangpi/p/12503395.html