Django provides high-level and low-level ways to help you manage paginated data\n– that is, data that’s split across several pages, with „Previous/Next” links.
\nPaginator classLink to this heading#Under the hood, all methods of pagination use the\nPaginator class. It does all the heavy lifting\nof actually splitting a QuerySet into Page\nobjects.
Give Paginator a list of objects, plus the\nnumber of items you’d like to have on each page, and it gives you methods for\naccessing the items for each page:
>>> from django.core.paginator import Paginator\n>>> objects = ['john', 'paul', 'george', 'ringo']\n>>> p = Paginator(objects, 2)\n\n>>> p.count\n4\n>>> p.num_pages\n2\n>>> type(p.page_range)\n<class 'range_iterator'>\n>>> p.page_range\nrange(1, 3)\n\n>>> page1 = p.page(1)\n>>> page1\n<Page 1 of 2>\n>>> page1.object_list\n['john', 'paul']\n\n>>> page2 = p.page(2)\n>>> page2.object_list\n['george', 'ringo']\n>>> page2.has_next()\nFalse\n>>> page2.has_previous()\nTrue\n>>> page2.has_other_pages()\nTrue\n>>> page2.next_page_number()\nTraceback (most recent call last):\n...\nEmptyPage: That page contains no results\n>>> page2.previous_page_number()\n1\n>>> page2.start_index() # The 1-based index of the first item on this page\n3\n>>> page2.end_index() # The 1-based index of the last item on this page\n4\n\n>>> p.page(0)\nTraceback (most recent call last):\n...\nEmptyPage: That page number is less than 1\n>>> p.page(3)\nTraceback (most recent call last):\n...\nEmptyPage: That page contains no results\nListViewLink to this heading#django.views.generic.list.ListView provides a builtin way to paginate\nthe displayed list. You can do this by adding a\npaginate_by attribute to\nyour view class, for example:
from django.views.generic import ListView\n\nfrom myapp.models import Contact\n\nclass ContactList(ListView):\n paginate_by = 2\n model = Contact\nThis limits the number of objects per page and adds a paginator and\npage_obj to the context. To allow your users to navigate between pages,\nadd links to the next and previous page, in your template like this:
{% for contact in page_obj %}\n {# Each "contact" is a Contact model object. #}\n {{ contact.full_name|upper }}<br>\n ...\n{% endfor %}\n\n<div class="pagination">\n <span class="step-links">\n {% if page_obj.has_previous %}\n <a href="?page=1">« first</a>\n <a href="?page={{ page_obj.previous_page_number }}">previous</a>\n {% endif %}\n\n <span class="current">\n Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}.\n </span>\n\n {% if page_obj.has_next %}\n <a href="?page={{ page_obj.next_page_number }}">next</a>\n <a href="?page={{ page_obj.paginator.num_pages }}">last »</a>\n {% endif %}\n </span>\n</div>\nPaginator in a view functionLink to this heading#Here’s an example using Paginator in a view\nfunction to paginate a queryset:
from django.core.paginator import Paginator\nfrom django.shortcuts import render\n\nfrom myapp.models import Contact\n\ndef listing(request):\n contact_list = Contact.objects.all()\n paginator = Paginator(contact_list, 25) # Show 25 contacts per page.\n\n page_number = request.GET.get('page')\n page_obj = paginator.get_page(page_number)\n return render(request, 'list.html', {'page_obj': page_obj})\nIn the template list.html, you can include navigation between pages in\nthe same way as in the template for the ListView above.