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 só vez, e mil não caberiam. A paginação divide uma lista em páginas com links entre elas. Uma ListView faz essa divisão com um único 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 primeiras 20, /recipes/?page=2 mostra as próximas 20, e uma página além do fim retorna 404. A lista do template contém apenas as linhas desta página, e o template também recebe is_paginated e page_obj, que representa a página atual.

É você quem escreve os links. page_obj conhece number, paginator.num_pages, has_next, next_page_number, has_previous e previous_page_number:

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

Mantenha a verificação em torno de cada link: na última página, next_page_number gera um erro que derruba a página.

Desafio

Fácil

Mostre 5 vagas por página:

Em JobListView, 5 linhas por página.
Em job_list.html, abaixo da lista, um <nav class="pages"> com um link Previous, o texto Page 1 of 3 (números reais) e um link Next. Cada link aparece somente quando a página correspondente existe.

Pressione Run, abra /jobs/ e pressione Next.

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