# 对 item_list 进行分页，每页包含 2 个数据。 >>> item_list = ['john', 'paul', 'george', 'ringo'] >>> p = Paginator(item_list, 2)

取特定页的数据：

# 取第 2 页的数据 >>> page2 = p.page(2) >>> page2.object_list
['george', 'ringo']

查询特定页的当前页码数：

>>> page2.number 2 

查看分页后的总页数：

>>> p.num_pages 2 

查看某一页是否还有上一页，以及查询该页上一页的页码：

# 查询第二页是否还有上一页 >>> page2.has_previous() True # 查询第二页上一页的页码 >>> page2.previous_page_number() 1

查看某一页是否还有下一页，以及查询该页下一页的页码：

# 查询第二页是否还有下一页 >>> page2.has_next() False # 查询第二页下一页的页码 >>> page2.next_page_number() Traceback (most recent call last): ... EmptyPage: That page contains no results

更多方法和属性请参阅 Django Pagination 的官方文档^[5]。

用 Paginator 给文章列表分页

使用上面的一些方法，我们可以实现一个类似于 Django 官方博客一样的简单分页效果，效果如下。

这里 Django 的官方文档中给出了一个在视图函数中对列表进行分页的示例，这个视图函数获取一个联系人列表并对其分页：

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger from django.shortcuts import render def listing(request):     contact_list = Contacts.objects.all()     paginator = Paginator(contact_list, 25) # 每页显示 25 个联系人     page = request.GET.get('page')  try:         contacts = paginator.page(page)  except PageNotAnInteger:  # 如果用户请求的页码号不是整数，显示第一页         contacts = paginator.page(1)  except EmptyPage:  # 如果用户请求的页码号超过了最大页码号，显示最后一页         contacts = paginator.page(paginator.num_pages)  return render(request, 'list.html', {'contacts': contacts})

这就是在视图函数中使用分页的代码逻辑，你可以把它当做一个模板应用于自己的任何需要分页的视图函数。不过在我们的博客项目中，我们不必写这些代码了。回顾在 Django 官方推荐的姿势：类视图^[6] 中的内容，我们已将视图函数转换成了类视图。而类视图 ListView已经帮我们写好了上述的分页逻辑，我们只需通过指定 paginate_by属性来开启分页功能即可，即在类视图中指定 paginate_by属性的值：

blog/views.py class IndexView(ListView): model = Post
    template_name = 'blog/index.html' context_object_name = 'post_list' # 指定 paginate_by 属性后开启分页功能，其值代表每一页包含多少篇文章 paginate_by = 10 

templates/blog/index.html

{% if is_paginated %} <div class="pagination-simple">  {% if page_obj.has_previous %} <a href="?page={{ page_obj.previous_page_number }}">上一页a> {% endif %}  <span class="current">第 {{ page_obj.number }} 页 / 共 {{ paginator.num_pages }} 页span>  {% if page_obj.has_next %} <a href="?page={{ page_obj.next_page_number }}">下一页a> {% endif %} div> {% endif %}