django分页（Paginator）

  有的时候我们会在页面中展示大量数据，全部都放在一页可能会降低用户体验，Django提供了一个Paginator类来帮助我们管理分页数据。

起步

介绍分页器对象的一些属性和方法

1. 引入该类及相关异常模块：

from django.core.paginator import Paginator, PageNotAnInteger, EmptyPage

• Paginator：分页器对象
• PageNotAnInteger：页码不是一个整数时引发该异常
• EmptyPage：页码不在有效范围时（即数据为空）引发该异常

2. 分页器对象

分页器对象的属性：

1. object_list， 对象列表即查询到的数据
2. per_page， 每一页展示的内容
3. orphans=0， 这是一个缺省参数，如果最后一页的数据小于这个值，会合并到上一页
4. allow_empty_first_page=True， 允许首页为空 ，默认为True

分页器对象的方法：

方法	描述
page	返回一个Page对象
count	返回对象列表（数据）的长度
num_pages	返回总页数
page_range	返回页码列表

3. Page对象

Page对象是一般用来指定当前页
Page对象的属性，

• object_list：同样是指对象列表，不过只包含当前页的对象
• number：当前页面的页码
• paginator ：指对应的分页器对象（Paginator ）

注意，Paginator对象是由我们进行实例化的，而Page对象在Paginator对象使用page方法时实现

Page对象的方法：

方法	描述
has_next	是否有下一页
has_previous	是否有上一页
has_other_pages	是否有上一页或下一页
next_page_number	返回下一页的页码
previous_page_number	返回上一页的页码
start_index	返回当前页起始的对象序号
end_index	返回当前页结束的对象序号

应用

  介绍完Paginator对象，已经基本可以亲自动手实现一个分页器对象了，但暂时我们不需要那样做。接下来，来应用该分页器对象，我已经封装好了一个函数来使用它。

def split_page(object_list, request, per_page=8):
    paginator = Paginator(object_list, per_page)
    # 取出当前需要展示的页码, 默认为1
    page_num = request.GET.get('page', default='1')
    # 根据页码从分页器中取出对应页的数据
    try:
        page = paginator.page(page_num)
    except PageNotAnInteger as e:
        # 不是整数返回第一页数据
        page = paginator.page('1')
        page_num = 1
    except EmptyPage as e:
        # 当参数页码大于或小于页码范围时,会触发该异常
        print('EmptyPage:{}'.format(e))
        if int(page_num) > paginator.num_pages:
            # 大于 获取最后一页数据返回
            page = paginator.page(paginator.num_pages)
        else:
            # 小于 获取第一页
            page = paginator.page(1)

    # 这部分是为了再有大量数据时，仍然保证所显示的页码数量不超过10，
    page_num = int(page_num)
    if page_num < 6:
        if paginator.num_pages <= 10:
            dis_range = range(1, paginator.num_pages + 1)
        else:
            dis_range = range(1, 11)
    elif (page_num >= 6) and (page_num <= paginator.num_pages - 5):
        dis_range = range(page_num - 5, page_num + 5)
    else:
        dis_range = range(paginator.num_pages - 9, paginator.num_pages + 1)

    data = {'page': page, 'paginator': paginator, 'dis_range ': dis_range }
    return data

使用了bootstrap中的基本分页，展示效果如下图所示：

对应模板代码：

<div class="container">
    <nav aria-label="Page navigation">
      <ul class="pagination">

        <!--上一页-->
        <li class="{% if not page.has_previous %}disabled{% endif %}">
          {% if page.has_previous %}
            <a href="{% url 'index' %}?page={{ page.previous_page_number }}" aria-label="Previous">
          {% endif %}
            <span aria-hidden="true">&laquo;</span>
          </a>
        </li>

        <!--页码-->
        <!--这里展示页码使用传递过来的dis_range -->
        {% for num in dis_range %}
        <li class="{% if num == page.number %}active{% else %}{% endif %}" >
          <a href="{% url 'index' %}?page={{ num }}">{{ num }}</a>
        </li>
        {% endfor %}

        <!--下一页-->  
        <li class="{% if not page.has_next %}disabled{% endif %}">
          {% if page.has_next %}
            <a href="{% url 'index' %}?page={{ page.next_page_number }}" aria-label="Next">
          {% endif %}
            <span aria-hidden="true">&raquo;</span>
          </a>
        </li>

      </ul>
    </nav>
  </div>