Django 分页器的使用

Django 分页器的使用

Django作为Python Web开发框架的一哥，提供了企业级网站开发所需要的几乎所有功能，其中就包括自带分页功能。利用Django自带的Paginator类，我们可以很轻松地实现分页。Django 2.0和1.X最大的不同在于新增了get_page()方法。我们现在来具体看看有什么不同。

Django 1.X 和Django 2.0下实现分页

利用Django实现分类非常简单，我们只需要修改views.py和模板template。Django 1.X下实现分页代码如下:

# app/views.py - 基于函数的视图

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

from .models import Article

from django.shortcuts import render

def article_list(request):

    article_list = Article.objects.all()

    paginator = Paginator(article_list, 10)  # 实例化一个分页对象, 每页显示10个

    page = request.GET.get('page')  # 从URL通过get页码，如?page=3

    try:

        articles = paginator.page(page)  # 获取某页对应的记录

    except PageNotAnInteger:  # 如果页码不是个整数

        articles = paginator.page(1)  # 提取第一页的记录

    except EmptyPage:  # 如果页码太大，没有相应的记录

        articles = paginator.page(paginator.num_pages)  # 提取最后一页的记录

    return render(request, 'article_list.html', {'articles': articles})

你注意到没有？上段代码的try和2个except非常重要，但是看上去有些冗余。Django 2.0下新增了get_page()方法，可以将代码大大简化（如下图所示）。它所实现的功能与上面是一样的。当用户提交的页码不是整数时，提取第一页记录。当用户输入的页码太大时，只提取最后一页记录。

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

from .models import Article

from django.shortcuts import render

def article_list(request):

    article_list = Article.objects.all()

    paginator = Paginator(article_list, 10)  # 实例化一个分页对象, 每页显示10个

    page = request.GET.get('page')  # 从URL通过get页码，如?page=3

   articles = paginator.get_page(page)  # 获取某页对应的记录, 如果

    return render(request, 'article_list.html', {'articles': articles})

Django 1.X和2.0下的模板是一样的。这里提供两种显示方案。

模板一: 上一页, Page 1 of 3, 下一页

#app/templates/app/article_list.html

{% for article in articles %}

    {{ article.title }}  

{% endfor %}

<div class="pagination">

    <span class="step-links">

        {% if articles.has_previous %}

            <a href="?page=1">« first</a>

            <a href="?page={{ articles.previous_page_number }}">previous</a>

        {% endif %}

        <span class="current">

            Page {{ articles.number }} of {{ articles.paginator.num_pages }}.

        </span>

        {% if articles.has_next %}

            <a href="?page={{ articles.next_page_number }}">next</a>

            <a href="?page={{ articles.paginator.num_pages }}">last »</a>

        {% endif %}

    </span>

</div>

模板二: Page 1, 2, 3, 4, 5, 6, 7, 8, ... (推荐)

#app/templates/app/article_list.html

# Pagination style 2

{% for article in articles %}

    {{ article.title }}

{% endfor %}

<div class="pagination">

<nav>

    <ul class="pagination">

        {% if articles.has_previous %}

        <li class="">

        <a href="?page={{ articles.previous_page_number }}" aria-label="Previous">

        <span aria_hidden="true">«</span></a>

        </li>

        {% endif %}

        {% for page_num in articles.paginator.page_range %}

            {% if page_num == articles.number %}

         <li class="active"><a href="?page={{ page_num }}">{{page_num}}</a> </li>

            {% else %}

         <li class=""><a href="?page={{ page_num }}">{{page_num}}</a> </li>

            {% endif %}

        {% endfor %}

        {% if articles.has_next %}

         <li class="">

              <a href="?page={{ articles.next_page_number }}" aria-label="Next">

                  <span aria_hidden="true">»</span></a>

        </li>

      {% endif %}

    </ul>

</nav>

</div>

Django如何在基于类的视图里使用分页？

上述案例里我们使用了函数试图，很容易定义page对象, 并传递给模板，例如articles。但是如果我们希望使用基于类的视图，我们该如何实现分页呢？其实操作非常简单。我们只需在视图中加入paginate_by = number即可。

from. models import Article

from django.views.generic import ListView

class ArticleListView(ListView):

    model = Article  # 等于 queryset = models.Article.objects.all()

    template_name = 'app/article_list.html'  # 可选的

    context_object_name = "article_list"    # 默认context名字

    paginate_by = 10  # 每页10项

此时模板article_list.html也需要做出相应调整，如下图所示。Django会先对是否分页is_paginated做个判断，如果有，就会自动生成个page_obj分页对象传递到模板。

{% if article_list %}

    {% for article in article_list %}

    {{ article.title }}

    {% endfor %}

    {% if is_paginated %}

    <ul class="pagination">

    {% if page_obj.has_previous %}

    <li>

        <span><a href="?page={{ page_obj.previous_page_number }}">Previous</a></span>

    </li>

    {% endif %}

    <li class="">

        <span>Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}.</span>

    </li>

    {% if page_obj.has_next %}

          <li>

        <span><a href="?page={{ page_obj.next_page_number }}">Next</a></span>

    </li>

    {% endif %}

    </ul>

{% else %}

    <h3>Articles</h3>

    <p>No article yet</p>

{% endif %}