通過(guò) Django Pagination 實(shí)現(xiàn)簡(jiǎn)單分頁(yè)功能
文中所涉及的示例代碼,已同步更新到 HelloGitHub-Team 倉(cāng)庫(kù)
當(dāng)博客上發(fā)布的文章越來(lái)越多時(shí),通常需要進(jìn)行分頁(yè)顯示,以免所有的文章都堆積在一個(gè)頁(yè)面,影響用戶(hù)體驗(yàn)。
Django 內(nèi)置的 Pagination 能夠幫助我們實(shí)現(xiàn)簡(jiǎn)單的分頁(yè)功能,在上一篇教程中我們使用腳本批量生成了幾百篇博客文章,正好用于測(cè)試分頁(yè)效果。
Paginator 類(lèi)的常用方法
分頁(yè)功能由 Django 內(nèi)置的 Paginator
類(lèi)提供,這個(gè)類(lèi)位于 django.core.paginator
模塊,需要使用它時(shí),只需在適當(dāng)?shù)牡胤綄?dǎo)入這個(gè)類(lèi)即可:
from django.core.paginator import Paginator
下面的代碼摘自 Django 的官方文檔中 Pagination 的示例,只需實(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)
取特定頁(yè)的數(shù)據(jù):
# 取第 2 頁(yè)的數(shù)據(jù) >>> page2 = p.page(2) >>> page2.object_list ['george', 'ringo']
查詢(xún)特定頁(yè)的當(dāng)前頁(yè)碼數(shù):
>>> page2.number
2
查看分頁(yè)后的總頁(yè)數(shù):
>>> p.num_pages
2
查看某一頁(yè)是否還有上一頁(yè),以及查詢(xún)?cè)擁?yè)上一頁(yè)的頁(yè)碼:
# 查詢(xún)第二頁(yè)是否還有上一頁(yè) >>> page2.has_previous() True # 查詢(xún)第二頁(yè)上一頁(yè)的頁(yè)碼 >>> page2.previous_page_number() 1
查看某一頁(yè)是否還有下一頁(yè),以及查詢(xún)?cè)擁?yè)下一頁(yè)的頁(yè)碼:
# 查詢(xún)第二頁(yè)是否還有下一頁(yè) >>> page2.has_next() False # 查詢(xún)第二頁(yè)下一頁(yè)的頁(yè)碼 >>> page2.next_page_number() Traceback (most recent call last): ... EmptyPage: That page contains no results
更多方法和屬性請(qǐng)參閱 Django Pagination 的官方文檔。
用 Paginator 給文章列表分頁(yè)
使用上面的一些方法,我們可以實(shí)現(xiàn)一個(gè)類(lèi)似于 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: # 如果用戶(hù)請(qǐng)求的頁(yè)碼號(hào)不是整數(shù),顯示第一頁(yè) contacts = paginator.page(1) except EmptyPage: # 如果用戶(hù)請(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)目中,我們不必寫(xiě)這些代碼了?;仡櫾?Django 官方推薦的姿勢(shì):類(lèi)視圖 中的內(nèi)容,我們已將視圖函數(shù)轉(zhuǎn)換成了類(lèi)視圖。而類(lèi)視圖 ListView
已經(jīng)幫我們寫(xiě)好了上述的分頁(yè)邏輯,我們只需通過(guò)指定 paginate_by
屬性來(lái)開(kāi)啟分頁(yè)功能即可,即在類(lèi)視圖中指定 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
這里我們?cè)O(shè)置了每 10 篇文章一頁(yè)。
在模板中設(shè)置分頁(yè)導(dǎo)航
接下來(lái)便是在模板中設(shè)置分頁(yè)導(dǎo)航,比如上一頁(yè)、下一頁(yè)的按鈕,以及顯示一些頁(yè)面信息。我們這里設(shè)置和 Django 官方博客那樣的分頁(yè)導(dǎo)航樣式(具體的樣式見(jiàn)上圖)。ListView
傳遞了以下和分頁(yè)有關(guān)的模板變量供我們?cè)谀0逯惺褂茫?/p>
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 %}
其中 {{ }}
模板變量中的內(nèi)容,其含義已在文章開(kāi)頭部分的 Paginator 類(lèi)的常用方法中已有介紹。另外還要注意一點(diǎn),請(qǐng)求哪一個(gè)頁(yè)面通過(guò) page
查詢(xún)參數(shù)傳遞給 django 視圖,django 會(huì)根據(jù) page
的值返回對(duì)應(yīng)頁(yè)面的文章列表,所以上一頁(yè)和下一頁(yè)超鏈接的 href 屬性指向的 url 帶上了 page 查詢(xún)參數(shù)。
最終我們得到如下的分頁(yè)效果:
當(dāng)然這只是一個(gè)簡(jiǎn)單示例,分頁(yè)導(dǎo)航處的視覺(jué)效果并不是很好看,你可以自行為其添加 CSS 樣式使其看上去更加美觀。
進(jìn)一步拓展
使用 Django 內(nèi)置的 Pagination 只能實(shí)現(xiàn)上面的簡(jiǎn)單分頁(yè)效果,但通常更加高級(jí)的分頁(yè)效果應(yīng)該像下圖這樣:
當(dāng)前頁(yè)面高亮顯示,且顯示當(dāng)前頁(yè)面前后幾頁(yè)的頁(yè)碼,始終顯示第一頁(yè)和最后一頁(yè)的頁(yè)碼,中間可能還有省略號(hào)的效果,表示還有未顯示的頁(yè)碼。
僅僅使用 Django Pagination 內(nèi)置的方法無(wú)法實(shí)現(xiàn)這樣的效果,需要自己寫(xiě)分頁(yè)邏輯或者借助第三方庫(kù)。接下來(lái)我們將詳細(xì)說(shuō)明如何借助第三方庫(kù)拓展 Pagination 以實(shí)現(xiàn)一個(gè)完善的分頁(yè)效果。
總結(jié)
以上所述是小編給大家介紹的通過(guò) Django Pagination 實(shí)現(xiàn)簡(jiǎn)單分頁(yè)功能,希望對(duì)大家有所幫助,如果大家有任何疑問(wèn)請(qǐng)給我留言,小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)腳本之家網(wǎng)站的支持!
如果你覺(jué)得本文對(duì)你有幫助,歡迎轉(zhuǎn)載,煩請(qǐng)注明出處,謝謝!
相關(guān)文章
圖文詳解牛頓迭代算法原理及Python實(shí)現(xiàn)
牛頓迭代法又稱(chēng)為牛頓-拉夫遜(拉弗森)方法,它是牛頓在17世紀(jì)提出的一種在實(shí)數(shù)域和復(fù)數(shù)域上近似求解方程的方法。本文將利用圖文詳解牛頓迭代算法原理及實(shí)現(xiàn),需要的可以參考一下2022-08-08詳解TensorFlow2實(shí)現(xiàn)前向傳播
這篇文章主要介紹了TensorFlow2如何實(shí)現(xiàn)前向傳播,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2021-09-09Python 對(duì)輸入的數(shù)字進(jìn)行排序的方法
今天小編就為大家分享一篇Python 對(duì)輸入的數(shù)字進(jìn)行排序的方法,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2018-06-06python 實(shí)現(xiàn)將小圖片放到另一個(gè)較大的白色或黑色背景圖片中
今天小編就為大家分享一篇python 實(shí)現(xiàn)將小圖片放到另一個(gè)較大的白色或黑色背景圖片中,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2019-12-12python的pytest框架之命令行參數(shù)詳解(下)
這篇文章主要介紹了python的pytest框架之命令行參數(shù)詳解,今天將繼續(xù)更新其他一些命令選項(xiàng)的使用,和pytest收集測(cè)試用例的規(guī)則,需要的朋友可以參考下2019-06-06