Django的分頁器 paginator

時間 2019-11-06

原文原文鏈接

導入

from django.core.paginator import Paginator,EmptyPage,PageNotAnInteger

Page對象

Paginator.page()將返回一個Page對象，咱們主要的操做都是基於Page對象的，它具備下面的方法和屬性：css

方法：html

Page.has_next()[source]：若是有下一頁，則返回True。
Page.has_previous()[source]：若是有上一頁，返回 True。
Page.has_other_pages()[source]：若是有上一頁或下一頁，返回True。
Page.next_page_number()[source]：返回下一頁的頁碼。若是下一頁不存在，拋出InvalidPage異常。
Page.previous_page_number()[source]：返回上一頁的頁碼。若是上一頁不存在，拋出InvalidPage異常。

屬性:python

Page.object_list:當前頁上全部對象的列表。
Page.number:當前頁的序號，從1開始計數。
Page.paginator：當前Page對象所屬的Paginator對象。

Paginator對象

Paginator類擁有如下方法和屬性：django

方法：bootstrap

Paginator.page(number)[source]app

返回指定頁面的對象列表，好比第7頁的全部內容，下標以1開始。若是提供的頁碼不存在，拋出InvalidPage異常。oop

屬性：url

Paginator.count：全部頁面的對象總數。
Paginator.num_pages：頁面總數。
Paginator.page_range：基於1的頁數範圍迭代器。

處理異常

在實際使用中，可能惡意也可能不當心，用戶請求的頁面，可能千奇百怪。正常咱們但願是個合法的1，2，3之類，但請求的多是‘apple’，‘1000000’，‘#’，這就有可能致使異常，須要特別處理。Django爲咱們內置了下面幾個，Paginator相關異常。spa

exception InvalidPage[source]：異常的基類，當paginator傳入一個無效的頁碼時拋出。
exception PageNotAnInteger[source]：當向page()提供一個不是整數的值時拋出。
exception EmptyPage[source]：當向page()提供一個有效值，可是那個頁面上沒有任何對象時拋出。

使用

book.htmlcode

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>book</title>
    <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css"
    integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
</head>
<div class="container">

    <h4>分頁器</h4>
     <table class="table table-striped table-bordered">
                <thead>
                <tr>
                    <th>編號</th>
                    <th>書籍名稱</th>
                    <th>價格</th>
                    <th>出版日期</th>

                </tr>
                </thead>
                <tbody>

       {% for book in books %}
                    <tr>
                        <td>{{ forloop.counter }}</td>
                        <td id="book_title">{{ book.title }}</td>
                        <td id="book_price">{{ book.price }}</td>
                        <td id="book_publishDate">{{ book.publishDate|date:'Y-m-d' }}</td>


                    </tr>
                {% endfor %}

                </tbody>
     </table>


    <ul class="pagination" id="pager">
             <li><a href="?page=1" aria-label="Previous">
                <span aria-hidden="true">首頁</span>
               </a></li>

                 {% if books.has_previous %}
                    <li class="previous"><a href="?page={{ books.previous_page_number }}">上一頁</a></li>
                 {% else %}
                    <li class="previous disabled"><a href="#">上一頁</a></li>
                 {% endif %}


                 {% for num in paginator.page_range %}

                     {% if num == currentPage %}
                       <li class="item active"><a href="?page={{ num }}">{{ num }}</a></li>
                     {% else %}
                       <li class="item"><a href="?page={{ num }}">{{ num }}</a></li>

                     {% endif %}
                 {% endfor %}



                 {% if books.has_next %}
                    <li class="next"><a href="?page={{ books.next_page_number }}">下一頁</a></li>
                 {% else %}
                    <li class="next disabled"><a href="#">下一頁</a></li>
                 {% endif %}
             <li><a href="?page={{ paginator.num_pages }}" aria-label="Previous">
                <span aria-hidden="true">末頁</span>
                </a></li>

            </ul>
</div>



</body>

</html>

url.py

app_name = 'polls'
urlpatterns = [
    path('', views.IndexView.as_view(), name='index'),
    path('<int:pk>/', views.DetailView.as_view(), name='detail'),
    path('<int:pk>/results/', views.ResultsView.as_view(), name='results'),
    path('<int:question_id>/vote/', views.vote, name='vote'),
    path('listbook/', views.listBook, name='listbook'),
]

view.py

from .models import Book
from django.shortcuts import render
from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger

