如何在Django的DetailView中分页关联的BookInstance对象？

问题背景 #

图书网站中，Book与BookInstance为一对多关系（BookInstance通过外键关联Book）。当前使用DetailView展示单本图书详情，模板中通过book.bookinstance_set.all遍历所有关联副本，当副本数量较多时页面加载缓慢。需要在同一个图书详情页面（/library/book/<id>）内对关联的BookInstance实现分页。

解决方案 #

通过重写DetailView的get_context_data方法，手动对当前图书的BookInstance集合进行分页处理，具体步骤如下：

1. 修改视图代码 #

引入Django分页相关工具类，并重写get_context_data实现分页逻辑：

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
from django.views.generic import DetailView
from .models import Book

class BookDetailView(DetailView):
    model = Book
    paginate_by = 10  # 自定义每页显示的副本数量

    def get_context_data(self, **kwargs):
        # 先获取父类的上下文数据
        context = super().get_context_data(**kwargs)
        # 获取当前图书对应的所有副本
        book_instance_list = self.object.bookinstance_set.all()
        # 初始化分页器
        paginator = Paginator(book_instance_list, self.paginate_by)
        # 从请求中获取页码参数，默认显示第一页
        page = self.request.GET.get('page')
        
        try:
            # 获取对应页码的副本数据
            book_instances = paginator.page(page)
        except PageNotAnInteger:
            # 若页码不是整数，返回第一页
            book_instances = paginator.page(1)
        except EmptyPage:
            # 若页码超出范围，返回最后一页
            book_instances = paginator.page(paginator.num_pages)
        
        # 将分页后的副本数据传入上下文
        context['book_instances'] = book_instances
        return context

2. 修改模板代码 #

替换原有的副本遍历逻辑，添加分页导航组件：

<!-- 图书详情区域保持不变 -->
<h1>{{ book.title }}</h1>
<p>作者: {{ book.author }}</p>
<p>分类: {{ book.genre }}</p>
<p>ISBN: {{ book.isbn }}</p>

<!-- 分页展示图书副本 -->
<h2>图书副本</h2>
{% for copy in book_instances %}
    <p>{{ copy.instance_id }} - {{ copy.imprint }} - {{ copy.status }}</p>
{% empty %}
    <p>暂无该图书的副本记录</p>
{% endfor %}

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

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

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

关键说明 #

• 分页通过URL参数page控制，例如访问/library/book/1/?page=2即可查看第二页的副本
• paginate_by属性可根据业务需求调整每页显示的副本数量
• 代码处理了页码不合法的边界情况，确保页面稳定性

内容的提问来源于stack exchange，提问作者Artem