一、分页器介绍

1.1、介绍

分页，就是当我们在页面中显示一些信息列表，内容过多，一个页面显示不完，需要分成多个页面进行显示时，使用的技术就是分页技术

在django项目中，一般是使用3种分页的技术：

  1. 自定义分页功能，所有的分页功能都是自己实现
  2. django的插件 django-pagination 实现
  3. django自带的分页器 paginator

1.2、分页器相关对象

分页器的对象在django/core/paginator.py模块中，主要包括Paginator类和Page类：

1.2.1、Paginator类

  1. 初始化方法__init__(self, object_list, per_page, orphans=0,allow_empty_first_page=True)：

    • object_list：可以是QuerySet、带有count()或__len__()方法的列表、元组或其它可切片的对象，如果是QuerySet，应该进行排序，使用order_by()子句或者有默认的ordering
    • per_page：每个页面上显示的项目数目，不包括orphans部分
    • orphans：默认为0，如果最后一页显示的数目小于等于该数值，那么则将最后一页的内容(假设数为N)添加到倒数第二页中去，这样的话倒数第二页就成了最后一页，显示的数目为：per_page+N
    • allow_empty_first_page：默认为True，允许第一页显示空白内容，如果设置为False，那么当object_list为空时，抛出EmptyPage错误

  2. 方法

    1. get_page(self, number)

      • numer：指定页码数，正确值应该是大于等于1的整数

      返回指定number的Page对象，同时还处理超出范围和无效页码，如果number不是数字，则返回第一页，如果number为负数或大于最大页数，则返回最后一页。

    2. page(self, number)

      • numer：指定页码数，正确值应该是大于等于1的整数

      返回指定number的Page对象，不处理异常，如果number无效，则抛出 InvalidPage 错误

  3. 属性

    1. count：项目总条数，调用该属性时，优先调用object_list的count()方法，没有count()方法才尝试len(object_list)方法
    2. num_pages：总页码数
    3. page_range：从1开始的页码迭代器，代码：range(1, self.num_pages