首页 诗词 字典 板报 句子 名言 友答 励志 学校 网站地图
当前位置: 首页 > 教程频道 > 网站开发 > Web前端 >

Bootstrap分页插件-Bootstrap Paginator

2013-11-16 
Bootstrap分页插件--Bootstrap PaginatorBootstrap分页插件--Bootstrap Paginator发表于 2013-05-26 17:05

Bootstrap分页插件--Bootstrap Paginator

Bootstrap分页插件--Bootstrap Paginator发表于 2013-05-26 17:05 ,已有3391次阅读 ,共0个评论

Bootstrap Paginator是一款基于Bootstrap的js分页插件,功能很丰富,个人觉得这款插件已经无可挑剔了。它提供了一系列的参数用来支持用户的定制,提供了公共的方法可随时获得插件状态的改变,以及事件来监听用户的动作。目前经过测试的浏览器包括:?Firefox 5+, Chrome 14+, Safari 5+, Opera 11.6+ and IE 7+。

官网地址:http://bootstrappaginator.org/

?

?

DownloadVisit Project in GitHub?

?

?

它的使用和其他Bootstrap内置的插件一样,需要引入如下文件:

view sourceprint?1.<link?href="css/bootstrap.css"?rel="stylesheet">2.<script?type="text/javascript"?src="js/jquery-1.8.1.js"></script>3.<script?type="text/javascript"?src="js/bootstrap-paginator.js"></script>注意:jquery要使用1.8版本以上的。

入门实例

效果:

  • <<
  • <
  • 1
  • 2
  • 3
  • 4
  • 5
  • >
  • >>?

    代码

    view sourceprint?01.<div id="example"></div>02.<script type='text/javascript'>03.var?options = {04.currentPage: 4,05.totalPages: 10,06.numberOfPages:507.}08.09.$('#example').bootstrapPaginator(options);10.</script><span style="font-family:'sans serif, tahoma, verdana, helvetica';"><span style="white-space:normal;"> </span></span>

    只需要简单的一句即可:$('#example').bootstrapPaginator(options)将id为'example'的dom元素设置为分页组件,同时传入一些定制参数。currentPage设置当前页码,totalPages设置共多少页,numberOfPages设置显示的页码数。

    组件结构

    ?

    ?

    Bootstrap分页插件-Bootstrap Paginator?

    ?

    组件结构如上图包括5中类型的操作按钮,如:首页(first)、尾页(last)、上一页(prev)、下一页(next) 、以及页(page)。当然这是默然的结构,我们可通过参数对结构及样式进行定制。

    参数

    ?

    参数名数据类型默认值描述sizestring"normal"设置控件的显示大小,是个字符串. 允许的值:?mini,?small,?normal,large。值:mini版的、小号的、正常的、大号的。alignmentstring"left"设置控件的对齐方式,是个字符串,?允许的值用:?left,?center?andright. 即:左对齐、居中对齐、右对齐。itemContainerClassfunction?该参数接收一个函数,返回一个字符串,该字符串是一个我们自定义的class类样式。当控件内的每个操纵按钮被渲染(render)时,都会调用该函数,同时把有关该按钮的信息作为参数传入。参数:type,page,?current?。type为该控件的操作按钮的类型,如上图所示的五种类型:first、prev、page、next、last。page为该按钮所属第几页。current?指示整个控件的当前页是第几页。currentPagenumber1设置当前页.numberOfPagesnumber5设置控件显示的页码数.即:类型为"page"的操作按钮的数量。totalPagesnumber1设置总页数.pageUrlfunction?实际上,控件内的每个操作按钮最终会被渲染成超链接,该参数的作用就是设置超链接的链接地址。该参数是个函数,参数为:type,page,?current。这样我们就可以通过这个函数为每个操作按钮动态设置链接地址。如:"http://example.com/list/page/"+pageshouldShowPageboolean/functiontrue该参数用于设置某个操作按钮是否显示,可是个布尔值也可是个函数。当为true时,显示。当为false时,不显示。如果该参数是个函数,需要返回个布尔值,通过这个返回值判断是否显示。函数有3个参数:?type,?page,?current。使用函数的好处是,可以对每个操作按钮进行显示控制。itemTextsfunction?控制每个操作按钮的显示文字。是个函数,有3个参数:?type,?page,?current。通过这个参数我们就可以将操作按钮上的英文改为中文,如first-->首页,last-->尾页。tooltipTitlesfunction?设置操作按钮的title属性。是个函数,有3个参数:?type,?page,?current。useBootstrapTooltipbooleanfalse设置是否使用Bootstrap内置的tooltip。 true是使用,false是不使用,默认是不使用。注意:如果使用,则需要引入bootstrap-tooltip.js插件。bootstrapTooltipOptionsobject?
    true,        html: true,        placement: 'top',        selector: false,        title: "",        container: false }                    

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

    onPageClickedfunction?为操作按钮绑定click事件。回调函数的参数:event,?originalEvent,?type,page。onPageChangedfunction?为操作按钮绑定页码改变事件,回调函数的参数:event,?oldPage,?newPage。

    公共命令

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

    命令名参数返回值描述showpage?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?objectgetPages命令用于返回当前控件中显示的页码,以数组形式返回。使用方法:var arra =?$('#example').bootstrapPaginator("getPages")?setOptionsobject?setOptions?命令用于重新设置参数,使用方法:$('#example').bootstrapPaginator("setOptions",newoptions)

    ?

    ?

    事件Events

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

    事件名回调函数描述page-clickedfunction(event,?originalEvent,?type,?page)同上文。另外,参数event,?originalEvent是俩个jquery事件对象,可参考jquery相关文档page-changedfunction(event,?oldPage,?newPage)同上文

    ??

    ?

    另外,demo就不写了,建议大家上官网,官网对于每个参数、命令、事件 都提供了实例,在通过参考上面的文档就比较好理解了。

  • 热点排行