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`对象

这个Paginator类有这个构造函数

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

必须的参数
- object_list
  
  QuerySet带有count() or __len__()方法的列表，元组或其他可分片对象。为了保持一致的分页，QuerySet应该对s进行排序，例如在模型中使用order_by() 子句或缺省值ordering。
- per_page
  
  包含在页面上的最大项目数，不包括 orphans
可选参数
- orphans
  
  当你不想拥有只有极少数项目的最后一页时使用它。如果最后一页的项目数通常小于或等于orphans，那么这些项目将被添加到前一页（这成为最后一页），而不是将项目单独留在页面上。例如，有23个项目，per_page=10和 orphans=3，将会有两个页面; 第一页有10个项目，第二个（最后）页面有13个项目。orphans默认为零，这意味着页面从不合并，最后一页可能有一个项目。
- allow_empty_first_page
  
  是否允许第一页为空。如果False和 object_list为空，则会引发EmptyPage错误。

Page对象

得到Page对象：Paginator.page()

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

class Page(object_list, number, paginator)

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

最后编辑于：2019.04.21 11:17:15

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

Paginator对象

Page对象

`Paginator`对象