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>