四—二、分页功能

Django提供了数据分页的类，这些类被定义在django/core/paginator.py中。 类Paginator用于对列进行一页n条数据的分页运算。类Page用于表示第m页的数据。

Paginator类实例对象

• 方法__init__(列表,int)：返回分页对象，第一个参数为列表数据，第二个参数为每页数据的条数。
• 属性count：返回对象总数。
• 属性num_pages：返回页面总数。
• 属性page_range：返回页码列表，从1开始，例如[1, 2, 3, 4]。
• 方法page(m)：返回Page类实例对象，表示第m页的数据，下标以1开始。

Page类实例对象

• 调用Paginator对象的page()方法返回Page对象，不需要手动构造。
• 属性object_list：返回当前页对象的列表。
• 属性number：返回当前是第几页，从1开始。
• 属性paginator：当前页对应的Paginator对象。
• 方法has_next()：如果有下一页返回True。
• 方法has_previous()：如果有上一页返回True。
• 方法len()：返回当前页面对象的个数。
  示例：

假设我们拥有一个已经导入的Contacts模型类。视图函数看起来像是这样：

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger

def listing(request):
    contact_list = Contacts.objects.all()
    paginator = Paginator(contact_list, 25) #每页显示25条数据

    page = request.GET.get('page')
    try:
        contacts = paginator.page(page)
    except PageNotAnInteger:
        contacts = paginator.page(1)
    except EmptyPage:
        contacts = paginator.page(paginator.num_pages)

    return render_to_response('list.html', {"contacts": contacts})

在对应的list.html模板中，我们可以包含页面之间的导航，以及来自对象本身的任何有趣的信息：

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