Django 提供了一个用于分页的Paginator 对象,下面简单介绍下Paginator 对象
Paginator 对象的导入:
from django.core.paginator import Paginator
Paginator 对象用法:
Paginator(object_list, per_page, orphans=0, allow_empty_first_page=True)
object_list:
改参数必须是列表,元祖,QuerySet 对象 或者对象有count() 或者__len__()的方法:
per_page:
每页显示的数量
Orphans:
这个参数用于当最后一页显示的数量小于或者等于 orphans 的数值时,最后一页显示的数据会被放到前一页显示.
allow_empty_first_page:
是否允许为object_list 为空
Paginator方法:
Paginator.get_page(number)
Django 2.0 以上的版本,此方法返回一个Page对象,如果number不是一个数字,返回第一页,如过number大于总页数了,返回最后一页
Paginator.page(number)
返回Page对象,如果给的numbe参数不存在,将抛出异常InvalidPage
Paginator属性:
Paginator.count
数据object_list总条数,
计算时首先会调用传入的object_list 的count方法如果object_list 没有count() 方法 会调用len(object_list) 方法
Paginator.num_pages
返回总页数
Paginator.page_range
返回页数的range对象
Page 对象的用法
通常不需要自己创建Page 对象,通过Paginator.get_page 或者 Paginator.page()去创建
方法:
1) Page.has_next()
如果有下一页 返回True
2) Page.has_previous()
如果有上一页,返回True
3) Page.next_page_number()
返回下一页的页码。如果下一页不存在,抛出InValidPage错误
属性:
1) Page.object_list
返回此页的对象列表
2) Page.number
返回此页的页码,
3) Page.paginator
返回关联的Paginatior 对象
下面使用Paginator 对象在类视图中实现一个通用的分页方法
# Django version 2.0