视图核心代码
# 获取所有文章
post = Post.objects.all()
# 获取p的值默认为1
p = request.GET.get('p', 1)
# 第一个参数为 必选参数,代表需要进行分页处理的数据,参数值可以为列表、元组或ORM查询的数据对象等。
# 第二个参数为 必选参数,设置每一页的数据量,参数值必须为整型
paginator = Paginator(post, 4)
try:
# page():根据当前页数对参数object_list进行切片处理,获取页数所对应的数据信息,函数返回值调用_get_page()。
pages = paginator.page(p)
except PageNotAnInteger:
pages = paginator.page(1)
except EmptyPage:
# num_pages():获取分页后的总页数。
pages = paginator.page(paginator.num_pages)
前端核心代码
<nav class="pagination" style="">
<ul>
//has_previous():判断当前页数是否存在上一页
{% if pages.has_previous %}
//previous_page_number():如果当前页数存在上一页,就输出上一页的页数,否则抛出EmptyPage异常。
<li class="next-page"><a href="?p={{ pages.previous_page_number }}">上一页</a></li>
{% endif %}
<li class="prev-page"></li>
//page_range():将分页后的总页数生成可循环对象。
{% for page in pages.paginator.page_range %}
{% if pages.number == page %}
<li class="active"><span>{{ page }}</span></li>
{% elif pages.number|add:'-1' == page or pages.number|add:'1' == page %}
<li><a href="?p={{ page }}">{{ page }}</a></li>
{% endif %}
{% endfor %}
//has_next():判断当前页数是否存在下一页。
{% if pages.has_next %}
//next_page_number():如果当前页数存在下一页,就输出下一页的页数,否则抛出EmptyPage异常。
<li class="next-page"><a href="?p={{ pages.next_page_number }}">下一页</a></li>
{% endif %}
</ul>
</nav>
Paginator类一共定义了4个初始化参数和8个类方法,每个初始化参数和类方法的说明如下:
- object_list:必选参数,代表需要进行分页处理的数据,参数值可以为列表、元组或ORM查询的数据对象等。
- per_page:必选参数,设置每一页的数据量,参数值必须为整型。
- orphans:可选参数,如果最后一页的数据量小于或等于参数orphans的值,就将最后一页的数据合并到前一页的数据。比如有23行数据,若参数per_page=10、orphans=5,则数据分页后的总页数为2,第一页显示10行数据,第二页显示13行数据。
- allow_empty_first_page:可选参数,是否允许第一页为空。如果参数值为False并且参数object_list为空列表,就会引发EmptyPage错误。
- validate_number():验证当前页数是否大于或等于1。
- get_page():调用validate_number()验证当前页数是否有效,函数返回值调用page()。
- page():根据当前页数对参数object_list进行切片处理,获取页数所对应的数据信息,函数返回值调用_get_page()。_
- get_page():调用Page类,并将当前页数和页数所对应的数据信息传递给Page类,创建当前页数的数据对象。
- count():获取参数object_list的数据长度。
- num_pages():获取分页后的总页数。
- page_range():将分页后的总页数生成可循环对象。
- _check_object_list_is_ordered():如果参数object_list是ORM查询的数据对象,并且该数据对象的数据是无序排列的,就提示警告信息。
从Paginator类定义的get_page()、page()和_get_page()得知,三者之间存在调用关系
Page类的定义过程,它一共定义了3个初始化参数和7个类方法,每个初始化参数和类方法的说明如下:
- object_list:必选参数,代表已切片处理的数据对象。
- number:必选参数,代表用户传递的页数。
- paginator:必选参数,代表Paginator类的实例化对象。
- has_next():判断当前页数是否存在下一页。
- has_previous():判断当前页数是否存在上一页。
- has_other_pages():判断当前页数是否存在上一页或者下一页。
- next_page_number():如果当前页数存在下一页,就输出下一页的页数,否则抛出EmptyPage异常。
- previous_page_number():如果当前页数存在上一页,就输出上一页的页数,否则抛出EmptyPage异常。
- start_index():输出当前页数的第一行数据在整个数据列表的位置,数据位置从1开始计算。
- end_index():输出当前页数的最后一行数据在整个数据列表的位置,数据位置从1开始计算。