首页 > 代码库 > Django 分页2 (Pagination)
Django 分页2 (Pagination)
分页是Web应用常用的手法,Django提供了一个分页器类Paginator(django.core.paginator.Paginator),可以很容易的实现分页的功能。该类有两个构造参数,一个是数据的集合,另一个是每页放多少条数据。Paginator的基本使用如下:
$python manage.py shell
>>> 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) #第1页
>>> page1
<Page 1 of 2>
>>> page1.object_list #第1页的数据
[‘john‘, ‘paul‘]
>>> page2 = p.page(2)
>>> page2.object_list #第2页的数据
[‘george‘, ‘ringo‘]
>>> page2.has_next() #是否有后一页
False
>>> page2.has_previous() #是否有前一页
True
>>> page2.has_other_pages() #是否有其他页
True
>>> page2.next_page_number() #后一页的页码
3
>>> page2.previous_page_number() #前一页的页码
1
>>> page2.start_index() # 本页第一条记录的序数(从1开始)
3
>>> page2.end_index() # 本页最后录一条记录的序数(从1开始)
4
>>> p.page(0) #错误的页,抛出异常
...EmptyPage: That page number is less than 1
>>> p.page(3) #错误的页,抛出异常
...EmptyPage: That page contains no results
案例教程:
Django中已经实现了很多功能,基本上只要我们需要的功能,都能够找到相应的包。要在Django中实现分页显示,只需要简单地使用Paginator就可以实现了。
首先,需要在应用的views.py中添加如下引用:
from django.core.paginator import Paginator
from django.core.paginator import PageNotAnInteger
from django.core.paginator import EmptyPage
然后,在需要使用分页的view函数中,添加如下代码:
blogs = Blog.objects.all() # Get released blogs
paginator = Paginator(blogs, 8)
try:
blogs = paginator.page(page_num)
except PageNotAnInteger:
blogs = paginator.page(1)
except EmptyPage:
blogs = paginator.page(paginator.num_pages)
以上代码中,page_num是指的当前需要显示的页,要将当前页的内容显示出来,就跟使用原对象一样,基本没有什么区别,我们还是只需要像如下在模板中使用:
{% for blog in blogs %}
{{ blog.name }}
{{ blog.content }}
......
{% endfor %}
最后,为了显示分页导航信息,我们需要在模板中添加如下代码:
{% if blogs.has_previous %}
<a class=‘paginator‘ title=‘上一页‘ href=http://www.mamicode.com/‘?page={{ blogs.previous_page_number }}‘><span><<</span></a>
{% endif %}
{% for page in blogs.paginator.page_range %}
{% if page = blogs.number %}
<a class=‘paginator_current‘ title=‘当前页:{{ page }}‘><span>{{ page }}</span></a>
{% else %}
<a class=‘paginator‘ href=http://www.mamicode.com/‘?page={{ page }}‘ title=‘{{ page }}‘><span>{{ page }}</span></a>
{% endif %}
{% endfor %}
{% if blogs.has_next %}
<a class=‘paginator‘ title=‘下一页‘ href=http://www.mamicode.com/‘?page={{ blogs.next_page_number }}‘><span>>></span></a>
{% endif %}
OK,一切就这么简单,对数据进行分页显示就完成了。
但是,等等,这里好像还有问题,如果我的数据很多,分出来的页面数也很多,那岂不是分页导航将显示很长的一串数字?
的确是这样,page_range根据总页数,返回从1到总页数之间在数字序列,例如总页数是5, 则page_range返回的值将是[1,2,3,4,5],以此类推,对我们来说的确是个问题。
正是因为有问题,因此也才有了我的博客,下面才是我真正的目的所在,扩展框架自带的Paginator,废话少说,直接上代码:
from django.core.paginator import Paginator
class JuncheePaginator(Paginator):
def __init__(self, object_list, per_page, range_num=5, orphans=0, allow_empty_first_page=True):
Paginator.__init__(self, object_list, per_page, orphans, allow_empty_first_page)
self.range_num = range_num
def page(self, number):
self.page_num = number
return super(JuncheePaginator, self).page(number)
def _page_range_ext(self):
num_count = 2 * self.range_num + 1
if self.num_pages <= num_count:
return range(1, self.num_pages + 1)
num_list = []
num_list.append(self.page_num)
for i in range(1, self.range_num + 1):
if self.page_num - i <= 0:
num_list.append(num_count + self.page_num - i)
else:
num_list.append(self.page_num - i)
if self.page_num + i <= self.num_pages:
num_list.append(self.page_num + i)
else:
num_list.append(self.page_num + i - num_count)
num_list.sort()
return num_list
page_range_ext = property(_page_range_ext)
为了减少文章篇幅,我特意将一些注释去掉了。现在简单地解释一 下。
__init__()函数不用说了吧,就是重载了一下,添加了一个range_num参数,代表在可能的情况下,当前页左右各显示多少个页标签,默认值为5。
page()函数是对父类Paginator的page()函数的重写,主要是为了记录当前页。
核心是_page_range_ext()函数,它实现了我们根据page_num的情况来返回恰当的页面列表,page_num取默认值的情况下,如果当前页是8,则我们返回的页数列表就应该是[3,4,5,6,7,8,9,10,11,12,13],但如果说是当前页是2,则会返回[1,2,3,4,5,6,7,8,9,10,11],其余的以此类推。具体算法我就不仔细分析了,大家可以参看源代码,个人感觉还可以优化,但我现在也就能用就行。
接下来还需要在views.py中将以下语句:
paginator = Paginator(blogs, 8)
改为:
paginator = JuncheePaginator(blogs, 8)
在模板中,将以下语句:
{% for page in blogs.paginator.page_range %}
改为:
{% for page in blogs.paginator.page_range_ext %}
其它的事情,呵呵,那就是快去美化你的页面吧!
Django 分页2 (Pagination)