list查询拼接的对象怎么分页查询变成page_通过 Django Pagination 实现简单分页

ac381dabdcf53734903037bb0998cc30.png

作者:HelloGitHub-追梦人物[1]

文中所涉及的示例代码,已同步更新到 HelloGitHub-Team 仓库[2]

点击本文最下方的“阅读原文”即可获取

当博客上发布的文章越来越多时,通常需要进行分页显示,以免所有的文章都堆积在一个页面,影响用户体验。

Django 内置的 Pagination 能够帮助我们实现简单的分页功能,在上一篇教程[3]中我们使用脚本批量生成了几百篇博客文章,正好用于测试分页效果。

Paginator 类的常用方法

分页功能由 Django 内置的 Paginator 类提供,这个类位于 django.core.paginator 模块,需要使用它时,只需在适当的地方导入这个类即可:

from django.core.paginator import Paginator

下面的代码摘自 Django 的官方文档中 Pagination[4] 的示例,只需实例化一个 Paginator 对象,并在实例化时传入一个需要分页的列表对象,就可以得到分页后的对象。

# 对 item_list 进行分页,每页包含 2 个数据。
>>> item_list = ['john', 'paul', 'george', 'ringo']
>>> p = Paginator(item_list, 2)

取特定页的数据:

# 取第 2 页的数据
>>> page2 = p.page(2)
>>> page2.object_list
['george', 'ringo']

查询特定页的当前页码数:

>>> page2.number
2

查看分页后的总页数:

>>> p.num_pages
2

查看某一页是否还有上一页,以及查询该页上一页的页码:

# 查询第二页是否还有上一页
>>> page2.has_previous()
True

# 查询第二页上一页的页码
>>> page2.previous_page_number()
1

查看某一页是否还有下一页,以及查询该页下一页的页码:

# 查询第二页是否还有下一页
>>> page2.has_next()
False

# 查询第二页下一页的页码
>>> page2.next_page_number()
Traceback (most recent call last):
...
EmptyPage: That page contains no results

更多方法和属性请参阅 Django Pagination 的官方文档[5]

用 Paginator 给文章列表分页

使用上面的一些方法,我们可以实现一个类似于 Django 官方博客一样的简单分页效果,效果如下。

6565d8b88bcbaa62d9e7fb02ef436eef.png

这里 Django 的官方文档中给出了一个在视图函数中对列表进行分页的示例,这个视图函数获取一个联系人列表并对其分页:

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
from django.shortcuts import render

def listing(request):
   contact_list = Contacts.objects.all()
   paginator = Paginator(contact_list, 25) # 每页显示 25 个联系人

   page = request.GET.get('page')
   try:
       contacts = paginator.page(page)
   except PageNotAnInteger:
       # 如果用户请求的页码号不是整数,显示第一页
       contacts = paginator.page(1)
   except EmptyPage:
       # 如果用户请求的页码号超过了最大页码号,显示最后一页
       contacts = paginator.page(paginator.num_pages)

   return render(request, 'list.html', {'contacts': contacts})

这就是在视图函数中使用分页的代码逻辑,你可以把它当做一个模板应用于自己的任何需要分页的视图函数。不过在我们的博客项目中,我们不必写这些代码了。回顾在 Django 官方推荐的姿势:类视图[6] 中的内容,我们已将视图函数转换成了类视图。而类视图 ListView 已经帮我们写好了上述的分页逻辑,我们只需通过指定 paginate_by 属性来开启分页功能即可,即在类视图中指定 paginate_by 属性的值:

blog/views.py

class IndexView(ListView):
model = Post
template_name = 'blog/index.html'
context_object_name = 'post_list'
# 指定 paginate_by 属性后开启分页功能,其值代表每一页包含多少篇文章
paginate_by = 10

这里我们设置了每 10 篇文章一页。

在模板中设置分页导航

接下来便是在模板中设置分页导航,比如上一页、下一页的按钮,以及显示一些页面信息。我们这里设置和 Django 官方博客那样的分页导航样式(具体的样式见上图)。ListView 传递了以下和分页有关的模板变量供我们在模板中使用:

  • paginator ,即 Paginator 的实例。
  • page_obj ,当前请求页面分页对象。
  • is_paginated,是否已分页。只有当分页后页面超过两页时才算已分页。
  • object_list,请求页面的对象列表,和 post_list 等价。所以在模板中循环文章列表时可以选 post_list ,也可以选 object_list

模板中使用示例:

templates/blog/index.html

{% if is_paginated %}
<div class="pagination-simple">

