萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Django 內建 Paginator 分頁完整實作指南

Django django.core.paginator.Paginator 提供生產級分頁功能。本文含視圖邏輯、模板渲染、頁碼範圍控制、異常處理與核心 API 速查表。

視圖核心邏輯

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
from .models import Winlog

def index(request):
    after_range_num = 5   # 當前頁後顯示頁數
    before_range_num = 4  # 當前頁前顯示頁數

    try:
        page = int(request.GET.get('page', '1'))
        if page < 1: page = 1
    except ValueError:
        page = 1

    winlog_list = Winlog.objects.all().order_by('-id')
    paginator = Paginator(winlog_list, 10)  # 每頁 10 筆

    try:
        winloglist = paginator.page(page)
    except (EmptyPage, InvalidPage, PageNotAnInteger):
        winloglist = paginator.page(1)

    # 頁碼範圍切片,避免顯示過多頁碼
    if page >= after_range_num:
        page_range = paginator.page_range[page - after_range_num : page + before_range_num]
    else:
        page_range = paginator.page_range[0 : page + before_range_num]

    return render(request, 'log_dj/index.html', locals())

模板渲染 (Bootstrap 風格)

{% for winlog in winloglist.object_list %}
    {{ winlog.date }}|{{ winlog.time }}
{% endfor %} {% if winloglist.has_previous %} 上一頁 {% endif %} {% for p in page_range %} {% ifequal p winloglist.number %} {{ p }} {% else %} {{ p }} {% endifequal %} {% endfor %} {% if winloglist.has_next %} 下一頁 {% endif %}

Paginator / Page 核心 API 速查

物件屬性/方法說明
Paginatornum_pages總頁數
page_range頁碼 range (1-based)
page(number)回傳 Page 物件,異常拋 InvalidPage
Pageobject_list當前頁物件列表
number當前頁碼
has_next/has_previous是否有下/上一頁
next_page_number()下一頁碼 (無視是否存在)
start_index/end_index當前頁首/尾項在全域的 1-based 索引
paginator關聯的 Paginator 實例

常見異常處理

  • PageNotAnInteger:page 參數非整數 → 導向第 1 頁。
  • EmptyPage:頁碼超出範圍 → 導向第 1 頁或最後一頁。
  • InvalidPage:基底類別,捕獲上述兩者。

效能提示

  • 大資料集使用 .only('id', 'title') 或 .defer('content') 減少欄位載入。
  • 配合 select_related/prefetch_related 避免 N+1 查詢。
  • 極大資料表考慮 keyset pagination (游標分頁) 替代 OFFSET/LIMIT。
copyright © 萬盛學電腦網 all rights reserved