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())
{% 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 | num_pages | 總頁數 |
page_range | 頁碼 range (1-based) | |
page(number) | 回傳 Page 物件,異常拋 InvalidPage | |
| Page | object_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 查詢。