当前访客身份:游客 [ 登录  | 注册加入尚学堂]
直播

openstack爱好者

拥有积分:3
这家伙太懒,还没有签名!

博客分类

笔记中心

课题中心

提问中心

答题中心

解答题中心

19:django 分页

openstack爱好者 发表于 2年前 (2015-01-13 23:38:43)  |  评论(0)  |  阅读次数(857)| 0 人收藏此文章,   我要收藏   

分页是网站中比较常见的应用,django提供了一些类帮助管理分页的数据,这些类都位于django.core.paginator.py文件里面

分页类

构造函数

class Paginator(object_listper_pageorphans=0allow_empty_first_page=True)

必需参数:

object_list:具有count()或者__len__()方法的可切片的对象,比如列表,元组或者django queryset

per_page:每页最大的条目数量

可选参数:

  • orphans:orphan是孤儿的意思,这个参数指明最后一页的最少条目数字是多少,默认是0。假如orphans是3,你的最后一页只有两个条目,那么这两个条目将会被并到前一页去,而不会形成”孤儿“(最后一个太少条目) 
  • allow_empty_first_page:是否允许第一页是空(没有一个条目),如果是假,那么当object_list是空的时候,抛出EmptyPage的错误

方法

  • Paginator.page(number):返回一个页对象(从1开始算起),如果不存在抛出一个InvalidPage异常

属性

  • Paginator.count:object_list中的条目的总条数
  • Paginator.num_pages:总页数
  • Paginator.page_range:页范围,从1开始算起,例如:[1,2,3,4]

InvalidPage 异常

有三个异常,InvalidPage,PageNotAnInteger和EmptyPage,看下面的代码即可以知道他们之间的关系

class InvalidPage(Exception):
    pass

class PageNotAnInteger(InvalidPage):
    pass

class EmptyPage(InvalidPage):
    pass

 

页类

Paginator.page()函数返回一个页对象,类原型是class Page(object_list,number,paginator)

方法

  • Page.has_next():如果还有下一页,返回真
  • Page.has_previous():如果有前一页,返回真
  • Page.has_other_pages():如果还有前一页或者下一页,返回真
  • Page.next_page_number():返回下一页的页码,不管下一页是否存在
  • Page.previous_page_number():返回前一页的页码,不管前一页是否存在
  • Page.start_index():当前页的元素的开始编号,例如5个元素每两个元素一页,那么共有三页,第二页的start_index()是3
  • Page.end_index():当前页的元素的结束编号,例如5个元素每两个元素一页,那么共有三页,第二页的end_index()是4

属性

  • Page.object_list:这一页上的元素的形成的列表
  • Page.number:当前页的页码
  • Page.Paginator:关联的Paginator对象

最后我们看一下应用的例子吧:

视图函数:

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})

 

模板

{% 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>

 

分享到:0
关注微信,跟着我们扩展技术视野。每天推送IT新技术文章,每周聚焦一门新技术。微信二维码如下:
微信公众账号:尚学堂(微信号:bjsxt-java)
声明:博客文章版权属于原创作者,受法律保护。如果侵犯了您的权利,请联系管理员,我们将及时删除!
(邮箱:webmaster#sxt.cn(#换为@))
北京总部地址:北京市海淀区西三旗桥东建材城西路85号神州科技园B座三层尚学堂 咨询电话:400-009-1906 010-56233821
Copyright 2007-2015 北京尚学堂科技有限公司 京ICP备13018289号-1 京公网安备11010802015183