前言
django自带的分页器Paginator，可以实现分页
Paginator 分页器
paginator模块有3个跟分页相关的类
- Paginator：分页器对象
- PageNotAnInteger：页码不是一个整数时引发该异常
- EmptyPage：页码不在有效范围时（即数据为空）引发该异常
导入Paginator类，可以看到一些内置属性
from django.core.paginator import Paginator
class Paginator:
def __init__(self, object_list, per_page, orphans=0,
allow_empty_first_page=True):
self.object_list = object_list
self._check_object_list_is_ordered()
self.per_page = int(per_page)
self.orphans = int(orphans)
self.allow_empty_first_page = allow_empty_first_page
Paginator 实例化的时候需要传的几个参数
- object_list 查询到的对象list
- per_page 每页显示的内容
- orphans=0， 如果最后一页的数据小于这个值，会合并到上一页
- allow_empty_first_page=True， 允许首页为空 ，默认为True
分页器常用的方法
Paginator类实例化后几个常用的属性和方法
- p.count 获取数据总量
- p.num_pages 获取总页数，如：23条数据，每页显示5条，总共5页
- p.page_range 页面对象可迭代范围
- p.page(1) 传数字，获取对应页的数据
MyDjango>python manage.py shell
>>> from yoyo.models import Teacher
>>> all = Teacher.objects.all()
>>> from django.core.paginator import Paginator
# 实例化，每页显示5条数据
>>> p=Paginator(all,per_page=5)
# 获取全部数据 23条
>>> p.count
23
# 获取总页数，23条数据，每页显示5条，总共5页
>>> p.num_pages
5
# 页面对象可迭代范围1-5
>>> p.page_range
range(1, 6)
# 获取第一页的数据
>>> p.page(1)
<Page 1 of 5>
# 如果页数不在1-5范围，抛异常：EmptyPage
>>> p.page(0)
Traceback (most recent call last):
File "<console>", line 1, in <module>
File "E:python36libsite-packagesdjangocorepaginator.py", line 65, in page
number = self.validate_number(number)
File "E:python36libsite-packagesdjangocorepaginator.py", line 42, in validate_number
raise EmptyPage(_('That page number is less than 1'))
django.core.paginator.EmptyPage: That page number is less than 1
# 如果传入的不是数字类型，会抛异常：PageNotAnInteger
>>> p.page('a')
Traceback (most recent call last):
File "E:python36libsite-packagesdjangocorepaginator.py", line 38, in validate_number
number = int(number)
ValueError: invalid literal for int() with base 10: 'a'
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
File "<console>", line 1, in <module>
File "E:python36libsite-packagesdjangocorepaginator.py", line 65, in page
number = self.validate_number(number)
File "E:python36libsite-packagesdjangocorepaginator.py", line 40, in validate_number
raise PageNotAnInteger(_('That page number is not an integer'))
django.core.paginator.PageNotAnInteger: That page number is not an integer
page()传数字类型后返回一个Page类的实例，可以有以下方法
- number 返回当前操作的是第几页
- object_list 当前页的操作元素列表
- has_next() 判断是否有下一页，返回True或False
- has_previous() 判断是否有上一页，返回True或False
- has_other_pages() 如果有上一页或下一页，返回True。
- previous_page_number() 上一页的页码
- next_page_number() 下一页的页码
- start_index() 返回当前页上的第一个对象，相对于分页列表的所有对象的序号，从1开始。
比如，将23个对象的列表分为每页5个对象，第2页的start_index()会返回 6。 - end_index() 返回当前页上的最后一个对象，相对于分页列表的所有对象的序号，从1开始。
比如，将23个对象的列表分为每页5个对象，第二页的end_index() 会返回 10
>>> page1=p.page(1)
# 返回当前页的对象
>>> page1
<Page 1 of 5>
>>> page1.number
1
>>> page1.has_next()
True
>>> page1.has_previous()
False
>>> page1.start_index()
1
>>> page1.end_index()
5
bootstrap 分页 pagination
bootstrap 分页功能可以看菜鸟教程https://www.runoob.com/bootstrap/bootstrap-pagination.html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Bootstrap 实例 - 分页的状态</title>
<link rel="stylesheet" href="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/css/bootstrap.min.css">
<script src="https://cdn.staticfile.org/jquery/2.1.1/jquery.min.js"></script>
<script src="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/js/bootstrap.min.js"></script>
</head>
<body>
<ul class="pagination">
<li><a href="#">上一页</a></li>
<li class="active"><a href="#">1</a></li>
<li class="disabled"><a href="#">2</a></li>
<li><a href="#">3</a></li>
<li><a href="#">4</a></li>
<li><a href="#">5</a></li>
<li><a href="#">下一页</a></li>
</ul>
</body>
</html>
如下图左边是pagination分页代码，右边是实现效果，可以在线调试，非常方便
django 视图函数
django 视图函数使用分页器Paginator，根据页面url上的请求参数page来获取当前是第几页。
from django.core.paginator import Paginator, PageNotAnInteger, EmptyPage
# 作者-上海悠悠 QQ交流群:717225969
# blog地址 https://www.cnblogs.com/yoyoketang/
def teachersView(request):
teachers = Teacher.objects.all()
# 分页，每页5个数据
pa = Paginator(teachers, per_page=5)
# 获取页数, 如果无默认返回第一页
page_num = request.GET.get('page', 1)
# 判断传入的page_num是不是合法数字类型
try:
page_num = int(page_num)
page_object = pa.get_page(page_num)
except:
page_object = pa.get_page(1)
return render(request, 'teacher.html', locals())
把pa，page_num，page_object三个参数给到模板
上面代码中的get_page() 方法封装了.page()方法当数字超出page_range页码范围时候的异常处理，大于页码或小于页码都返回最后一页
def get_page(self, number):
"""
Return a valid page, even if the page argument isn't a number or isn't
in range.
"""
try:
number = self.validate_number(number)
except PageNotAnInteger:
number = 1
except EmptyPage:
number = self.num_pages
return self.page(number)
模板实现
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Bootstrap 实例 - 分页的状态</title>
<link rel="stylesheet" href="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/css/bootstrap.min.css">
<script src="https://cdn.staticfile.org/jquery/2.1.1/jquery.min.js"></script>
<script src="https://cdn.staticfile.org/twitter-bootstrap/3.3.7/js/bootstrap.min.js"></script>
</head>
<body>
<div class="container">
<h3>分页器加载table表格</h3>
<table class="table table-striped">
<thead>
<tr>
<th>姓名</th>
<th>年龄</th>
<th>电话</th>
</tr>
</thead>
<tbody>
{% for field in page_object %}
<tr>
<td>{{ field.name }}</td>
<td>{{ field.age }}</td>
<td>{{ field.tel }}</td>
</tr>
{% endfor %}
</tbody>
</table>
<ul class="pagination pull-right" id="pager">
{#上一页按钮开始#}
{# 如果当前页有上一页#}
{% if page_object.has_previous %}
{# 当前页的上一页按钮正常使用#}
<li class="previous"><a href="/teachers?page={{ page_object.previous_page_number }}">上一页</a></li>
{% else %}
{# 当前页的不存在上一页时,上一页的按钮不可用#}
<li class="previous disabled"><a href="#">上一页</a></li>
{% endif %}
{#上一页按钮结束#}
{# 页码开始#}
{% for num in pa.page_range %}
{% if num == page_num %}
<li class="active"><a href="/teachers?page={{ num }}">{{ num }}</a></li>
{% else %}
<li><a href="/teachers?page={{ num }}">{{ num }}</a></li>
{% endif %}
{% endfor %}
{#页码结束#}
{# 下一页按钮开始#}
{% if page_object.has_next %}
<li class="next"><a href="/teachers?page={{ page_object.next_page_number }}">下一页</a></li>
{% else %}
<li class="next disabled"><a href="#">下一页</a></li>
{% endif %}
{# 下一页按钮结束#}
</ul>
</div>
</body>
</html>
实现效果图
当页数比较多的时候，中间可以用省略号显示，实现效果如下
具体实现方式，参考下一篇https://www.cnblogs.com/yoyoketang/p/15237570.html