{% if page_obj.has_previous %}
<a href="?page={{ page_obj.previous_page_number }}">上一页a>
{% endif %}

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

{% if page_obj.has_next %}
<a href="?page={{ page_obj.next_page_number }}">下一页a>
{% endif %}
div>
{% endif %}

其中 {{ }} 模板变量中的内容,其含义已在文章开头部分的 Paginator 类的常用方法中已有介绍。另外还要注意一点,请求哪一个页面通过 page 查询参数传递给 django 视图,django 会根据 page 的值返回对应页面的文章列表,所以上一页和下一页超链接的 href 属性指向的 url 带上了 page 查询参数。

最终我们得到如下的分页效果:

7dbc2135ec4e2dfc89438a41b29da731.png

当 然这只是一个简单示例,分页导航处的视觉效果并不是很好看,你可以自行为其添加 CSS 样式使其看上去更加美观。

进一步拓展

使用 Django 内置的 Pagination 只能实现上面的简单分页效果,但通常更加高级的分页效果应该像下图这样:

0f1b4ddc32a612d4b02351477888148e.png

当前页面高亮显示,且显示当前页面前后几页的页码,始终显示第一页和最后一页的页码,中间可能还有省略号的效果,表示还有未显示的页码。

仅仅使用 Django Pagination 内置的方法无法实现这样的效果,需要自己写分页逻辑或者借助第三方库。接下来我们将详细说明如何借助第三方库拓展 Pagination 以实现一个完善的分页效果。

参考资料

[1]HelloGitHub-追梦人物: https://www.zmrenwu.com

[2]HelloGitHub-Team 仓库: https://github.com/HelloGitHub-Team/HelloDjango-blog-tutorial

[3]上一篇教程: https://www.zmrenwu.com/courses/hellodjango-blog-tutorial/materials/80/

[4]Pagination: https://docs.djangoproject.com/en/2.2/topics/pagination/

[5]Django Pagination 的官方文档: https://docs.djangoproject.com/en/2.2/topics/pagination/

[6]Django 官方推荐的姿势:类视图: https://www.zmrenwu.com/courses/hellodjango-blog-tutorial/materials/79/

045f1d336cdaedb13334a07ca80bfbb2.png

关注公众号加入交流群,一起讨论有趣的技术话题

『讲解开源项目系列』——让对开源项目感兴趣的人不再畏惧、让开源项目的发起者不再孤单。跟着我们的文章,你会发现编程的乐趣、使用和发现参与开源项目如此简单。欢迎联系我(微信:xueweihan  备注:讲解)加入我们,让更多人爱上开源、贡献开源

HelloDjango 往期回顾:

第 22 篇:使用 Django 项目中的 ORM 编写伪造测试数据脚本

第 21 篇:Django 官方推荐的姿势:类视图

第 20 篇:开发 Django 博客文章阅读量统计功能

获取更多信息、“在看”让本文被更多人看到、“赞赏”支持我们。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
实现模糊查询分页功能需要用到Django的ORM和Paginator模块。 模糊查询: 1. 在views.py中定义视图函数,接收用户输入的查询关键字,并使用icontains进行模糊匹配。 ```python from django.core.paginator import Paginator from django.shortcuts import render from .models import Book def book_search(request): keyword = request.GET.get('keyword') books = Book.objects.filter(name__icontains=keyword) return render(request, 'book_search.html', {'books': books}) ``` 2. 在模板中使用表单接收用户输入的关键字,展示查询结果。 ```html <form method="get" action="{% url 'book_search' %}"> <input type="text" name="keyword"> <button type="submit">搜索</button> </form> {% if books %} <ul> {% for book in books %} <li>{{ book.name }}</li> {% endfor %} </ul> {% else %} <p>暂无结果</p> {% endif %} ``` 分页: 1. 在views.py中定义视图函数,使用Paginator将查询结果分页。 ```python def book_list(request): books = Book.objects.all() paginator = Paginator(books, 10) page_number = request.GET.get('page') page_obj = paginator.get_page(page_number) return render(request, 'book_list.html', {'page_obj': page_obj}) ``` 2. 在模板中展示分页导航和当前页的数据。 ```html <ul> {% for book in page_obj %} <li>{{ book.name }}</li> {% endfor %} </ul> <div> {% if page_obj.has_previous %} <a href="?page={{ page_obj.previous_page_number }}">上一页</a> {% endif %} <span>{{ page_obj.number }}</span> {% if page_obj.has_next %} <a href="?page={{ page_obj.next_page_number }}">下一页</a> {% endif %} </div> ```

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值