Django框架实现的分页demo示例

白榆

发布时间：2026-10-13 | 3人浏览过

原创

本文详细介绍如何在Django框架中实现数据分页功能。内容涵盖从初始化Model、可视化插入数据开始，讲解如何获取URL参数、计算总页数及切片数据。同时提供基础与优化两种分页视图代码，结合Bootstrap前端样式，展示如何拼接HTML分页链接并使用safe过滤器渲染，最终实现带有首页、尾页及局部页面显示的分页效果。

Django分页功能概述

本文通过一个具体实例，详细解析如何使用Django框架实现数据分页功能。该示例旨在为读者提供清晰的参考，帮助理解Django中分页逻辑的实现细节。

数据初始化与插入

首先，需要初始化数据模型并创建对应的数据库表。这是存储数据的基础步骤。


class Book(models.Model):
  name = models.CharField(max_length=20)
  def __str__(self):
    return self.name
  class Meta:
    db_table = 'books'

接着，可以使用PyCharm内置的数据库模块进行可视化操作，向表中插入测试数据，以便后续进行分页展示。

分页核心逻辑解析

接下来分析分页的核心思路。

分页的关键在于URL传递参数。例如，访问http://127.0.0.1:8000/books/?page=5时，URL中的page参数值为5，系统应据此显示第五页的数据。

第一步，从数据库中获取所有图书对象。

第二步，精确计算每一页应该展示的数据条数。

第三步，根据传递过来的page值，从数据集中提取对应的数据片段。


def books(request):
  #取从url传递的参数
  page_num = request.GET.get('page')
  page_num = int(page_num)
  start = (page_num-1)*5
  end = page_num*5
  #总页码数是?
  per_page = 5
  total = models.Book.objects.all().count()
  total,more =divmod(total,per_page)
  if more:
    total+=1
  all_books = models.Book.objects.all()[start:end]
  #自己拼接分页的html代码
  html_str_list = []
  for i in range(1,total):
    tmp = '<li><a href="/books/?page={}" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >{}</li>'.format(i,i)
    html_str_list.append(tmp)
  page_html = "".join(html_str_list)
  return render(request,'books.html',{'books':all_books,'total_page':total,'page_html':page_html})

为了确定总页数，需要获取数据总量。假设每页固定显示5条数据，利用总数据量除以每页数量，若存在余数，则总页数需加1，以包含最后一页不足5条数据的情况。

构建一个列表，用于拼接HTML中的a标签，生成分页导航链接，最后将这些数据传递给前端模板进行渲染。

前端模板与样式实现

前端页面的展示部分。

前端样式采用了Bootstrap框架，开发者可以直接参考Bootstrap官方文档进行样式配置。


<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>书记列表</title>
  <link rel="stylesheet" href="/static/bootstrap/css/bootstrap.css" rel="external nofollow" >
</head>
<body>
<div class="container">
  <table class="table table-bordered">
    <thead>
    <tr>
      <th>序号</th>
      <th>id</th>
      <th>书名</th>
    </tr>
    </thead>
    <tbody>
    {% for book in books %}
      <tr>
        <td>{{ forloop.counter }}</td>
        <td>{{ book.id }}</td>
        <td>{{ book.name }}</td>
      </tr>
    {% endfor %}
    </tbody>
  </table>
<nav aria-label="Page navigation">
 <ul class="pagination">
  <li>
   <a href="#" rel="external nofollow" rel="external nofollow" aria-label="Previous">
    <span aria-hidden="true">&laquo;</span>
   </a>
  </li>
   {{ page_html|safe }}
  <li>
   <a href="#" rel="external nofollow" rel="external nofollow" aria-label="Next">
    <span aria-hidden="true">&raquo;</span>
   </a>
  </li>
 </ul>
</nav>
</div>
</body>
</html>


{{ page_html|safe }}

在模板中，传递过来的page_html变量必须使用safe过滤器处理，否则Django会将其视为纯文本而非HTML代码，导致无法正确渲染分页链接。

经过上述处理，最终呈现的效果即为包含数据列表和分页导航的完整页面。

分页功能优化方案

为了提升用户体验，可以对分页功能进行进一步优化。

优化方案包括添加“首页”和“尾页”按钮，并实现只显示局部页面链接的功能，避免在数据量大时生成过多的分页链接。


def books(request):
  # 取从url传递的参数
  page_num = request.GET.get('page')
  page_num = int(page_num)
  start = (page_num - 1) * 5
  end = page_num * 5
  # 总页码数是?
  per_page = 5
  # 页面上总共展示多少页面
  max_page = 11
  half_max_page = max_page // 2
  # 页面上展示的页面从哪开始
  page_start = page_num - half_max_page
  if page_start <= 1:
    page_start = 1
  total = models.Book.objects.all().count()
  # 页面到哪结束
  page_end = page_num+half_max_page
  if page_end > total:
    page_end = total
    page_start = total - max_page
  total, more = divmod(total, per_page)
  if more:
    total += 1
  all_books = models.Book.objects.all()[start:end]
  # 自己拼接分页的html代码
  html_str_list = []
  html_str_list.append('<li><a href="/books/?page={}" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >首页</li>'.format(1,1))
  for i in range(page_start, page_end+1):
    tmp = '<li><a href="/books/?page={}" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >{}</li>'.format(i, i)
    html_str_list.append(tmp)
  html_str_list.append('<li><a href="/books/?page={}" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >最后一页</li>'.format(total))
  page_html = "".join(html_str_list)
  return render(request, 'books.html', {'books': all_books, 'total_page': total, 'page_html': page_html})

希望本文所述的Django分页实现方法，能对正在学习基于Django框架的Python程序设计的读者有所帮助。