def listBook(request):
    '''
        批量導入數據:
     '''
    book_l = []
    # for i in range(30):
    #     book_l.append(Book(title="book" + str(i), price=20 + i * 2))
    # Book.objects.bulk_create(book_l)

    book_list = Book.objects.all().order_by('nid')
    # # 分頁器
    paginator = Paginator(book_list, 5)  # 每頁顯示5條

    # # print("count:", paginator.count)  # 數據總數
    # # print("num_pages", paginator.num_pages)  # 總頁數
    # # print("page_range", paginator.page_range)  # 頁碼的列表
    # #
    # # page1 = paginator.page(1)  # 第1頁的page對象
    # # for i in page1:  # 遍歷第1頁的全部數據對象
    # #     print(i)
    # #
    # # print(page1.object_list)  # 第1頁的全部數據
    # #
    # # page2 = paginator.page(2)
    # #
    # # print(page2.has_next())  # 是否有下一頁
    # # print(page2.next_page_number())  # 下一頁的頁碼
    # # print(page2.has_previous())  # 是否有上一頁
    # # print(page2.previous_page_number())  # 上一頁的頁碼
    page = request.GET.get('page', 1)
    currentPage = int(page)

    try:
        print(page)
        books = paginator.page(page)
        print(books)
    except PageNotAnInteger:
        # 若是請求的頁數不是整數，返回第一頁。
        books = paginator.page(1)
    except EmptyPage:
        # 若是請求的頁數不在合法的頁數範圍內，返回結果的最後一頁。
        books = paginator.page(paginator.num_pages)

    return render(request, 'polls/book.html', locals())

若是頁數比較多，能夠使用下一種方式

def listBook(request):
    '''
        批量導入數據:
     '''
    book_l = []
    # for i in range(30):
    #     book_l.append(Book(title="book" + str(i), price=20 + i * 2))
    # Book.objects.bulk_create(book_l)

    book_list = Book.objects.all().order_by('nid')
    # # 分頁器
    paginator = Paginator(book_list, 5)  # 每頁顯示5條

    # # print("count:", paginator.count)  # 數據總數
    # # print("num_pages", paginator.num_pages)  # 總頁數
    # # print("page_range", paginator.page_range)  # 頁碼的列表
    # #
    # # page1 = paginator.page(1)  # 第1頁的page對象
    # # for i in page1:  # 遍歷第1頁的全部數據對象
    # #     print(i)
    # #
    # # print(page1.object_list)  # 第1頁的全部數據
    # #
    # # page2 = paginator.page(2)
    # #
    # # print(page2.has_next())  # 是否有下一頁
    # # print(page2.next_page_number())  # 下一頁的頁碼
    # # print(page2.has_previous())  # 是否有上一頁
    # # print(page2.previous_page_number())  # 上一頁的頁碼
    page = request.GET.get('page', 1)
    currentPage = int(page)
    # 當頁數小於4頁時，只顯示4頁
    print('currentPage=',currentPage )
    if paginator.num_pages > 3:
        if currentPage - 3 < 1:
            pageRange = range(1, 5)
        elif currentPage + 3 > paginator.num_pages:
            pageRange = range(currentPage - 3, paginator.num_pages + 1)

        else:
            pageRange = range(currentPage - 3, currentPage + 3)

    else:
        pageRange = paginator.page_range
    try:
        print(page)
        books = paginator.page(page)
        print(books)
    except PageNotAnInteger:
        # 若是請求的頁數不是整數，返回第一頁。
        books = paginator.page(1)
    except EmptyPage:
        # 若是請求的頁數不在合法的頁數範圍內，返回結果的最後一頁。
        books = paginator.page(paginator.num_pages)

    return render(request, 'polls/book.html', locals())

html

<ul class="pagination" id="pager">
             <li><a href="?page=1" aria-label="Previous">
                <span aria-hidden="true">首頁</span>
               </a></li>

                 {% if books.has_previous %}
                    <li class="previous"><a href="?page={{ books.previous_page_number }}">上一頁</a></li>
                 {% else %}
                    <li class="previous disabled"><a href="#">上一頁</a></li>
                 {% endif %}

            {% for item in pageRange %}
                {% if currentPage == item %}
                    <li class="active"><a href="?page={{ item }}">{{ item }}</a></li>
                {% else %}
                    <li><a href="?page={{ item }}">{{ item }}</a></li>
                {% endif %}
            {% endfor %}



                 {% if books.has_next %}
                    <li class="next"><a href="?page={{ books.next_page_number }}">下一頁</a></li>
                 {% else %}
                    <li class="next disabled"><a href="#">下一頁</a></li>
                 {% endif %}
             <li><a href="?page={{ paginator.num_pages }}" aria-label="Previous">
                <span aria-hidden="true">末頁</span>
                </a></li>

            </ul>

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。