文章目錄

• • 0.思路引導(dǎo)
  • 1.Paginator 類的常用方法
  • 2.用 Paginator 給文章列表分頁(yè)
  • 3.在模板中設(shè)置分頁(yè)導(dǎo)航
  • 4.效果展示

0.思路引導(dǎo)

1）當(dāng)博客上發(fā)布的文章越來(lái)越多時(shí)，通常需要進(jìn)行分頁(yè)顯示，以免所有的文章都堆積在一個(gè)頁(yè)面，影響用戶體驗(yàn)。

2）Django 內(nèi)置的 Pagination 能夠幫助我們實(shí)現(xiàn)簡(jiǎn)單的分頁(yè)功能

1.Paginator 類的常用方法

分頁(yè)功能由 Django 內(nèi)置的 Paginator 類提供，這個(gè)類位于 django.core.paginator 模塊，需要使用它時(shí)，只需在適當(dāng)?shù)牡胤綄?dǎo)入即可：

from django.core.paginator import Paginator

使用時(shí)需實(shí)例化一個(gè) Paginator 對(duì)象，并在實(shí)例化時(shí)傳入一個(gè)需要分頁(yè)的列表對(duì)象，就可以得到分頁(yè)后的對(duì)象。

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

具體的使用請(qǐng)查看官方文檔

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

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

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger from django.shortcuts import renderdef 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)目中，我們已將視圖函數(shù)轉(zhuǎn)換成了類視圖。而類視圖 ListView 已經(jīng)幫我們寫好了上述的分頁(yè)邏輯，我們只需通過(guò)指定 paginate_by 屬性來(lái)開啟分頁(yè)功能即可，即在類視圖中指定 paginate_by 屬性的值：

文件位置：blog/views.py

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

這里我們?cè)O(shè)置了每 10 篇文章一頁(yè)。

3.在模板中設(shè)置分頁(yè)導(dǎo)航

接下來(lái)便是在模板中設(shè)置分頁(yè)導(dǎo)航，比如上一頁(yè)、下一頁(yè)的按鈕，以及顯示一些頁(yè)面信息。

ListView 傳遞了以下和分頁(yè)有關(guān)的模板變量供我們?cè)谀０逯惺褂?#xff1a;

• paginator ，即 Paginator 的實(shí)例。
• page_obj ，當(dāng)前請(qǐng)求頁(yè)面分頁(yè)對(duì)象。
• is_paginated，是否已分頁(yè)。只有當(dāng)分頁(yè)后頁(yè)面超過(guò)兩頁(yè)時(shí)才算已分頁(yè)。
• object_list，請(qǐng)求頁(yè)面的對(duì)象列表，和 post_list 等價(jià)。所以在模板中循環(huán)文章列表時(shí)可以選 post_list ，也可以選
  object_list。

文件位置：templates/blog/index.html

{% if is_paginated %} <div class="pagination-simple"><!-- 如果當(dāng)前頁(yè)還有上一頁(yè)，顯示一個(gè)上一頁(yè)的按鈕 -->{% if page_obj.has_previous %}<a href="?page={{ page_obj.previous_page_number }}">上一頁(yè)</a>{% endif %}<!-- 顯示當(dāng)前頁(yè)面信息 --><span class="current">第 {{ page_obj.number }} 頁(yè) / 共 {{ paginator.num_pages }} 頁(yè)</span><!-- 如果當(dāng)前頁(yè)還有下一頁(yè)，顯示一個(gè)下一頁(yè)的按鈕 -->{% if page_obj.has_next %}<a href="?page={{ page_obj.next_page_number }}">下一頁(yè)</a>{% endif %} </div> {% endif %}

另外需要注意的是，請(qǐng)求目的頁(yè)，是通過(guò) page 查詢參數(shù)傳遞給 django 視圖，django 會(huì)根據(jù) page 的值返回對(duì)應(yīng)頁(yè)面的文章列表，所以上一頁(yè)和下一頁(yè)超鏈接的 href 屬性指向的 url 帶上了 page 查詢參數(shù)。

4.效果展示

總結(jié)

以上是生活随笔為你收集整理的Diango博客--15.通过 Django Pagination 实现简单分页（一）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。