示范

给 Paginator 传入一个对象列表, 以及每页需要显示的数量, 然后对象就可以告诉你分页后的数据:

>>> 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)
>>> page1

>>> 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()
3
>>> page2.previous_page_number()
1
>>> page2.start_index() # The 1-based index of the first item on this page
3
>>> page2.end_index() # The 1-based index of the last item on this page
4


>>> p.page(0)
Traceback (most recent call last):
...
InvalidPage
>>> p.page(3)
Traceback (most recent call last):
...
InvalidPage

Paginator 对象

Page 对象

QuerySetPaginator 对象

如果使用 Django 数据库 API 中的 QuerySet``的话, 请使用 ``QuerySetPaginator 来代替 Paginator. 这会提高效率, 并且这两个类在 API 上并不存在任何差异.

之前的 ObjectPaginator 类

Paginator 和 Page 类是在 Django 开发版本新加入的(版本 7306). 在此之前的版本中, Django 提供了provided an具有类似功能的 ObjectPaginator 类, 但是使用起来不够方便. ObjectPaginator 类仍然会被保留, 作为向后兼容. 但是当你试图使用它的时候 Django 会提示 DeprecationWarning.