Django实战项目-学习任务系统-查询列表分页显示

接着上期代码框架，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. 点击查看积分流水列表页面