Trong phần này chúng ta sẽ học cách phân trang. Django cung cấp lớp django.core.paginator
hỗ trợ phân trang rất tốt.
Ví dụ
Chúng ta tạo một app có tên là pagination.
C:\Project\mysite>python manage.py startapp pagination
Thêm app vào danh sách INSTALLED_APPS:
INSTALLED_APPS = [ #... 'pagination', #... ]
Tiếp theo chúng ta tạo model và thêm vào một số dòng dữ liệu mẫu để test.
from django.db import models # Create your models here. class Customer(models.Model): name = models.CharField(max_length=100) country = models.CharField(max_length=20)
Chúng ta định nghĩa model Customer
có 2 trường là name
và country.
Cập nhật lại CSDL:
python manage.py makemigrations python manage.py migrate
Đoạn script sau sẽ tạo một số dòng dữ liệu mẫu trong bảng pagination_customer.
import os import django os.environ.setdefault("DJANGO_SETTINGS_MODULE", "mysite.settings"); django.setup() from pagination.models import Customer Customer.objects.create(name='Alfreds Futterkiste', country='Germany') Customer.objects.create(name='Ana Trujillo Emparedados y helados', country='Mexico') Customer.objects.create(name='Antonio Moreno Taquería', country='Mexico') Customer.objects.create(name='Around the Horn', country='UK') Customer.objects.create(name='Berglunds snabbköp', country='Sweden') Customer.objects.create(name='Blauer See Delikatessen', country='Germany') Customer.objects.create(name='Blondel père et fils', country='France') Customer.objects.create(name='Bólido Comidas preparadas', country='Spain') Customer.objects.create(name='Bon app', country='France') Customer.objects.create(name='Bottom-Dollar Marketse', country='Canada') Customer.objects.create(name='Bs Beverages', country='UK') Customer.objects.create(name='Cactus Comidas para llevar', country='Argentina') Customer.objects.create(name='Centro comercial Moctezuma', country='Mexico') Customer.objects.create(name='Chop-suey Chinese', country='Switzerland') Customer.objects.create(name='Comércio Mineiro', country='Brazil') Customer.objects.create(name='Consolidated Holdings', country='UK') Customer.objects.create(name='Drachenblut Delikatessend', country='Germany') Customer.objects.create(name='Du monde entier', country='France') Customer.objects.create(name='Eastern Connection', country='UK')
Tiếp theo chúng ta viết template và hàm view.
from django.shortcuts import render # Create your views here. from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger from .models import Customer def listing(request): customer_list = Customer.objects.all() paginator = Paginator(customer_list, 5) pageNumber = request.GET.get('page') try: customers = paginator.page(pageNumber) except PageNotAnInteger: customers = paginator.page(1) except EmptyPage: customers = paginator.page(paginator.num_pages) return render(request, 'list.html', {'customers':customers})
Chúng ta sử dụng lớp Pagination
để thực hiện phân trang.
from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
Đầu tiên chúng ta import một số lớp cần thiết.
paginator = Paginator(customer_list, 5)
Hàm khởi tạo Paginator()
nhận vào 2 tham số, tham số đầu tiên là một đối tượng QuerySet,
tham số thứ 2 là số tượng item trên mỗi “trang”. Trong ví dụ trên chúng ta đưa đối tượng customer_list
vào với số lượng 5 item mỗi trang.
pageNumber = request.GET.get('page')
URL của chúng ta có thêm tham số page
là số thứ tự của trang muốn xem.
try: customers = paginator.page(pageNumber) except PageNotAnInteger: customers = paginator.page(1) except EmptyPage: customers = paginator.page(paginator.num_pages)
Nếu tham số page
không hợp lệ, chẳng hạn như page=abc
thì Paginator
sẽ giải phóng lỗi PageNotAnInterger,
trong trường hợp này chúng ta trả về trang đầu tiên với phương thức Paginator.page()
, hoặc nếu page nằm ngoài pham vi trang cho phép, chẳng hạn như chúng ta chỉ có 4 trang nhưng tham số page=1000
thì Paginator
sẽ giải phóng lỗi EmptyPage,
ở đây chúng ta xử lý bằng cách trả về trang cuối cùng bằng thuộc tính num_pages.
Template:
<table> <tr> <th>Customer name</th> <th>Country</th> </tr> {% for customer in customers %} <tr> <td>{{ customer.name }}</td> <td>{{ customer.country }}</td> </tr> {% endfor %} </table> <div class="pagination"> <span class="step-links"> {% if customers.has_previous %} <a href="?page={{ customers.previous_page_number }}">Previous</a> {% endif %} </span> <span class="current"> Page {{ customers.number }} of {{ customers.paginator.num_pages }}. </span> <span> {% if customers.has_next %} <a href="?page={{ customers.next_page_number }}">Next</a> {% endif %} </span> </div>
Cuối cùng chúng ta tạo URL và chạy server để xem kết quả.
from django.conf.urls import url from . import views urlpatterns = [ url(r'^$', views.listing), ]
from django.conf.urls import url, include from django.contrib import admin urlpatterns = [ url(r'^admin/', admin.site.urls), url(r'^pagination/', include('pagination.urls')), ]
Hay và rất hữu ích ạ 🙂
cám ơn bạn… tập 2 :3
hi. Ad hướng dẫn thêm cách cài đặt trên hosting với ạ
ok bạn. mình sẽ cố gắng viết sớm
Cảm ơn ad vì bài viết.
Mình xin góp ý là trong file pagination/views.py, dòng
return render(request, ‘list.html’, {‘customers’:customers}) phải chuyển thành
return render(request, ‘pagination/list.html’, {‘customers’:customers})
làm như thế thì bạn sẽ tạo một thư mục với tên pagination trong thư mục templates à bạn?
Hay là bạn dùng Django phiên bản nào? có thể các phiên bản mới hơn quy định như vậy. Cũng có thể là do bạn thiết lập nữa 🙂
asdad
Nếu bạn nào gặp lỗi này như mình thì thử cách này để fix nha:
======>
Admin cho minh hỏi: Mình chạy ra thanh phân trang, nhưng nội dung lại bị ẩn….
mà không hiện lỗi gì cả!!
bạn xem đã nhập dữ liệu vào chưa
Mình đã nhập dữ liệu rồi ad!!
bạn dùng phiên bản django nào? bản mình dùng là 1.9.7