• jQuery火箭图标返回顶部代码


     Django自身提供了一些类来实现管理分页,数据被分在不同的页面中,并带有“上一页/下一页”标签。这个类叫做Pagination,其定义位于 django/core/paginator.py 中。

    一. Paginator类的解释

    class Paginator(object):
    
        def __init__(self, object_list, per_page, orphans=0,
                     allow_empty_first_page=True):
            self.object_list = object_list
            self.per_page = int(per_page)
            self.orphans = int(orphans)
            self.allow_empty_first_page = allow_empty_first_page
            self._num_pages = self._count = None

    1.根据其定义做出以下解释,上述代码没有将其类属性和方法贴出。

    • object_list:可以是列表,元组,查询集或其他含有 count() 或 __len__()方法的可切片对象。对于连续的分页,查询集应该有序,例如有order_by()项或默认ordering参数。
    • per_page:每一页中包含条目数目的最大值,不包括独立成页的那页。(见下面 orphans参数解释)。
    • orphans=0:当你使用此参数时说明你不希望最后一页只有很少的条目。如果最后一页的条目数少于等于orphans的值,则这些条目会被归并到上一页中(此时的上一页变为最后一页)。例如有23项条目, per_page=10,orphans=0,则有3页,分别为10,10,3.如果orphans>=3,则为2页,分别为10,13。
    • allow_empty_first_page=True: 默认允许第一页为空。

    2.类方法:

    •     Paginator.page(number):根据参数number返回一个Page对象。(number为1的倍数)

    3.类属型:

    • Paginator.count:所有页面对象总数,即统计object_list中item数目。当计算object_list所含对象的数量时, Paginator会首先尝试调用object_list.count()如果object_list没有 count() 方法,Paginator 接着会回退使用len(object_list)
    • Pagnator.num_pages:页面总数。
    • pagiator.page_range:页面范围,从1开始,例如[1,2,3,4]。

    二. Page类的解释

     通常不用手动创建Page对象,可以从Paginator.page()来获得他们。

    class Page(collections.Sequence):
    
        def __init__(self, object_list, number, paginator):
            self.object_list = object_list
            self.number = number
            self.paginator = paginator

    1.类方法

    • Page.has_next()  如果有下一页,则返回True
    • Page.has_previous() 如果有上一页,返回 True
    • Page.has_other_pages() 如果有上一页或下一页,返回True
    • Page.next_page_number() 返回下一页的页码。如果下一页不存在,抛出InvlidPage异常。
    • Page.previous_page_number() 返回上一页的页码。如果上一页不存在,抛出InvalidPage异常。
    • Page.start_index() 返回当前页上的第一个对象,相对于分页列表的所有对象的序号,从1开始。比如,将五个对象的列表分为每页两个对象,第二页的start_index()会返回3
    • Page.end_index() 返回当前页上的最后一个对象,相对于分页列表的所有对象的序号,从1开始。 比如,将五个对象的列表分为每页两个对象,第二页的end_index() 会返回 4

    2.类属型

    • Page.object_list 当前页上所有对象的列表。
    • Page.number 当前页的序号,从1开始。
    • Page.paginator 相关的Paginator对象。

    三.非法页面处理

    • InvalidPage(Exception): 异常的基类,当paginator传入一个无效的页码时抛出。

      Paginator.page()放回在所请求的页面无效(比如不是一个整数)时,或者不包含任何对象时抛出异常。通常,捕获InvalidPage异常就够了,但是如果你想更加精细一些,可以捕获以下两个异常之一:

    • exception PageNotAnInteger,当向page()提供一个不是整数的值时抛出。
    • exception EmptyPage,当向page()提供一个有效值,但是那个页面上没有任何对象时抛出。

           这两个异常都是InalidPage的子类,所以可以通过简单的except InvalidPage来处理它们。

    四.使用Paginator

    官方示例:

    views.py:

    from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
    from django.shortcuts import render
    
    def listing(request):
        contact_list = Contacts.objects.all()  # 获取所有contacts,假设在models.py中已定义了Contacts模型
        paginator = Paginator(contact_list, 25) # 每页25条
    
        page = request.GET.get('page')
        try:
            contacts = paginator.page(page) # contacts为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(request, 'list.html', {'contacts': contacts})

    list.html:

    {% for contact in contacts %}
        {# Each "contact" is a Contact model object. #}
        {{ contact.full_name|upper }}<br />
        ...
    {% endfor %}
    
    <div class="pagination">
        <span class="step-links">
            {% if contacts.has_previous %}
                <a href="?page={{ contacts.previous_page_number }}">previous</a>
            {% endif %}
    
            <span class="current">
                Page {{ contacts.number }} of {{ contacts.paginator.num_pages }}.
            </span>
    
            {% if contacts.has_next %}
                <a href="?page={{ contacts.next_page_number }}">next</a>
            {% endif %}
        </span>
    </div>

    final:  根据官方示例代码结果如下,页面共有3页,首页时只有next选项,中间页时可选择previous 或 next,尾页时只有previous选项。

     另:给出另一种list.html:

    <div id="pagination">
        <ul id="pagination-flickr">
        {% if article_list.has_previous %}
        <li class="previous"><a href="?page={{ article_list.previous_page_number }}{% if request.GET.year %}&year={{ request.GET.year }}{% endif %}{% if request.GET.month %}&month={{ request.GET.month }}{% endif %}{% if request.GET.cid %}&cid={{ request.GET.cid }}{% endif %}">&laquo;上一页</a></li>
        {% else %}
        <li class="previous-off">&laquo;上一页</li>
        {% endif %}
    
         <li class="active">{{ article_list.number }}/{{ article_list.paginator.num_pages }}</li>
        {% if article_list.has_next %}
          <li class="next"><a href="?page={{ article_list.next_page_number }}{% if request.GET.year %}&year={{ request.GET.year }}{% endif %}{% if request.GET.month %}&month={{ request.GET.month }}{% endif %}{% if request.GET.cid %}&cid={{ request.GET.cid }}{% endif %}">下一页 &raquo;</a></li>
        {% else %}
          <li class="next-off">下一页 &raquo;</li>
        {% endif %}
       </ul>
    </div>
    contacts 和 article_list 是同一个意思,效果如下:

    
    
    
  • 相关阅读:
    软件工程网络15个人阅读作业1
    团队课程设计博客
    计时器(何雨柔201521123040)
    软工网络15个人作业4——alpha阶段个人总结
    软工网络15个人作业3——案例分析
    软件工程网络15结对编程作业
    软工网络15个人作业2
    软件工程网络15个人阅读作业1(201521123032 黄登峰)
    计时器(黄登峰 201521123032)
    201521123032 《Java程序设计》第14周学习总结
  • 原文地址:https://www.cnblogs.com/MayDayTime/p/9720552.html
Copyright © 2020-2023  润新知