白日依山尽,黄河入海流。欲穷千里目,更上一层楼。 -- 唐·王之涣

django 实现分页

1、函数视图分页

1
2
3
4
5
6
7
8
9
10
11
12
from django.core.paginator import Paginator
from django.shortcuts import render
from .models import Post

def index(request):
posts = Post.objects.all()
paginator = Paginator(posts, 15)
# 默认一般都是使用page参数
page_number = request.GET.get('page')
page_obj = paginator.get_page(page_number)
return render(request, 'blog/index.html', {'page_obj': page_obj})

2、类视图分页

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
from django.views.generic import ListView
from .models import Post

class IndexListView(ListView):
# 关联模型
model = Post
# 模板名称,默认推导为 index_list.html
template_name = 'blogv3/index.html'
# 模板中的对象名称,默认为 object_list
context_object_name = 'posts'
# 限制请求方法
http_method_names = ['get']
# 设置分页
paginate_by = 15

# 可以通过get_context_data获取到分页信息,当然前提是设置了 paginate_by
# def get_context_data(self, *args, **kwargs):
# context = super().get_context_data(*args, **kwargs)
# print(context)
# return context

上述调试中获取的到context内容为

1
2
3
4
5
6
7
8
{
'paginator': <django.core.paginator.Paginator object at 0x104ff4160>,
'page_obj': <Page 1 of 4>,
'is_paginated': True,
'object_list': <QuerySet [... ...]>,
'view': <blogv3.views.IndexListView object at 0x104ff43a0>
}

说明:

  • paginator Django的分页对象
  • page_obj 当前页参数, 实际在template中判断的时候使用的就是该对象
  • is_paginated 是否分页
  • object_list 对象名称,context_object_name 定义了posts ,两者效果等效
  • view 视图名称

template中配置实际分页信息

1
2
3
4
5
6
7
8
9
10
11
12
<div class="container navigation">
{% if page_obj.has_previous %}
<a class="navigate pull-left" href="?page={{ page_obj.previous_page_number }}"><i class="fa fa-caret-left"></i> <<< 更 新</a>
{% endif %}

<!-- 当然有时候这里也可以显示当前页码 -->
<span>Current Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }} </span>

{% if page_obj.has_next %}
<a class="navigate pull-right" href="?page={{ page_obj.next_page_number }}">更 多 >>> <i class="fa fa-caret-right"></i></a>
{% endif %}
</div>

附加:

Paginator常用的属性和方法

  • count 总共有多少条记录
  • num_pages 总共有多少页
  • page_range 页面的区间

Page 常用属性和方法

  • has_next
  • has_previous
  • next_page_number
  • previous_page_number
  • number 当前页
  • start_index 当前页的第一条记录的索引值
  • end_index 当前页的最后一条记录的索引值

Paginator 练习

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
(django_exercise_book) [ 22-04-02 11:08 ] [ colinspace ] python manage.py shell
Python 3.9.6 (default, Jul 16 2021, 13:41:17)
[Clang 12.0.5 (clang-1205.0.22.11)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> from django.core.paginator import Paginator
>>> obj_list = ['apple', 'orange', 'banana', 'tomato', 'pear' ]
>>> paginator = Paginator(obj_list, 2)
>>> paginator
<django.core.paginator.Paginator object at 0x106cf8130>
>>> paginator.
paginator.ELLIPSIS paginator.get_page( paginator.page(
paginator.allow_empty_first_page paginator.num_pages paginator.page_range
paginator.count paginator.object_list paginator.per_page
paginator.get_elided_page_range( paginator.orphans paginator.validate_number(
>>> paginator.count
5
>>> paginator.num_pages
3
>>> paginator.per_page
2
>>> paginator.page_range
range(1, 4)
>>> paginator.object_list
['apple', 'orange', 'banana', 'tomato', 'pear']
>>>
>>>
>>> page1 = paginator.page(2)
>>> page2 = paginator.page(2)
>>>
>>> page2
<Page 2 of 3>
>>> page2.
page2.count( page2.has_other_pages( page2.next_page_number( page2.paginator
page2.end_index( page2.has_previous( page2.number page2.previous_page_number(
page2.has_next( page2.index( page2.object_list page2.start_index(
>>> page2.has_previous()
True
>>> page2.has_next()
True
>>> page2.number
2
>>> page2.has_other_pages()
True
>>> page2.next_page_number()
3
>>> page2.previous_page_number()
1
>>> page2.start_index()
3
>>> page2.end_index()
4
>>>

参考:
https://docs.djangoproject.com/en/3.2/topics/pagination/