一、分页器介绍
1.1、介绍
分页,就是当我们在页面中显示一些信息列表,内容过多,一个页面显示不完,需要分成多个页面进行显示时,使用的技术就是分页技术
在django项目中,一般是使用3种分页的技术:
- 自定义分页功能,所有的分页功能都是自己实现
- django的插件 django-pagination 实现
- django自带的分页器 paginator
1.2、分页器相关对象
分页器的对象在 django/core/paginator.py
模块中,主要包括Paginator类和Page类:
1.2.1、Paginator类
-
初始化方法__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错误
-
方法
-
get_page(self, number)
- numer:指定页码数,正确值应该是大于等于1的整数
返回指定number的Page对象,同时还处理超出范围和无效页码,如果number不是数字,则返回第一页,如果number为负数或大于最大页数,则返回最后一页。
-
page(self, number)
- numer:指定页码数,正确值应该是大于等于1的整数
返回指定number的Page对象,不处理异常,如果number无效,则抛出 InvalidPage 错误
-
-
属性
- count:项目总条数,调用该属性时,优先调用object_list的count()方法,没有count()方法才尝试len(object_list)方法
- num_pages:总页码数
- page_range:从1开始的页码迭代器,代码:range(1, self.num_pages