Django使用内置分页器实现分页功能

# views.py
from django.shortcuts import render_to_response
from django.core.paginator import Paginator

def classify(request):
    """
    注意：objects可以为：列表/元组，Django QuerySet或任何其他对象
    """
    
    # 获取所有的对象的列表
    objects = goods.objects.all()      # objects = ['john', 'paul', 'george', 'ringo']
    
    # 把对象分成 2 个一页
    paginator = Paginator(objects, 2)   # <django.core.paginator.Paginator object at 0x7ff72635f6a0>
    
    # 获取分页器里面的Page总数
    paginator.count     # -> 4
    
    # 获取Page的数量
    paginator.num_pages  # -> 2
    
    # 获取Page数目的范围（返回一个range_iterator对象）
    paginator.page_range  # -> range(1, 3)
    
    # 获得第一/二页的Page对象
    page1 = paginator.page(1)  # <Page 1 of 2>   # 返回Page具有给定从1开始的索引的对象。InvalidPage如果给定页码不存在则引发 。
    page2 = paginator.get_page(2)  # <Page 1 of 2>    django2 新增功能：返回Page具有给定的基于1的索引的对象，同时处理超出范围和无效页码（超出范围不会报错，默认返回最后一个Page对象）
    
    # 获得第一个Page对象中的所有内容
    page1.object_list  # -> ['john', 'paul']
    
    # 判断下一个Page对象是否存在
    page2.has_next()  # -> False
    # 判断上一个Page对象是否存在 
    page1.has_previous()  #-> False
    
    # 判断是否还有其他Page对象
    page2.has_other_pages()   # True
    
    # 返回下一个Page对象的索引。如果没有，则触发EmptyPage
    page2.next_page_number()  # 报错
    # 返回上一个Page对象的索引。如果没有，则触发EmptyPage
    page2.previous_page_number()  # 1
    
    # 返回第一个Page对象中的第一个元素的索引值（原对象的第一个元素的位置为1）
    page1.start_index()  # 1
    # 返回第二个Page对象中的第一个元素的索引值（原对象的第一个元素的位置为1）
    page2.start_index()  # 3
    # 返回第二个Page对象里面的第一个对象的最后一个元素位置（原对象的第一个元素的位置为1）
    page1.end_index()  # 2
    # 返回第二个分页器里面的第一个对象的最后一个元素位置（原对象的第一个元素的位置为1）
    page2.end_index()  # 4
    
    # 获取当前页码
    current_page_num = page1.number
    return render_to_response('classify.html')

Paginator对象

1. 这个Paginator类有这个构造函数

   class Paginator(object_list, per_page, orphans=0, allow_empty_first_page=True)
   

2. 必须的参数

   • object_list

     QuerySet带有count() or __len__()方法的列表，元组或其他可分片对象。为了保持一致的分页，QuerySet应该对s进行排序，例如在模型中使用order_by() 子句或缺省值ordering。

   • per_page

     包含在页面上的最大项目数 ，不包括 orphans

3. 可选参数

   • orphans

     当你不想拥有只有极少数项目的最后一页时使用它。如果最后一页的项目数通常小于或等于orphans，那么这些项目将被添加到前一页（这成为最后一页），而不是将项目单独留在页面上。例如，有23个项目，per_page=10和 orphans=3，将会有两个页面; 第一页有10个项目，第二个（最后）页面有13个项目。orphans默认为零，这意味着页面从不合并，最后一页可能有一个项目。

   • allow_empty_first_page

     是否允许第一页为空。如果False和 object_list为空，则会引发EmptyPage错误。

Page对象

1. 得到Page对象：Paginator.page()

2. 使用Page类构造对象生成Page对象

   class Page(object_list, number, paginator)
   

3. Page对象的属性

   • Page.object_list 此页面上的对象列表
   • Page.number 此页面的基于1的页码
   • Page.paginator 关联的Paginator对象