Paginação

Parte da seção Views baseadas em classes do Journey de Django da Coddy. Lição 8 de 18.

A página de vagas mostra todas as vagas de uma vez, e mil não caberiam nela. A paginação divide uma lista em páginas com links entre elas. Uma ListView faz essa divisão com um atributo, paginate_by, que define o número de linhas por página.

Com paginate_by = 20 em uma lista de receitas, /recipes/ mostra as 20 primeiras, /recipes/?page=2 mostra as 20 seguintes, e uma página além do final, ou uma página que não seja um número, recebe uma resposta 404. A lista do template contém apenas as linhas desta página, e o template também recebe is_paginated e page_obj, a página atual.

Os links ficam por sua conta, usando page_obj: number é o número desta página e paginator.num_pages é o total de páginas. has_next e has_previous são True quando há uma página depois ou antes desta, e next_page_number e previous_page_number fornecem o número dela:

{% if page_obj.has_next %}
  <a href="?page={{ page_obj.next_page_number }}">More recipes</a>
{% endif %}

Mantenha o teste em torno de cada link: na última página, next_page_number gera um erro que faz a página falhar.

Desafio

Fácil

Exiba 5 vagas por página.

Em jobs/views.py, configure JobListView para exibir 5 vagas por página.
Em job_list.html, abaixo da lista, adicione <nav class="pages"> com links que exibam exatamente Previous e Next, e entre eles Page 1 of 3 usando page_obj. Exiba cada link somente quando houver uma página correspondente; caso contrário, a página apresentará um erro.

Abra /jobs/ e pressione Next: você verá Page 2 of 3.

Experimente você mesmo

from django.views.generic import DetailView, ListView, TemplateView

from .models import Job


class HomeView(TemplateView):
    template_name = "jobs/home.html"

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context["count"] = Job.objects.count()
        context["latest"] = Job.objects.order_by("-posted").first()
        return context


class AboutView(TemplateView):
    template_name = "jobs/about.html"


class JobListView(ListView):
    model = Job
    context_object_name = "jobs"
    ordering = ["-posted"]

    def get_queryset(self):
        jobs = super().get_queryset()
        city = self.request.GET.get("city")
        if city:
            jobs = jobs.filter(city=city)
        return jobs


class JobDetailView(DetailView):
    model = Job