Django分頁

時間 2019-12-08

標籤 django 分頁欄目 Python 简体版

原文原文鏈接

分頁:

Paginator 類對象的屬性:

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
          
         
         
         
         
          
           
           
          num_pages: 返回分頁以後的總頁數 
          
          
          page_range: 返回分頁後頁碼的列表

Paginator 類對象的方法:

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
          
         
         
         
         
          
           
           
          page(self, number): 返回第 number 頁的 Page 類實例對象

Page 類對象的屬性:

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
          
         
         
         
         
          
           
           
          number: 返回當前頁的頁碼 
          
          
          object_list: 返回包含當前頁的數據的查詢集 
          
          
          paginator: 返回對應得 Paginator 類對象

Page 類對象的方法:

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
          
         
         
         
         
          
           
           
          has_previous: 判斷當前頁是否有前一頁 
          
          
          has_next: 判斷當前頁是否有下一頁 
          
          
          previous_page_number: 返回前一頁的頁碼 
          
         next_page_number: 返回下一頁的頁碼

實例:

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
         
         
         
          
           
           
          from django.conf.urls import url 
          
          
          urlpatterns = [ 
          
             url(r'^show_area(?P<pindex>\d+))', views.show_area) 
         ]

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
          
         
         
         
         
          
           
           
          def show_area(request, pindex): 
          
          
           # 1. 查詢處全部省級地區的信息 
          
          
              areas = AreaInfo.objects.filter(aParent_isnull=True) 
          
          
              # 2. 分頁, 每頁顯示10條數據: 即: 建立 Paginator 類的實例對象 
          
             my_paginator = Paginator(areas, 10) 
          
              # 打印出一共多少頁 
          
          
              print(my_paginator.num_pages) 
          
          
              # 打印出全部頁碼 
          
             print(my_paginator.page_range) 
          
               
          
          
              # 3. 獲取第 pindex 頁的內容 
          
             # page 是 Page 類的實例對象 
             if pindex == '': 
                 pindex = 1 
             else: 
          
                  pindex = int(pindex) 
          
          
              page = my_paginator.page(pindex) 
          
          
              # 打印當前頁的頁碼 
          
          
              print(page.number) 
          
              
          
              # 4. 使用模版 
          
             return  render(request, 'booktext/show_area.html', {'page': page})

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
          
         
         
         
         
          
           
           
          <body> 
          
          
              <ul> 
          
                 {% for area in page.object_list %} 
          
                  // 上下二者等效 
          
          
                  // 循環顯示 當前頁的全部對象 
          
                 {% for area in page %} 
          
                  <li>{{ area.atitle }}</li> 
          
          
                  {% endfor %} 
          
          
              </ul> 
          
             <ul> 
          
              // 判斷是否有上一頁 
          
          
           {% if page.has_previous %} 
          
          
                  <a href="/show_area{{page.previous_page_number}}">上一頁</a> 
          
          
           {% endif %} 
          
          
              {% for pindex in page.paginator.pgae_range %} 
          
          
           
          
          
                  {% if pindex == page.number %} 
          
          
                  // 若是是當前頁 
          
          
                   {{pindex}} 
          
          
                  {% else %} 
          
          
                   <a href='show_area{{ pindex }}'></a> 
          
          
                  {% endif %} 
          
          {% endfor %} 
          
               // 判斷是否有下一頁 
          
          
           {% if page.has_next %} 
          
          
                  <a href="/show_area{{page.next_page_number}}">下一頁</a> 
          
          
           {% endif %} 
          
          
              </ul> 
          
          
          </body>

官方文檔

分頁¶

Django提供了一些類來幫助你管理分頁的數據 -- 也就是說，數據被分在不一樣頁面中，並帶有「上一頁/下一頁」標籤。這些類位於django/core/paginator.py中。node

示例¶

向Paginator提供對象的列表，以及你想爲每一頁分配的元素數量，它就會爲你提供訪問每一頁上對象的方法：python

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
         
         
         
          
           
           
          >>> from django.core.paginator import Paginator 
          
         >>> objects = ['john', 'paul', 'george', 'ringo'] 
         >>> p = Paginator(objects, 2) 
          
         >>> p.count 
         4 
         >>> p.num_pages 
          
          2 
          
         >>> p.page_range 
         [1, 2] 
          
         >>> page1 = p.page(1) 
         >>> page1 
         <Page 1 of 2> 
         >>> page1.object_list 
         ['john', 'paul'] 
          
         >>> page2 = p.page(2) 
         >>> page2.object_list 
         ['george', 'ringo'] 
         >>> page2.has_next() 
         False 
         >>> page2.has_previous() 
         True 
         >>> page2.has_other_pages() 
         True 
         >>> page2.next_page_number() 
         Traceback (most recent call last): 
         ... 
         EmptyPage: That page contains no results 
         >>> page2.previous_page_number() 
         1 
         >>> page2.start_index() # The 1-based index of the first item on this page 
         3 
         >>> page2.end_index() # The 1-based index of the last item on this page 
         4 
          
         >>> p.page(0) 
         Traceback (most recent call last): 
         ... 
         EmptyPage: That page number is less than 1 
         >>> p.page(3) 
         Traceback (most recent call last): 
         ... 
         EmptyPage: That page contains no results

