通過(guò) Django Pagination 實(shí)現(xiàn)簡(jiǎn)單分頁(yè)

# 對(duì) item_list 進(jìn)行分頁(yè)，每頁(yè)包含 2 個(gè)數(shù)據(jù)。 >>> item_list = ['john', 'paul', 'george', 'ringo'] >>> p = Paginator(item_list, 2)

取特定頁(yè)的數(shù)據(jù)：

# 取第 2 頁(yè)的數(shù)據(jù) >>> page2 = p.page(2) >>> page2.object_list
['george', 'ringo']

查詢特定頁(yè)的當(dāng)前頁(yè)碼數(shù)：

>>> page2.number 2 

查看分頁(yè)后的總頁(yè)數(shù)：

>>> p.num_pages 2 

查看某一頁(yè)是否還有上一頁(yè)，以及查詢?cè)擁?yè)上一頁(yè)的頁(yè)碼：

# 查詢第二頁(yè)是否還有上一頁(yè) >>> page2.has_previous() True # 查詢第二頁(yè)上一頁(yè)的頁(yè)碼 >>> page2.previous_page_number() 1

查看某一頁(yè)是否還有下一頁(yè)，以及查詢?cè)擁?yè)下一頁(yè)的頁(yè)碼：

# 查詢第二頁(yè)是否還有下一頁(yè) >>> page2.has_next() False # 查詢第二頁(yè)下一頁(yè)的頁(yè)碼 >>> page2.next_page_number() Traceback (most recent call last): ... EmptyPage: That page contains no results

更多方法和屬性請(qǐng)參閱 Django Pagination 的官方文檔^[5]。

用 Paginator 給文章列表分頁(yè)

使用上面的一些方法，我們可以實(shí)現(xiàn)一個(gè)類似于 Django 官方博客一樣的簡(jiǎn)單分頁(yè)效果，效果如下。

這里 Django 的官方文檔中給出了一個(gè)在視圖函數(shù)中對(duì)列表進(jìn)行分頁(yè)的示例，這個(gè)視圖函數(shù)獲取一個(gè)聯(lián)系人列表并對(duì)其分頁(yè)：

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger from django.shortcuts import render def listing(request):     contact_list = Contacts.objects.all()     paginator = Paginator(contact_list, 25) # 每頁(yè)顯示 25 個(gè)聯(lián)系人     page = request.GET.get('page')  try:         contacts = paginator.page(page)  except PageNotAnInteger:  # 如果用戶請(qǐng)求的頁(yè)碼號(hào)不是整數(shù)，顯示第一頁(yè)         contacts = paginator.page(1)  except EmptyPage:  # 如果用戶請(qǐng)求的頁(yè)碼號(hào)超過(guò)了最大頁(yè)碼號(hào)，顯示最后一頁(yè)         contacts = paginator.page(paginator.num_pages)  return render(request, 'list.html', {'contacts': contacts})

這就是在視圖函數(shù)中使用分頁(yè)的代碼邏輯，你可以把它當(dāng)做一個(gè)模板應(yīng)用于自己的任何需要分頁(yè)的視圖函數(shù)。不過(guò)在我們的博客項(xiàng)目中，我們不必寫這些代碼了。回顧在 Django 官方推薦的姿勢(shì)：類視圖^[6] 中的內(nèi)容，我們已將視圖函數(shù)轉(zhuǎn)換成了類視圖。而類視圖 ListView已經(jīng)幫我們寫好了上述的分頁(yè)邏輯，我們只需通過(guò)指定 paginate_by屬性來(lái)開(kāi)啟分頁(yè)功能即可，即在類視圖中指定 paginate_by屬性的值：

blog/views.py class IndexView(ListView): model = Post
    template_name = 'blog/index.html' context_object_name = 'post_list' # 指定 paginate_by 屬性后開(kāi)啟分頁(yè)功能，其值代表每一頁(yè)包含多少篇文章 paginate_by = 10 

templates/blog/index.html

{% if is_paginated %} <div class="pagination-simple">  {% if page_obj.has_previous %} <a href="?page={{ page_obj.previous_page_number }}">上一頁(yè)a> {% endif %}  <span class="current">第 {{ page_obj.number }} 頁(yè) / 共 {{ paginator.num_pages }} 頁(yè)span>  {% if page_obj.has_next %} <a href="?page={{ page_obj.next_page_number }}">下一頁(yè)a> {% endif %} div> {% endif %}