本文将为大家介绍一款非常赞的jQuery分页插件:jqPaginator。

jqPaginator简洁、高度自定义的jQuery分页组件,适用于多种应用场景。

简介

现在网上各种各样的分页组件很多,但是很难找到十分“称心如意”的,于是jqPaginator诞生了。

我心中理想的分页组件,要不受CSS框架限制,可以使用在各种不同风格中的网页中。以我浅显的经验来看,要达到这个目标,关键的一点就是高度自定义的Html结构。所以jqPaginator努力做到合理范围内的自定义,使其灵活的使用了各种不同的场景。

效果截图:

013027_u0hW_1456287

使用说明

例子

用法很简单,首先引入jQuery和jqPaginator,之后就可以初始化分页了

$('#id').jqPaginator({
    totalPages: 100,
    visiblePages: 10,
    currentPage: 1,

    first: '
  • First
  • ', prev: '', next: '', last: '
  • Last
  • ', page: '
  • {{page}}
  • ', onPageChange: function (num) { $('#text').html('当前第' + num + '页'); } });

    上例就是第一Demo,Bootstrap风格的分页。具体参数稍后介绍,这里要了解的是,如果使用的不是id,而是class,就会初始化该class的所有元素,实现上面“两个分页联动”的效果。

    参数

    参数 默认值 说明
    totalPages 0 设置分页的总页数
    totalCounts 0 设置分页的总条目数
    pageSize 0 设置每一页的条目数
    注意:要么设置totalPages,要么设置totalCounts + pageSize,否则报错;设置了totalCounts和pageSize后,会自动计算出totalPages。
    currentPage 1 设置当前的页码
    visiblePages 7 设置最多显示的页码数(例如有100也,当前第1页,则显示1 - 7页)
    disableClass 'disabled' 设置首页,上一页,下一页,末页的“禁用状态”样式
    activeClass 'active' 设置当前页码样式
    first (无) 设置“首页”的Html结构
    prev (无) 设置“上一页”的Html结构
    next (无) 设置“下一页”的Html结构
    last (无) 设置“末页”的Html结构
    page (无) 设置页码的Html结构,其中可以使用{{page}}代表当前页,{{totalPages}}代表总页数,{{totalCounts}}代表总条目数(例如:上面的“极简风格”的Demo,就是使用了{{占位符}},并将visiblePages设为1实现的。)
    wrapper (无) 分页结构的Html包裹,例如:<div class="your class"></div>,一般不会用到
    onPageChange (无) 回调函数,当换页时触发(包括初始化第一页的时候),会传入“目标页"的页码

    扩展方法

    jqPaginator提供了两个扩展方法,方便初始化后对组件进行操作。

    $('#id').jqPaginator('option', options)
    

    初始化后,动态修改配置

    $('#id').jqPaginator('option', {
        currentPage: 1
    });
     
    $('#id').jqPaginator('destroy')
    

    销毁jqPaginator

    $('#id').jqPaginator('destroy');
    

    相关资料