首页 > 代码库 > 19:django 分页
19:django 分页
分页是网站中比较常见的应用,django提供了一些类帮助管理分页的数据,这些类都位于django.core.paginator.py文件里面
分页类
构造函数
class Paginator(object_list, per_page, orphans=0, allow_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): passclass PageNotAnInteger(InvalidPage): passclass 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, PageNotAnIntegerdef 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>
19:django 分页
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。