>>> from django.core.paginator import Paginator>>> objects = ['john', 'paul', 'george', 'ringo']>>> p = Paginator(objects, 2)

>>> p.count4>>> p.num_pages2>>> p.page_range[1, 2]

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

>>> p.page(0)...EmptyPage: That page number is less than 1>>> p.page(3)...EmptyPage: That page contains no results

Note

Paginator 的第一个参数可以是list，tuple，QuerySet 或者任意对象————只要它 有 count() 或者 __len__() 函数。 Django后台会先尝试调用 count()``。如果 不可行，再定要 ``len() 。

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

def listing(request):    contact_list = Contacts.objects.all()    paginator = Paginator(contact_list, 25) # Show 25 contacts per page

    # Make sure page request is an int. If not, deliver first page.    try:        page = int(request.GET.get('page', '1'))    except ValueError:        page = 1

    # If page request (9999) is out of range, deliver last page of results.    try:        contacts = paginator.page(page)    except (EmptyPage, InvalidPage):        contacts = paginator.page(paginator.num_pages)

    return render_to_response('list.html', {"contacts": contacts})

必传参数¶

object_list

一个list，tuple，django的QuerySet，或者拥有``count()``或``__len__()``方法的 可分解对象。

per_page

每一页最大的对象个数。

可选参数¶

orphans

最后一页对象的最少数目，默认为0。 如果想避免最后一页显示太少。则可以使用这个值。 那么最后一页的数据，自动被前移一页。比如总共23个数据。每页显示 10. orphans=3 那么，第一页为10，第二页为13.

allow_empty_first_page

表示首页是否可以为空，如果是 False 而且``object_list`` 为空，那么会触发 EmptyPage 异常。

方法¶

Paginator.page(number)

根据索引number，返回一个’Page’对象，如果不存在，引起 InvalidPage异常

属性¶

Paginator.count

所有对象的总数， 尝试通过``object_list.count()``和``object_list.__len__()`` 取得

Paginator.num_pages

总共的页数

Paginator.page_range

页的范围，比如 [1, 2, 3, 4] 。

方法¶

Page.has_next()

如果下一页存在，返回True。

Page.has_previous()

如果前一页存在返回 True

Page.has_other_pages()

如果上一页面或者下一页存在，返回``True``

Page.next_page_number()

返回下一页的索引，这个函数比较傻（不管下一页是否存在，都是简单的+1）

Page.previous_page_number()

返回上一页的索引，其他同上

Page.start_index()

返回当前页，第一个对象的索引。

Page.end_index()

道理同上。

属性¶

Page.object_list

当前页对象列表

Page.number

当前页的索引

Page.paginator

和page相关的分页类