Django项目分页功能详解：从基础到实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01189/article/details/148323771

Django项目分页功能详解：从基础到实践

django django/django: 是一个用于 Python 的高级 Web 框架，可以用于快速开发安全和可维护的 Web 应用程序，提供了多种内置功能和扩展库，支持多种数据库和模板引擎。项目地址: https://gitcode.com/gh_mirrors/dj/django

什么是分页

在Web开发中，分页是一种常见的数据展示技术，它将大量数据分割成多个页面显示，通常伴随"上一页/下一页"的导航链接。Django提供了强大而灵活的分页功能，让开发者能够轻松实现这一常见需求。

Django分页核心：Paginator类

Django的分页功能核心是Paginator类，位于django.core.paginator模块中。这个类负责将数据集分割成多个页面对象（Page对象）。

Paginator基本用法

创建一个Paginator实例非常简单：

from django.core.paginator import Paginator

# 可以是列表、元组或QuerySet
objects = ["item1", "item2", "item3", "item4", "item5"]
paginator = Paginator(objects, 2)  # 每页显示2个元素

Paginator的重要属性和方法

count：对象总数
num_pages：总页数
page_range：页码迭代器，从1开始
page(number)：获取指定页码的Page对象

Page对象的重要方法

每个Page对象都有以下实用方法：

object_list：当前页的对象列表
has_next()：是否有下一页
has_previous()：是否有上一页
next_page_number()：下一页页码
previous_page_number()：上一页页码
start_index()：当前页第一个对象的索引（从1开始）
end_index()：当前页最后一个对象的索引

实际应用场景

1. 在视图函数中使用分页

from django.core.paginator import Paginator
from django.shortcuts import render
from myapp.models import MyModel

def my_view(request):
    # 获取所有对象
    object_list = MyModel.objects.all()
    
    # 创建Paginator实例，每页显示25个
    paginator = Paginator(object_list, 25)
    
    # 从GET参数获取当前页码
    page_number = request.GET.get('page')
    
    # 获取当前页对象
    page_obj = paginator.get_page(page_number)
    
    # 将page_obj传递给模板
    return render(request, 'my_template.html', {'page_obj': page_obj})

2. 在类视图中使用分页

Django的通用视图ListView内置了分页支持，只需设置paginate_by属性：

from django.views.generic import ListView
from myapp.models import MyModel

class MyListView(ListView):
    model = MyModel
    template_name = 'my_template.html'
    context_object_name = 'objects'
    paginate_by = 10  # 每页显示10个对象

模板中的分页导航

在模板中，我们可以使用page_obj提供的属性和方法来创建分页导航：

<div class="pagination">
    <span class="step-links">
        {% if page_obj.has_previous %}
            <a href="?page=1">&laquo; 首页</a>
            <a href="?page={{ page_obj.previous_page_number }}">上一页</a>
        {% endif %}

        <span class="current">
            第 {{ page_obj.number }} 页，共 {{ page_obj.paginator.num_pages }} 页
        </span>

        {% if page_obj.has_next %}
            <a href="?page={{ page_obj.next_page_number }}">下一页</a>
            <a href="?page={{ page_obj.paginator.num_pages }}">末页 &raquo;</a>
        {% endif %}
    </span>
</div>