Django 中已经写好了分页实现的逻辑,我们在做分页的时候,仅需要通过俩个对象Paginator
和 Page
即可完成分页的功能。
那么下边我们看下Paginator和Page的用法
Paginator
class Paginator(object_list, per_page, orphans=0, allow_empty_first_page=True)
在使用这个对象的时候至少要传入2个参数
- object_list
object_list传入的可以是object_list,也可以是一个QuerySet - per_page
per_page传入的是每页显示多少条记录
通过以上的方式实例化Paginator对象后,我们看看Paginator有哪些属性
- Paginator.count 所有页面的objects总数,就是一共有多少条记录
In [15]: paginator.count
Out[15]: 1002
- Paginator.num_pages 页面总数,等于传入数据的总数/定义的每页显示数
In [14]: paginator.num_pages
Out[14]: 101
- Paginator.page_range 页码的范围,从1开始,例如[1,2,3,4]
In [16]: paginator.page_range
Out[16]: range(1, 102)
这是几个Paginator的属性
下面我们看看Paginator的方法
- Paginator.page(number) 返回一个page对象
调用这个方法需要传入一个number,指要传入页码,即你要看第几页的数据。
Paginator.page翻一下代码,会发现page又调用了一个叫做Page的类,即Paginator.page也是一个对象。
Paginator.page一般的使用方式如下,具体的参数往下看
In [1]: from django.core.paginator import Paginator
In [2]: from django.contrib.auth.models import User
In [3]: queryset = User.objects.all()
In [4]: paginator = Paginator(queryset,10) #传入queryset和每页显示多少条记录实例化Paginator
In [5]: page_obj = paginator.page(2) #传入显示第几页的数据实例化Page
In [6]: print(page_obj.object_list) # 查看当前页的所有数据
<QuerySet [<User: roke_8>, <User: roke_9>, <User: roke_10>, <User: roke_11>, <User: roke_12>, <User: roke_13>, <User: roke_14>, <User: roke_15>, <User: roke_16>, <User: roke_17>]>
那个这个类有哪些属性呢?
- Page.object_list 当前页面的对象列表
In [6]: print(page_obj.object_list) # 查看当前页的所有数据
<QuerySet [<User: roke_8>, <User: roke_9>, <User: roke_10>, <User: roke_11>, <User: roke_12>, <User: roke_13>, <User: roke_14>, <User: roke_15>, <User: roke_16>, <User: roke_17>]>
- Page.number 当前页面的序号,从1开始
In [7]: page_obj.number
Out[7]: 2
- Page.paginator Paginator对象
还有一些方法(简单的演示几个)
- Page.has_next() 如果有下一页,返回True
- Page.has_previous() 如果有上一页,返回True
- Page.has_pther_pages() 如果有上一也或下一页,返回True
- Page.next_page_number() 返回下一页的页码,如果不存在,抛出InvalidPage异常
In [8]: page_obj.next_page_number()
Out[8]: 3
- Page.start_index() 返回当前页上的第一个对象,相对于分页列表的所有对象的序号
In [11]: page_obj.start_index()
Out[11]: 11
- Page.end_index() 返回当前页上的最后一个对象,相对于分页列表的所有对象的序号
In [12]: page_obj.end_index()
Out[12]: 20