一、分页器介绍

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