تقسيم الصفحات

جزء من قسم واجهات العرض المعتمدة على الأصناف في رحلة Django على Coddy. الدرس 8 من 18.

تعرض صفحة الوظائف كل وظيفة دفعة واحدة، ولن تتسع لألف وظيفة. يقسّم تقسيم الصفحات القائمة إلى صفحات تتوسطها روابط. يتولى ListView التقسيم باستخدام سمة واحدة، هي paginate_by، التي تحدد عدد الصفوف في كل صفحة.

عند ضبط paginate_by = 20 في قائمة الوصفات، تعرض /recipes/ أول 20 وصفة، وتعرض /recipes/?page=2 العشرين التالية، أما الصفحة التي تتجاوز النهاية فتُرجع 404. لا تحتوي قائمة القالب إلا على صفوف هذه الصفحة، ويحصل القالب أيضًا على is_paginated وpage_obj، أي الصفحة الحالية.

أنت من يكتب الروابط. يعرف page_obj القيم number وpaginator.num_pages وhas_next وnext_page_number وhas_previous وprevious_page_number:

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

أبقِ الاختبار حول كل رابط: ففي الصفحة الأخيرة، يؤدي next_page_number إلى خطأ يتسبب في تعطّل الصفحة.

التحدي

سهل

اعرض الوظائف بواقع 5 في كل صفحة:

في JobListView، اعرض 5 صفوف في كل صفحة.
في job_list.html، أسفل القائمة، أضف <nav class="pages"> يتضمن رابط Previous، والنص Page 1 of 3 (بالأرقام الفعلية)، ورابط Next. لا يظهر كل رابط إلا عند وجود الصفحة المقابلة له.

اضغط على تشغيل، وافتح /jobs/، ثم اضغط على التالي.

جرّب بنفسك

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