jquery 分页(jquery-pagination.js)详解

网上许多许多关于jquery-pagination.js分页控件的使用,但是真正能说明其原理及实用的没有多少其

插件官方地址:http://plugins.jquery.com/project/pagination

http://www.cnblogs.com/skyblue/archive/2010/11/26/1888680.html博客中有几个中文修改版demo,还是相当不错,可以去哪里看一下,相信对你大有帮助

现在网络中大量资源copy,让人很头疼且不好使。

希望这篇博客对大家有帮助,如有不好的地方尽管指教。。

 

分页插件参数说明:

参数名描述参数值
maxentries 总条目数                           必选参数,整数
items_per_page 每页显示的条目数                       可选参数,默认是10
num_display_entries 连续分页主体部分显示的分页条目数                       可选参数,默认是10
current_page 当前选中的页面                      可选参数,默认是0,表示第1页
num_edge_entries 两侧显示的首尾分页的条目数                      可选参数,默认是0
link_to 分页的链接                  字符串,可选参数,默认是"#"
prev_text “前一页”分页按钮上显示的文字                 字符串参数,可选,默认是"Prev"
next_text “下一页”分页按钮上显示的文字                字符串参数,可选,默认是"Next"
ellipse_text 省略的页数用什么文字表示                   可选字符串参数,默认是"…"
prev_show_always 是否显示“前一页”分页按钮           布尔型,可选参数,默认为true,即显示“前一页”按钮
next_show_always 是否显示“下一页”分页按钮           布尔型,可选参数,默认为true,即显示“下一页”按钮
callback 回调函数              当点击链接时此函数被调用,此函数返回两个参数,新一页索引和绑定页元素容器(一个DOM元素)。如果回调函数返回false,则pagination事件停止执行
 
 
jquery-pagination.js
/**
* This jQuery plugin displays pagination links inside the selected elements.
*
* @author Gabriel Birke (birke *at* d-scribe *dot* de)
* @version 1.2
* @param {int} maxentries Number of entries to paginate
* @param {Object} opts Several options (see README for documentation)
* @return {Object} jQuery Object
*/
jQuery.fn.pagination = function (maxentries, opts) {
    opts = jQuery.extend({
        items_per_page: 10,
        num_display_entries: 10,
        current_page: 0,
        num_edge_entries: 0,
        link_to: "#",
        prev_text: "Prev",
        next_text: "Next",
        ellipse_text: "...",
        prev_show_always: true,
        next_show_always: true,
        callback: function () { return false; }
    }, opts || {});

    return this.each(function () {
        /**
        * 计算最大分页显示数目
        */
        function numPages() {
            return Math.ceil(maxentries / opts.items_per_page);
        }
        /**
        * 极端分页的起始和结束点,这取决于current_page 和 num_display_entries.
        * @返回 {数组(Array)}
        */
        function getInterval() {
            var ne_half = Math.ceil(opts.num_display_entries / 2);
            var np = numPages();
            var upper_limit = np - opts.num_display_entries;
            var start = current_page > ne_half ? Math.max(Math.min(current_page - ne_half, upper_limit), 0) : 0;
            var end = current_page > ne_half ? Math.min(current_page + ne_half, np) : Math.min(opts.num_display_entries, np);
            return [start, end];
        }

        /**
        * 分页链接事件处理函数
        * @参数 {int} page_id 为新页码
        */
        function pageSelected(page_id, evt) {
            current_page = page_id;
            drawLinks();
            var continuePropagation = opts.callback(page_id, panel);
            if (!continuePropagation) {
                if (evt.stopPropagation) {
                    evt.stopPropagation();
                }
                else {
                    evt.cancelBubble = true;
                }
            }
            return continuePropagation;
        }

        /**
        * 此函数将分页链接插入到容器元素中
        */
        function drawLinks() {
            panel.empty();
            var interval = getInterval();
            var np = numPages();
            // 这个辅助函数返回一个处理函数调用有着正确page_id的pageSelected。
            var getClickHandler = function (page_id) {
                return function (evt) { return pageSelected(page_id, evt); }
            }
            //辅助函数用来产生一个单链接(如果不是当前页则产生span标签)
            var appendItem = function (page_id, appendopts) {
                page_id = page_id < 0 ? 0 : (page_id < np ? page_id : np - 1); // 规范page id值
                appendopts = jQuery.extend({ text: page_id + 1, classes: "" }, appendopts || {});
                if (page_id == current_page) {
                    var lnk = jQuery("<span class='current'>" + (appendopts.text) + "</span>");
                } else {
                    var lnk = jQuery("<a>" + (appendopts.text) + "</a>")
                        .bind("click", getClickHandler(page_id))
                        .attr('href', opts.link_to.replace(/__id__/, page_id));
                }
                if (appendopts.classes) { lnk.addClass(appendopts.classes); }
                panel.append(lnk);
            }
            // 产生"Previous"-链接
            if (opts.prev_text && (current_page > 0 || opts.prev_show_always)) {
                appendItem(current_page - 1, { text: opts.prev_text, classes: "prev" });
            }
            // 产生起始点
            if (interval[0] > 0 && opts.num_edge_entries > 0) {
                var end = Math.min(opts.num_edge_entries, interval[0]);
                for (var i = 0; i < end; i++) {
                    appendItem(i);
                }
                if (opts.num_edge_entries < interval[0] && opts.ellipse_text) {
                    jQuery("<span>" + opts.ellipse_text + "</span>").appendTo(panel);
                }
            }
            // 产生内部的些链接
            for (var i = interval[0]; i < interval[1]; i++) {
                appendItem(i);
            }
            // 产生结束点
            if (interval[1] < np && opts.num_edge_entries > 0) {
                if (np - opts.num_edge_entries > interval[1] && opts.ellipse_text) {
                    jQuery("<span>" + opts.ellipse_text + "</span>").appendTo(panel);
                }
                var begin = Math.max(np - opts.num_edge_entries, interval[1]);
                for (var i = begin; i < np; i++) {
                    appendItem(i);
                }

            }
            // 产生 "Next"-链接
            if (opts.next_text && (current_page < np - 1 || opts.next_show_always)) {
                appendItem(current_page + 1, { text: opts.next_text, classes: "next" });
            }
        }

        //从选项中提取current_page
        var current_page = opts.current_page;
        //创建一个显示条数和每页显示条数值
        maxentries = (!maxentries || maxentries < 0) ? 1 : maxentries;
        opts.items_per_page = (!opts.items_per_page || opts.items_per_page < 0) ? 1 : opts.items_per_page;
        //存储DOM元素,以方便从所有的内部结构中获取
        var panel = jQuery(this);
        // 获得附加功能的元素
        this.selectPage = function (page_id) { pageSelected(page_id); }
        this.prevPage = function () {
            if (current_page > 0) {
                pageSelected(current_page - 1);
                return true;
            }
            else {
                return false;
            }
        }
        this.nextPage = function () {
            if (current_page < numPages() - 1) {
                pageSelected(current_page + 1);
                return true;
            }
            else {
                return false;
            }
        }
        // 所有初始化完成,绘制链接
        drawLinks();
        // 回调函数
        opts.callback(current_page, this);
    });
}

 