注意web

注意你能夠向Paginator提供一個列表或元組，Django的QuerySet，或者任何帶有count()或__len__()方法的對象。當計算傳入的對象所含對象的數量時，Paginator會首先嚐試調用count()，接着若是傳入的對象沒有count()方法則回退調用 len()。這樣會使相似於Django的QuerySet的對象使用更加高效的 count()方法，若是存在的話。django

使用 `Paginator`

這裏有一些複雜一點的例子，它們在視圖中使用 Paginator 來爲查詢集分頁。咱們提供視圖以及相關的模板來展現如何展現這些結果。這個例子假設你擁有一個已經導入的Contacts模型。api

視圖函數看起來像是這樣：less

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
          
         
         
         
         
          
           
           
          from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger 
          
          
          
          def listing(request): 
          
          
              contact_list = Contacts.objects.all() 
          
          
              paginator = Paginator(contact_list, 25) # Show 25 contacts per page 
          
          
             page = request.GET.get('page') 
             try: 
                 contacts = paginator.page(page) 
             except PageNotAnInteger: 
                 # If page is not an integer, deliver first page. 
          
                  contacts = paginator.page(1) 
          
             except EmptyPage: 
                 # If page is out of range (e.g. 9999), deliver last page of results. 
          
                  contacts = paginator.page(paginator.num_pages) 
          
          
             return render_to_response('list.html', {"contacts": contacts})

在list.html模板中，你會想要包含頁面之間的導航，以及來自對象自己的任何有趣的信息：ide

  
  
  
  
  
   
   
   
   
    
     
   
   
   
   
   
    
     
      
       
        
         
         
         
         
          
           
           
          <div class="pagination"> 
          
          
              <span class="step-links"> 
          
                  
          
                 <span class="current"> 
                     Page  of . 
                 </span> 
          
                  
          
              </span> 
          
         </div>

分頁器 objects

Paginator類擁有如下構造器：函數

class Paginator(object_list, per_page, orphans=0, allow_empty_first_page=True)[source]¶ui

所需參數¶

object_list
A list, tuple, Django QuerySet, or other sliceable object with a count() or __len__() method.
能夠是一個列表, 元組, Django的結果集, 或者是任何一個能夠迭代的對象
per_page
The maximum number of items to include on a page, not including orphans (see the orphans optional argument below).

可選參數¶

orphans
The minimum number of items allowed on the last page, defaults to zero. Use this when you don’t want to have a last page with very few items. If the last page would normally have a number of items less than or equal to orphans, then those items will be added to the previous page (which becomes the last page) instead of leaving the items on a page by themselves. For example, with 23 items, per_page=10, and orphans=3, there will be two pages; the first page with 10 items and the second (and last) page with 13 items.
在最後一頁上容許的最小條目數，默認爲零。當你不想要一個只有不多的項目的最後一頁時，就用這個。若是最後一頁一般有一些小於或等於「孤兒」的條目，那麼這些條目將被添加到前一頁（這是最後一頁），而不是本身將條目放在頁面上。例如，有23個條目，「perpage=10」和「孤兒=3」，將有兩頁;第一個頁面有10個條目，第二個（和最後一個）頁面有13個條目。
allow_empty_first_page
Whether or not the first page is allowed to be empty. If False and object_list is empty, then an EmptyPage error will be raised.
第一個頁面是否被容許爲空。若是「False」和「objectlist」是空的，那麼就會出現一個「錯誤」的錯誤。

方法¶

Paginator.page(number)[source]¶
返回在提供的下標處的Page對象，下標以1開始。若是提供的頁碼不存在，拋出InvalidPage異常。

屬性¶

Paginator.count¶
全部頁面的對象總數。注意當計算object_list所含對象的數量時， Paginator會首先嚐試調用object_list.count()。若是object_list沒有 count() 方法，Paginator 接着會回退使用len(object_list)。這樣會使相似於Django’s QuerySet的對象使用更加便捷的count()方法，若是存在的話。