Django Academy · Урок

Класс Paginator

Разбивайте набор запросов на страницы

«Класс Paginator» — бесплатный урок Django Academy на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Django Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Django Academy содержит 4 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

Why Paginate?

Showing 5,000 rows on one page is slow and overwhelming. Pagination splits a long list into bite-sized pages your users can browse. 📄

Meet the Paginator

Django ships a Paginator class that does the math for you. You hand it a list and a page size, and it carves the data into pages.

from django.core.paginator import Paginator

Create a Paginator

Pass your full queryset and how many items per page. Here every page holds 10 articles.

articles = Article.objects.all()
paginator = Paginator(articles, 10)

Counting the Pages

Ask the paginator how many pages exist with num_pages. It rounds up, so 25 items at 10 per page gives 3 pages.

paginator.num_pages  # 3

Grab One Page

Call get_page() with a page number to fetch a single slice. It returns a Page object holding just those items.

page = paginator.get_page(2)

Looping Over a Page

A Page is iterable, so you loop it like a list. You only ever touch the items on that one page, never all 5,000.

for article in page:
    print(article.title)

get_page Is Forgiving

If someone passes page 999 or the word "abc", get_page() quietly returns the last or first valid page instead of crashing.

Knowing Where You Are

The page knows its own spot. Read number for the current page, handy for highlighting it in your navigation bar.

page.number  # 2

Next and Previous

Use has_next() and has_previous() to decide whether to show the next or back link in your template.

page.has_next()
page.has_previous()

The Neighboring Pages

Once you know there is a next page, next_page_number() gives you the number to link to. previous_page_number() does the same backward.

page.next_page_number()  # 3

Wiring It Into a View

In a view, read the requested page from the query string, then pass the page to your template context.

num = request.GET.get('page')
page = paginator.get_page(num)

Quick Check

You have 23 items and a page size of 10. Let's test the math.

Recap

You met the Paginator: feed it a queryset and a page size, fetch slices with get_page(), and read num_pages, number, and has_next() to build navigation. 🎉

Часто задаваемые вопросы

Урок «Класс Paginator» бесплатный?

Да — полный текст урока «Класс Paginator» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Django Academy, подпишись на CoddyKit PRO. Курс Django Academy содержит 4 уроков всего.

Чему я научусь в уроке «Класс Paginator»?

Разбивайте набор запросов на страницы Ты практикуешь Django Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Django Academy?

Предыдущий опыт не требуется. Django Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.

Сколько времени занимает урок «Класс Paginator»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Django Academy?

Да. Каждый урок Django Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Django Academy