demo.html
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title></title>
    <style type = "text/css"> 
    td,th{border-bottom: 1px solid #333; border-right:1px solid #333; padding:5px;} 
    th{ border-top:1px solid #333;}
    .left_border{ border-left:1px solid #333;}
    #Pagination a,#Pagination span{ display:inline-table; padding:2px 5px; margin:3px 5px; background-color:#FFAC35; color:White;}
  
    </style> 
    <script src="js/jquery.js" type="text/javascript"></script>
    <script src="js/pagination.js" type="text/javascript"></script> 
    <script type = "text/javascript">
        $(function () {
            var initPagination = function () {
                var length = parseInt(prompt("请输入数据条数:","35"));
                $("#Pagination").pagination(length, {
                    num_edge_entries: 2,
                    num_display_entries: 4,
                    callback: pageselectCallback,
                    items_per_page: 5, //每页显示1项
                    link_to: "javascript:void(0);",
                    prev_text: "前一页",
                    next_text: "下一页"
                });
            } ();

            function pageselectCallback(page_index, jq) {//注意不要在意这两个变量:page_index jq 不影响
                page_index += 1;
                $("#linkTable>tbody").html("");
                var _arr = [];
                for (var j = 0; j < 5; j++) {
                    var random = Math.floor((Math.random() * 100) + 1);
                    _arr.push(random);
                }
                for (var i = 0; i < _arr.length; i++) {
                    $("#linkTable>tbody").append("<tr><td class = 'left_border'>One" + _arr[i] + "第{" + page_index + "}页</td><td>Two" + _arr[i] + "第{" + page_index + "}页</td><td>Three" + _arr[i] + "第{" + page_index + "}页</td><td>Fourth" + _arr[i] + "第{" + page_index + "}页</td><td>Five" + _arr[i] + "第{" + page_index + "}页</td><td>Six" + _arr[i] + "第{" + page_index + "}页</td></tr>");     
                } 
                return false;
            }
        }); 
    </script>
</head>
<body>
 <div>  
  <table id="linkTable">
  <thead>
  <tr><th class="left_border">one</th><th>two</th><th>three</th><th>fourth</th><th>five</th><th>six</th></tr>
  </thead>
  <tbody></tbody>
  <tfoot></tfoot>
  </table> 
  </div> 
  <div id="Pagination"></div>  
</body>
</html>

 在这里为大家推荐一个不错的table:http://cssglobe.com/lab/tablecloth/

posted @ 2013-02-01 16:41  wfpanskxin  阅读(486)  评论(0)    收藏  举报