django1.8 Pagination(分页)

本文翻译自django1.8.2官方文档

Pagination

django提供了一些类来帮助你管理分页数据(意思是,数据被分成好几页,有”上一页/下一页链接”).这些类在django/core/paginator.py里.

Example

给Paginator2个参数:对象集合,每页的条目数,它提供了操作每页的条目的方法.

>>> from django.core.paginator import Paginator
>>> objects = ['john', 'paul', 'george', 'ringo']
>>> p = Paginator(objects, 2)
>>> p.count
4
>>> p.num_pages
2
>>> p.page_range
[1, 2]
>>>page1 = p.page(1)
<Page 1 of 2>
>>> page1.object_list
['john', 'paul']

>>> page2 = p.page(2)
>>> page2.object_list
['george',  'ringo']
>>> page2.has_next()
False
>>> page2.has_previous()
True
>>> page2.has_other_pages()
True
>>> page2.next_page_number()
Traceback(most recent call last):
...
EmptyPage: That page contains no results
>>> page2.privious_page_number()
1
>>> page2.start_index()  # 这页的第一条数据的索引(从1开始)
3
>>> page2.end_index()  # 这页的最后一条数据的索引(从1开始)
4

>>> p.page(0)
Traceback(most recent call last):
...
EmptyPage: That page number is less than 1
>>> p.page(3)
Traceback(most recent call last):
...
EmptyPage: That page contains no results

注意:
你可以给Paginator传list/tuplue, QuertSet,或其他有count()或len()的对象作为参数.判断参数里包含对象的参数时,Paginator会先试着调用count(),如果没有count()方法就会调用len()方法.这就允许一些对象,比如QuerySet使用更高效的count()方法.

Using Paginator in a view

这是一个稍微复杂的例子,在视图里使用Paginator来给queryset分页.使用了视图和附带的模板来演示怎么显示结果.这个例子假设你已经导入了一个Contacts模型.
视图方法如下:

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger

def listing(request):
    contact_list = Contacts.objects.all()
    paginator

Paginator objects

Required arguments

Optional arguments

Methods

Attributes

InvalidPage exceptions

Page objects

Methods

Attributes