当前位置：首页 > article >正文

Django 分页操作详解

article 2025/3/16 11:02:31

Django 分页操作详解

在 Django 项目中，当处理大量数据时，分页是一项非常关键的功能。它不仅可以提高用户体验，还能减少服务器的负担。Django 提供了一个强大的分页工具——django.core.paginator.Paginator，可以很方便地实现数据的分页显示。本文将详细介绍如何使用 Django 的分页插件来实现分页功能。

一、引入分页器

首先，需要在你的视图文件中引入 Django 的分页器模块。这是实现分页功能的第一步。

from django.core.paginator import Paginator

二、创建分页器对象

创建分页器对象时，需要传入两个参数：

object_list：未分页的查询结果，通常是一个 QuerySet 对象。
per_page：每页显示的条目数。

# 假设我们有一个模型对象列表 query_set
query_set = MyModel.objects.all()

# 每页显示 10 条数据
per_page = 10

# 创建分页器对象
paginator = Paginator(query_set, per_page)

三、设置页码并获取分页数据

使用 paginator.get_page(number) 方法，可以获取特定页码的分页数据。这里 number 是用户请求的页码。

# number 是用户请求的页码，例如从 URL 参数中获取
number = request.GET.get('page', 1)  # 默认显示第一页

# 获取分页后的 Page 对象
page = paginator.get_page(number)

四、Page 对象常见的属性和方法

Page 对象包含了很多有用的属性和方法，可以帮助你实现分页逻辑和页面导航。

object_list：当前页的数据列表。
```
current_data = page.object_list
```
number：当前页码。
```
current_page_number = page.number
```
paginator.num_pages：总页数。
```
total_pages = paginator.num_pages
```
has_next：是否有下一页。
```
has_next_page = page.has_next
```
has_previous：是否有上一页。
```
has_previous_page = page.has_previous
```

next_page_number：下一页的页码。

next_page_num = page.next_page_number if page.has_next else None

previous_page_number：上一页的页码。

previous_page_num = page.previous_page_number if page.has_previous else None

五、在模板中渲染分页数据

在 Django 模板中，你可以通过传递 page 对象来渲染分页数据，同时生成分页导航链接。

<!-- 渲染当前页的数据 -->
<ul>
    {% for item in page.object_list %}
        <li>{{ item.some_field }}</li>
    {% endfor %}
</ul>

<!-- 分页导航 -->
<div>
    <span>Page {{ page.number }} of {{ page.paginator.num_pages }}</span>
    {% if page.has_previous %}
        <a href="?page=1">&laquo; first</a>
        <a href="?page={{ page.previous_page_number }}">previous</a>
    {% endif %}

    <span>
        {% for i in page.paginator.page_range %}
            {% if page.number == i %}
                <strong>{{ i }}</strong>
            {% else %}
                <a href="?page={{ i }}">{{ i }}</a>
            {% endif %}
        {% endfor %}
    </span>

    {% if page.has_next %}
        <a href="?page={{ page.next_page_number }}">next</a>
        <a href="?page={{ page.paginator.num_pages }}">last &raquo;</a>
    {% endif %}
</div>