Paginación

Parte de la sección Vistas basadas en clases del Journey de Django de Coddy. Lección 8 de 18.

La página de empleos muestra todos los empleos a la vez, y no cabrían mil. La paginación divide una lista en páginas con enlaces entre ellas. Una ListView hace la división con un atributo, paginate_by, que indica las filas por página.

Con paginate_by = 20 en una lista de recetas, /recipes/ muestra las primeras 20, /recipes/?page=2 las 20 siguientes, y una página posterior al final, o una que no sea un número, recibe una respuesta 404. La lista de la plantilla contiene solo las filas de esta página, y la plantilla también recibe is_paginated y page_obj, la página actual.

Te toca escribir los enlaces a partir de page_obj: number es esta página y paginator.num_pages es el número de páginas. has_next y has_previous son True cuando hay una página después o antes de esta, y next_page_number y previous_page_number indican su número:

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

Mantén la comprobación alrededor de cada enlace: en la última página, next_page_number provoca un error que hace que la página se cierre.

Desafío

Fácil

Muestra 5 empleos por página.

En jobs/views.py, haz que JobListView muestre 5 empleos por página.
En job_list.html, debajo de la lista, añade <nav class="pages"> con enlaces cuyo texto sea exactamente Previous y Next, y entre ellos Page 1 of 3 de page_obj. Muestra cada enlace solo cuando exista su página; de lo contrario, la página falla.

Abre /jobs/ y pulsa Next: verás Page 2 of 3.

Pruébalo tú mismo

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