阅读: 20371 评论：1

分页功能是几乎所有的网站上都需要提供的功能，当你要展示的条目比较多时，必须进行分页，不但能减小数据库读取数据压力，也有利于用户浏览。

Django又很贴心的为我们提供了一个Paginator分页工具，但是不幸的是，这个工具功能差了点，不好添加CSS样式，所以前端的展示效果比较丑。如果你能力够，自己编写一个分页器，然后提交给Django官方吧，争取替代掉这个当前的分页器，我看好你哦！

但不管怎么样，当前的Paginator分页器，还是值得学一下用一下的。

一、实例展示

向Paginator提供包含一些对象的列表，以及你想每一页显示几条，比如每页5条、10条、20条、100条等等，它就会为你提供访问的一系列API方法，示例如下：

  1. >>> from django.core.paginator import Paginator
  2. >>> objects = ['john', 'paul', 'george', 'ringo']
  3. >>> p = Paginator(objects, 2)  # 对objects进行分页，虽然objects只是个字符串列表，但没关系，一样用。每页显示2条。
  5. >>> p.count   # 对象个数
  6. 4
  7. >>> p.num_pages  # 总共几页
  8. 2
  9. >>> type(p.page_range)  # `<type 'rangeiterator'>` in Python 2.
  10. <class 'range_iterator'>
  11. >>> p.page_range  # 分页范围
  12. range(1, 3)
  14. >>> page1 = p.page(1) # 获取第一页
  15. >>> page1
  16. <Page 1 of 2>
  17. >>> page1.object_list # 获取第一页的对象
  18. ['john', 'paul']
  20. >>> page2 = p.page(2)
  21. >>> page2.object_list
  22. ['george', 'ringo']
  23. >>> page2.has_next()  # 判断是否有下一页
  24. False
  25. >>> page2.has_previous()# 判断是否有上一页
  26. True
  27. >>> page2.has_other_pages() # 判断是否有其它页
  28. True
  29. >>> page2.next_page_number() # 获取下一页的页码
  30. Traceback (most recent call last):
  31. ...
  32. EmptyPage: That page contains no results
  33. >>> page2.previous_page_number() # 获取上一页的页码
  34. 1
  35. >>> page2.start_index() # 从1开始计数的当前页的第一个对象
  36. 3
  37. >>> page2.end_index() # 从1开始计数的当前页最后1个对象
  38. 4
  40. >>> p.page(0)  # 访问不存在的页面
  41. Traceback (most recent call last):
  42. ...
  43. EmptyPage: That page number is less than 1
  44. >>> p.page(3) # 访问不存在的页面
  45. Traceback (most recent call last):
  46. ...
  47. EmptyPage: That page contains no results

简单地说，使用Paginator分四步走：

  • 使用任何方法，获取要展示的对象列表QuerySet；
  • 将列表和每页个数传递给Paginator，返回一个分页对象；
  • 调用该对象的各种方法，获取各种分页信息；
  • 在HTML模板中，使用上面的分页信息构建分页栏。

.

二、在视图中使用Paginator

下面的例子假设你拥有一个已经导入的Contacts模型。

在视图函数中使用Paginator，参考下面的代码：

  1. from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
  2. from django.shortcuts import render
  4. def listing(request):
  5.     contact_list = Contacts.objects.all()
  6.     paginator = Paginator(contact_list, 25) # 每页显示25条
  8.     page = request.GET.get('page')
  9.     try:
  10.         contacts = paginator.page(page)
  11.     except PageNotAnInteger:
  12.         # 如果请求的页数不是整数，返回第一页。
  13.         contacts = paginator.page(1)
  14.     except EmptyPage:
  15.         # 如果请求的页数不在合法的页数范围内，返回结果的最后一页。
  16.         contacts = paginator.page(paginator.num_pages)
  17.     return render(request, 'list.html', {'contacts': contacts})

在list.html模板中，使用下面的范例来展示每个要显示的contact，以及最后的一个分页栏：

  1. {% for contact in contacts %}
  2.     {# 每个"contact"都是一个Contact模型对象. #}
  3.     {{ contact.full_name|upper }}<br />
  4.     ...
  5. {% endfor %}
  7. {# 分页标签的HTML代码 #}
  8. <div class="pagination">
  9.     <span class="step-links">
  10.         {% if contacts.has_previous %}
  11.             <a href="?page={{ contacts.previous_page_number }}">previous</a>
  12.         {% endif %}
  14.         <span class="current">
  15.             Page {{ contacts.number }} of {{ contacts.paginator.num_pages }}.
  16.         </span>
  18.         {% if contacts.has_next %}
  19.             <a href="?page={{ contacts.next_page_number }}">next</a>
  20.         {% endif %}
  21.     </span>
  22. </div>

三、Paginator对象

Paginator类拥有以下方法和属性：

方法：

Paginator.page(number)[source]

返回指定页面的对象列表，比如第7页的所有内容，下标以1开始。如果提供的页码不存在，抛出InvalidPage异常。

属性：

  • Paginator.count：所有页面的对象总数。
  • Paginator.num_pages：页面总数。
  • Paginator.page_range：基于1的页数范围迭代器。

四、处理异常

在实际使用中，可能恶意也可能不小心，用户请求的页面，可能千奇百怪。正常我们希望是个合法的1，2，3之类，但请求的可能是‘apple’，‘1000000’，‘#’，这就有可能导致异常，需要特别处理。Django为我们内置了下面几个，Paginator相关异常。

  • exception InvalidPage[source]：异常的基类，当paginator传入一个无效的页码时抛出。
  • exception PageNotAnInteger[source]：当向page()提供一个不是整数的值时抛出。
  • exception EmptyPage[source]：当向page()提供一个有效值，但是那个页面上没有任何对象时抛出。

后面两个异常都是InvalidPage的子类，所以你可以通过简单的except InvalidPage来处理它们。

五、Page对象

Paginator.page()将返回一个Page对象，我们主要的操作都是基于Page对象的，它具有下面的方法和属性：

方法：

  • Page.has_next()[source]：如果有下一页，则返回True。
  • Page.has_previous()[source]：如果有上一页，返回 True。
  • Page.has_other_pages()[source]：如果有上一页或下一页，返回True。
  • Page.next_page_number()[source]：返回下一页的页码。如果下一页不存在，抛出InvalidPage异常。
  • Page.previous_page_number()[source]：返回上一页的页码。如果上一页不存在，抛出InvalidPage异常。
  • Page.start_index()[source]：返回当前页上的第一个对象，相对于分页列表的所有对象的序号，从1开始计数。 比如，将五个对象的列表分为每页两个对象，第二页的start_index()会返回3。
  • Page.end_index()[source]:返回当前页上的最后一个对象，相对于分页列表的所有对象的序号，从1开始。 比如，将五个对象的列表分为每页两个对象，第二页的end_index()会返回4。

属性:

  • Page.object_list:当前页上所有对象的列表。
  • Page.number:当前页的序号，从1开始计数。
  • Page.paginator：当前Page对象所属的Paginator对象。