1. 程式人生 > 其它 >Django分頁器(paginator)元件

Django分頁器(paginator)元件

from django.core.paginator import Paginator

book_list = ['python', 'java', 'c++', 'golang', 'c#', 'javascript', 'php']
# 先拿到分頁器物件,第一個引數:物件列表,第二個引數:每頁顯示的條數
paginator = Paginator(book_list,3)  

# 總條數:也就是book_list元素的個數,7
paginator.count 
# 總頁數:book_list有7個元素,每頁顯示3個,那麼會被分成3頁
paginator.num_pages  
# 頁碼數列表:也就是range(1, 4)
paginator.page_range # 取某一頁,返回一個物件,也是一個迭代器 current_page = paginator.page(2) # 某一頁裡所有資料,這裡就是弟2頁所有資料,返回的是個列表 current_page.object_list # 是否有下一頁 current_page.has_next() # 是否有上一頁 current_page.has_previous() # 下一頁的頁碼數 current_page.next_page_number() # 上一頁的頁碼數 current_page,previous_page_number()
# 當前頁的頁數 current_page.number #通過當前頁拿到Paginator例項化的物件 current_page.paginator.count

Django是一個大而全的框架。需要明確的是,傳參進行分頁獲取分頁後的資料,一般都是通過向伺服器傳送get請求的方式實現的,在向後端服務傳送檢視資料的同時可以攜帶一個或多個引數併發送get請求來實現分頁檢視功能 前面總結過drf框架中分頁器的使用,本文主要介紹在利用Django開發MVT模型專案時分頁器的使用

1、準備基礎資料

設計表模型

為了體現分頁的效果,需要先建立一個表並準備較多資料,模型如下

from django.db import
models # Create your models here. class Book(models.Model): title = models.CharField(max_length=32) price = models.DecimalField(max_digits=9, decimal_places=2) # 9999999.99

執行資料庫遷移後,設計一個檢視函式,通過觸發檢視函式往此表中批量插入資料

Django中利用orm實現批量插入一般有兩種方式:單條插入或者利用bulk_create批量插入

最終翻譯轉換成sql語句也就類似於多條insert語句和一條insert的區別

def create_book(request):

    # 批量插入方式一
    for i in range(100):
        Book.objects.create(title="book"+str(i),price=i*i)
        # 批量插入方式二
    book_list = []
    for i in range(100):
        book = Book(title="book"+str(i),price=i*i)
        book_list.append(book)
    Book.objects.bulk_create(book_list)
    
    return HttpResponse("新增成功")

模板頁面index.html如下

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<ul>
    {% for book in book_list %}
    <li>{{ book.title }} : {{ book.price }}</li>
    {% endfor %}
</ul>
</body>
</html>

這時一次性訪問即展示了所有的book

3、引入分頁器

引入分頁器後,可以對全域性分頁物件和單頁物件進行相關操作,相關語法

# 引入分頁器
from django.core.paginator import Paginator

        ...
    # 全域性分頁器物件
    paginator = Paginator([1,2,3,4,5,6,7,8,9,10],3)
    print(paginator.count) # 10  資料總數
    print(paginator.num_pages)  # 4  總頁數
    print(paginator.page_range) # range(1, 5)  頁碼的列表

    # 單頁物件
    page = paginator.page(2)
    print(page.has_next())  # 是否有下一頁
    print(page.next_page_number())  # 寫一頁的頁碼
    print(page.has_previous())  # 是否有上一頁
    print(page.previous_page_number())  # 上一頁的頁碼
    # 取出單頁物件的值
    print(page.object_list) # [4, 5, 6]
    for i in page:
       print(i)

在這裡的例子中具體使用分頁器及模板語法,例如每頁取出8條,獲取使用者給出的頁碼條件數,返回相應頁的資料,預設不給出任何條件時返回第一頁的資料

from django.core.paginator import Paginator
   # 取出當前使用者頁碼
   current_num = int(request.GET.get("page", 1))
   book_list = Book.objects.all()
   paginator = Paginator(book_list, 8)
   page = paginator.page(current_num)
  
   return render(request,"index.html",{"page":page})

最後,可以利用bootstrap元件在頁面模板中新增翻頁的按鈕,在當前頁時按鈕加深,沒有上一頁時禁止點選

...
<body>

<ul>
    {% for book in page %}
    <li>{{ book.title }} : {{ book.price }}</li>
    {% endfor %}
</ul>
<nav aria-label="Page navigation">
  <ul class="pagination">
    {% if page.has_previous %}
    <li>
      <a href="/?page={{ page.previous_page_number }}" aria-label="Previous">
        <span aria-hidden="true">上一頁</span>
      </a>
    </li>
    {% else %}
    <li class="disabled">
      <a href="#" aria-label="Previous">
        <span aria-hidden="true">上一頁</span>
      </a>
    </li>
    {% endif %}
      {% for num in page_range %}
      {% if num == current_num %}
          <li class="active"><a href="/?page={{ num }}">{{ num }}</a></li>
      {% else %}
          <li><a href="/?page={{ num }}">{{ num }}</a></li>
      {% endif %}
      {% endfor %}
    <li>
      <a href="#" aria-label="Next">
        <span aria-hidden="true">下一頁</span>
      </a>
    </li>
  </ul>
</nav>
</body>
...

在檢視函式中:處理相關異常;傳遞相關引數;當頁碼較多時只顯示部分頁碼,例如最多時總共10個頁碼,當前頁碼始終在中間顯示;單獨處理出現邊界情況,負數頁碼的情況及最大頁碼用完的情況

from django.core.paginator import Paginator
        ...
    # 取出當前使用者頁碼
    current_num = int(request.GET.get("page", 1))
    book_list = Book.objects.all()
    paginator = Paginator(book_list, 8)
    page = paginator.page(current_num)

    # 大於11頁時
    if paginator.num_pages > 11:
        # 當前頁碼的後5頁數超過最大頁碼時,顯示最後10項
        if current_num + 5 > paginator.num_pages:
            page_range = range(paginator.num_pages - 10, paginator.num_pages + 1)
        # 當前頁碼的前5頁數為負數時,顯示開始的10項
        elif current_num - 5 < 1:
            page_range = range(1, 12)
        else:
            # 顯示左5頁到右5頁的頁碼
            page_range = range(current_num - 5, current_num + 5 + 1)
    # 小於11頁時顯示所有頁碼
    else:
        page_range = paginator.page_range

    return render(request, "index.html", {"page": page, "paginator": paginator, "current_num": current_num, "page_range": page_range})