django 分頁

  有的時候我們會在頁面中展示大量數據，全部都放在一頁可能會降低用戶體驗，Django提供了一個Paginator類來幫助我們管理分頁數據。

起步
介紹分頁器對象的一些屬性和方法

1. 引入該類及相關異常模塊：
from django.core.paginator import Paginator, PageNotAnInteger, EmptyPage
1
Paginator：分頁器對象
PageNotAnInteger：頁碼不是一個整數時引發該異常
EmptyPage：頁碼不在有效范圍時（即數據為空）引發該異常
2. 分頁器對象
分頁器對象的屬性：

object_list， 對象列表即查詢到的數據
per_page， 每一頁展示的內容
orphans=0， 這是一個缺省參數，如果最后一頁的數據小於這個值，會合並到上一頁
allow_empty_first_page=True， 允許首頁為空 ，默認為True
分頁器對象的方法：

方法 描述
page 返回一個Page對象
count 返回對象列表（數據）的長度
num_pages 返回總頁數
page_range 返回頁碼列表
3. Page對象
Page對象是一般用來指定當前頁
Page對象的屬性，

object_list：同樣是指對象列表，不過只包含當前頁的對象
number：當前頁面的頁碼
paginator ：指對應的分頁器對象（Paginator ）
注意，Paginator對象是由我們進行實例化的，而Page對象在Paginator對象使用page方法時實現

Page對象的方法：

方法 描述
has_next 是否有下一頁
has_previous 是否有上一頁
has_other_pages 是否有上一頁或下一頁
next_page_number 返回下一頁的頁碼
previous_page_number 返回上一頁的頁碼
start_index 返回當前頁起始的對象序號
end_index 返回當前頁結束的對象序號
應用
  介紹完Paginator對象，已經基本可以親自動手實現一個分頁器對象了，但暫時我們不需要那樣做。接下來，來應用該分頁器對象，我已經封裝好了一個函數來使用它。

def split_page(object_list, request, per_page=8):
    paginator = Paginator(object_list, per_page)
    # 取出當前需要展示的頁碼, 默認為1
    page_num = request.GET.get('page', default='1')
    # 根據頁碼從分頁器中取出對應頁的數據
    try:
        page = paginator.page(page_num)
    except PageNotAnInteger as e:
        # 不是整數返回第一頁數據
        page = paginator.page('1')
        page_num = 1
    except EmptyPage as e:
        # 當參數頁碼大於或小於頁碼范圍時,會觸發該異常
        print('EmptyPage:{}'.format(e))
        if int(page_num) > paginator.num_pages:
            # 大於 獲取最后一頁數據返回
            page = paginator.page(paginator.num_pages)
        else:
            # 小於 獲取第一頁
            page = paginator.page(1)

    # 這部分是為了再有大量數據時，仍然保證所顯示的頁碼數量不超過10，
    page_num = int(page_num)
    if page_num < 6:
        if paginator.num_pages <= 10:
            dis_range = range(1, paginator.num_pages + 1)
        else:
            dis_range = range(1, 11)
    elif (page_num >= 6) and (page_num <= paginator.num_pages - 5):
        dis_range = range(page_num - 5, page_num + 5)
    else:
        dis_range = range(paginator.num_pages - 9, paginator.num_pages + 1)

    data = {'page': page, 'paginator': paginator, 'dis_range ': dis_range }
    return data

 

<div class="container">
    <nav aria-label="Page navigation">
      <ul class="pagination">

        <!--上一頁-->
        <li class="{% if not page.has_previous %}disabled{% endif %}">
          {% if page.has_previous %}
            <a href="{% url 'index' %}?page={{ page.previous_page_number }}" aria-label="Previous">
          {% endif %}
            <span aria-hidden="true">&laquo;</span>
          </a>
        </li>

        <!--頁碼-->
        <!--這里展示頁碼使用傳遞過來的dis_range -->
        {% for num in dis_range %}
        <li class="{% if num == page.number %}active{% else %}{% endif %}" >
          <a href="{% url 'index' %}?page={{ num }}">{{ num }}</a>
        </li>
        {% endfor %}

        <!--下一頁-->  
        <li class="{% if not page.has_next %}disabled{% endif %}">
          {% if page.has_next %}
            <a href="{% url 'index' %}?page={{ page.next_page_number }}" aria-label="Next">
          {% endif %}
            <span aria-hidden="true">&raquo;</span>
          </a>
        </li>

      </ul>
    </nav>
  </div>

  

使用了bootstrap中的基本分頁，展示效果如下圖所示：

對應模板代碼：