接着上期代码框架,6个主要功能基本实现,剩下的就是细节点的完善优化了。
接着优化查询列表分页显示功能,有很多菜单功能都有查询列表显示页面情况,如果数据量多,不分页显示的话,页面展示效果就不太好。
本次增加查询列表分页显示功能,对一个查询列表功能进行分页改造,其他依此类推即可。
第一步:Django的分页器(paginator)简介
Django的分页器(paginator)是一个内置的分页组件,它可以方便地实现分页功能。当页面需要显示大量数据时,例如超过10000条,使用分页器可以提高阅读体验并减轻服务器压力。
要使用Django的分页器,首先需要从`django.core.paginator`模块中引入`Paginator`类以及相关的异常模块:`PageNotAnInteger`和`EmptyPage`。
`Paginator`是用于管理整个分页的逻辑,如控制总共有多少页、页码区间等。而`Page`类则是用来管理当前这个页面的一些属性。
以下是创建`Paginator`对象的简单语法:
```python
class Paginator(object_list, per_page, orphans=0, allow_empty_first_page=True)
```
其中,`object_list`是你要分页的数据列表,`per_page`是每页显示的数据条数。
例如:
给 Paginator 一个对象列表,以及你希望在每个页面上拥有的项目数,它提供了访问每页项目的方法:
>>> from django.core.paginator import Paginator
>>> objects = ['john', 'paul', 'george', 'ringo']
>>> p = Paginator(objects, 2)
>>> p.count
4
>>> p.num_pages
2
>>> type(p.page_range)
<class 'range_iterator'>
>>> p.page_range
range(1, 3)
>>> page1 = p.page(1)
>>> page1
<Page 1 of 2>
>>> page1.object_list
['john', 'paul']
>>> page2 = p.page(2)
>>> page2.object_list
['george', 'ringo']
>>> page2.has_next()
False
>>> page2.has_previous()
True
>>> page2.has_other_pages()
True
>>> page2.next_page_number()
Traceback (most recent call last):
...
EmptyPage: That page contains no results
>>> page2.previous_page_number()
1
>>> page2.start_index() # The 1-based index of the first item on this page
3
>>> page2.end_index() # The 1-based index of the last item on this page
4
>>> p.page(0)
Traceback (most recent call last):
...
EmptyPage: That page number is less than 1
>>> p.page(3)
Traceback (most recent call last):
...
EmptyPage: That page contains no results
第二步:修改视图文件
./mysite/study_system/views.py
def getStudyPointsList(request):
'''
@方法名称: 获取积分明细列表
@作 者: PandaCode辉
@weixin公众号: PandaCode辉
@创建时间: 2023-10-10
'''
# 响应容器
rsp_dict = {}
# 获取当前用户名
username = request.session.get('username')
# 根据用户名获取用户对象
cur_user = StudyUser.objects.get(username=username)
print('根据用户名查询用户对象:' + str(cur_user))
# 2. 获取要分页的数据集合(例如从数据库查询),当前用户的全部积分明细, .order_by('-created_time') 降序排列
data_list = StudyPoint.objects.filter(user_id=cur_user).order_by('-created_time')
# 3. 每页显示的数据数量
items_per_page = 5
# 4. 创建 Paginator 对象
paginator = Paginator(data_list, items_per_page)
# 5. 获取当前页数(从请求参数中获取,或者默认为第一页)
current_page_num = request.GET.get('page', 1)
'''
1.整个数据表
paginator.count 数据总数
paginator.num_pages 总页数
paginator.page_range 页码的列表
2.当前页
curuent_page.has_next() 是否有下一页
curuent_page.next_page_number() 下一页的页码
curuent_page.has_previous() 是否有上一页
curuent_page.previous_page_number() 上一页的页码
'''
# 6. 获取当前页的数据对象
try:
current_page_data = paginator.page(current_page_num)
except EmptyPage:
# 处理页码超出范围的情况
current_page_data = paginator.page(paginator.num_pages)
# 获取整个表的总页数
total_page = paginator.num_pages
pag_range = []
if total_page <= 11: # 判断当前页是否小于11个
pag_range = paginator.page_range
elif total_page > 11:
if current_page_num < 6:
pag_range = range(1, 11)
elif current_page_num > paginator.num_pages - 5:
pag_range = range(total_page - 9, total_page + 1)
else:
pag_range = range(current_page_num - 5, current_page_num + 5) # 当前页+5大于最大页数时
# 7. 在模板中使用 current_data_page 来渲染分页数据
# 查询待完成任务列表
rsp_dict['data_list'] = data_list
rsp_dict['paginator'] = paginator
rsp_dict['current_page_num'] = current_page_num
rsp_dict['current_page_data'] = current_page_data
rsp_dict['pag_range'] = pag_range
context_object_name = "study_points_list"
template_name = "study_system/home.html"
# 'html_file': 'xxx.html' 动态指定模板页面 ; 'menuTo': 'task' = 任务管理 ;
rsp_dict['html_file'] = 'study_system/item/studyPointsList.html'
rsp_dict['context_object_name'] = context_object_name
return render(request, template_name, rsp_dict)
第三步:修改页面模板代码
1. 积分流水列表页面
./mysite/study_system/templates/study_system/item/studyPointsList.html
<style type="text/css">
table tr td {
font-size: 1.5em;
}
</style>
<!-- 结果显示区 -->
<div align="center">
<table style='width: 100%;'>
<tr>
<td colspan="6" align="center">积分明细流水</td>
</tr>
<tr style="font-weight: bold; background: #FFEC8B;text-align: center">
<td>序号</td>
<td>积分说明</td>
<td>交易类型</td>
<td>积分数</td>
<td>交易时间</td>
<td>用户名</td>
</tr>
{% if current_page_data %}
{% for studyPoints in current_page_data %}
{% if studyPoints.point_type == 0 %}
<tr style="color: blue;text-align: center">
{# forloop.counter 可以记录循环的次数,作为列表序号#}
<td>{{ forloop.counter }}</td>
<td>{{ studyPoints.point_name }}</td>
<td>兑换物品</td>
<td>{{ studyPoints.points_nums }}</td>
<td>{{ studyPoints.created_time|date:'Y-m-d H:i:s' }}</td>
<td>{{ studyPoints.user_id.username }}</td>
</tr>
{% elif studyPoints.point_type == 1 %}
<tr style="color: red;text-align: center">
<td>{{ forloop.counter }}</td>
<td>{{ studyPoints.point_name }}</td>
<td>成功奖励</td>
<td>{{ studyPoints.points_nums }}</td>
<td>{{ studyPoints.created_time|date:'Y-m-d H:i:s' }}</td>
<td>{{ studyPoints.user_id.username }}</td>
</tr>
{% elif studyPoints.point_type == 2 %}
<tr style="color: green;text-align: center">
<td>{{ forloop.counter }}</td>
<td>{{ studyPoints.point_name }}</td>
<td>失败处罚</td>
<td>{{ studyPoints.points_nums }}</td>
<td>{{ studyPoints.created_time|date:'Y-m-d H:i:s' }}</td>
<td>{{ studyPoints.user_id.username }}</td>
</tr>
{% endif %}
{% endfor %}
{% else %}
<tr>
<td colspan="6" id="con_title">查无记录</td>
</tr>
{% endif %}
</table>
</div>
<div align="center">
{% include "study_system/common/page.html" %}
</div>
2. 公共页码页面
./mysite/study_system/templates/study_system/common/page.html
<div>
<nav aria-label="Page navigation">
<ul class="pagination">
{% if not current_page_data.has_previous %}<!--判断是否有上一页-->
<li class="disable">
<a href="#" aria-label="Previous">
<span aria-hidden="true">上一页</span>
</a>
</li>
{% else %}
<li>
<a href="?page={{ current_page_data.previous_page_number }}" aria-label="Previous">
<span aria-hidden="true">上一页</span>
</a>
</li>
{% endif %}
{% for page_range in pag_range %}
{% if current_page_num == page_range %}<!--判断遍历的页数是否为当前页,是就添加.avtive 背景色变蓝-->
<li class="active"><a href="?page={{ page_range }}">{{ page_range }}</a></li>
{% else %}
<li><a href="?page={{ page_range }}">{{ page_range }}</a></li>
{% endif %}
{% endfor %}
{% if not current_page_data.has_next %}<!-- 判断是否最后一页 -->
<li class="disable">
<a href="?page={{ current_page_num }}" aria-label="Next">
<span aria-hidden="true">下一页</span>
</a>
</li>
{% else %}
<li>
<a href="?page={{ current_page_data.next_page_number }}" aria-label="Next">
<span aria-hidden="true">下一页</span>
</a>
</li>
{% endif %}
</ul>
</nav>
</div>
第四步:运行测试
1. 点击查看积分流水列表页面
-------------------------------------------------end -------------------------------------------------