Pagination memecahkan set hasil yang besar kepada halaman berasingan, supaya anda tidak memuatkan beribu-ribu rekod sekali gus. Ia penting untuk prestasi dan kebolehgunaan. Django menyediakan kelas Paginator untuk template/view, dan DRF menawarkan pagination terbina dalam untuk API.
articles = Article.objects.()
from django.core.paginator import Paginator
def article_list(request):
articles = Article.objects.all().order_by("-created_at") # ORDER matters for consistent pages
paginator = Paginator(articles, 20) # 20 items per page
page_number = request.GET.get("page") # ?page=2
page_obj = paginator.get_page(page_number) # the requested page
return render(request, "list.html", {"page_obj": page_obj})
<!-- in the template -->
{% for article in page_obj %}
<h2>{{ article.title }}</h2>
{% endfor %}
{% if page_obj.has_previous %}<a href="?page={{ page_obj.previous_page_number }}">Prev</a>{% endif %}
Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}
{% if page_obj.has_next %}<a href="?page={{ page_obj.next_page_number }}">Next</a>{% endif %}
Paginator menghiris queryset kepada halaman dan get_page() mengembalikan objek halaman dengan pembantu navigasi (has_next, next_page_number, dll.) — ambil perhatian ia menambah LIMIT/OFFSET pada pertanyaan, jadi hanya satu halaman diambil daripada pangkalan data.
# global default in settings.py
REST_FRAMEWORK = {
"DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",
"PAGE_SIZE": 20,
}
# now list endpoints are automatically paginated, returning:
# { "count": 1000, "next": "...?page=3", "previous": "...?page=1", "results": [...] }
DRF melakukan pagination endpoint senarai secara automatik setelah dikonfigurasi, mengembalikan metadata halaman (count, pautan next/previous) bersama hasil — klien menavigasi melalui URL yang disediakan.
PageNumberPagination → ?page=2 (simple page numbers)
LimitOffsetPagination → ?limit=20&offset=40 (flexible offsets)
CursorPagination → opaque cursor; consistent & performant for large/changing data
(avoids OFFSET performance issues on huge datasets)
⚠️ OFFSET-based pagination (page/offset) gets SLOWER on deep pages of huge tables
(the DB must skip OFFSET rows). For very large datasets, CURSOR pagination
(keyset, using a WHERE on an indexed column) is far more efficient.
⚠️ Always ORDER BY a stable field, or pages can be inconsistent/repeat items.
Pagination adalah penting untuk membina aplikasi yang berprestasi dan boleh digunakan yang mengendalikan volum data sebenar — tanpanya, endpoint senarai dan halaman yang memuatkan keseluruhan jadual (berpotensi beribu atau berjuta baris) menjadi perlahan, intensif-memori, dan tidak boleh digunakan, membebankan pangkalan data sekali gus membebankan pengguna dan klien.
Memahami pagination ialah pengetahuan praktikal harian: Paginator Django mengendalikan view/template tradisional (menghiris queryset kepada halaman dengan pembantu navigasi, mengambil hanya satu halaman dengan cekap melalui LIMIT/OFFSET), dan pagination terbina dalam DRF mengendalikan API (melakukan pagination endpoint senarai secara automatik dengan metadata dan pautan navigasi setelah dikonfigurasi) — kedua-duanya diperlukan bergantung pada sama ada anda membina halaman yang dirender-pelayan atau API.
Mengetahui cara melaksanakan pagination dalam kedua-dua konteks adalah perlu untuk hampir mana-mana ciri penyenaraian data.
Nuansa prestasi ialah pengetahuan peringkat senior yang amat berharga: pagination berasaskan-OFFSET standard merosot pada halaman dalam jadual yang sangat besar (pangkalan data mesti melangkau semua baris terdahulu), jadi pagination kursor (keyset) ialah pilihan yang cekap untuk set data yang besar atau pantas berubah, dan sentiasa mengisih mengikut medan yang stabil adalah perlu untuk mengelakkan hasil yang tidak konsisten atau berulang merentasi halaman.
Memahami kedua-dua mekanik asas (Paginator, kelas pagination DRF) dan pertimbangan prestasi ini (OFFSET lawan pagination kursor, pengisihan yang konsisten) adalah penting untuk membina aplikasi yang kekal pantas dan betul apabila data berkembang — pagination ialah keperluan yang lazim, dan melakukannya dengan baik, terutamanya pada skala, ialah kemahiran praktikal yang secara langsung menjejaskan prestasi aplikasi dan pengalaman pengguna.