صفحه بندی و شماره گذاری صفحات

جنگو

سلام

این کار با استفاده از CBV بسیار آسان است. اما قبل از آن می خواهیم صفحه بندی مطالب را به صورت دستی انجام دهیم تا از مکانیسم واقعی آن آگاهی پیدا کنی و سپس از تکنولوژی CBV بهره برداری می کنیم.

از الآن به بعد روی ویوی board_topics کار می کنیم.

در مرحلۀ اول می خواهیم چند پست اضافه کنیم. برای این کار هم می توانیم قسمت کاربری را در برنامه باز و چند پست ایجاد کنیم و هم می توانیم با استفاده از شل پایتون و اسکریپت نویسی مختصر این کار را انجام دهیم:

python manage.py shell
from django.contrib.auth.models import User
from boards.models import Board, Topic, Post

user = User.objects.first()

board = Board.objects.get(name='Django')

for i in range(100):
    subject = 'Topic test #{}'.format(i)
    topic = Topic.objects.create(subject=subject, board=board, starter=user)
    Post.objects.create(message='Lorem ipsum...', topic=topic, created_by=user)

بسیار عالی! حالا یک سری داده برای بازی با آن ها داریم!

قبل از اینکه وارد کدزنی شویم کمی بیشتر با شل پایتون تفریح کنیم.

python manage.py shell
from boards.models import Topic

# All the topics in the app
Topic.objects.count()
107

# Just the topics in the Django board
Topic.objects.filter(board__name='Django').count()
104

# Let's save this queryset into a variable to paginate it
queryset = Topic.objects.filter(board__name='Django').order_by('-last_updated')

ذخیره سازی QuerySet برای صفحه بندی بسیار مهم است. در صورت عدم انجام این کار ممکن است نتایج متفاوت و اشتباهی را دریافت کنی.

خوب! حالا می خواهیم از ابزار paginator استفاده کنیم. (pagination به معنای صفحه بندی است.)

from django.core.paginator import Paginator

paginator = Paginator(queryset, 20)

در قطعه کد بالا به برنامه گفته ایم که کوئری ست ما را به گونه ای استفاده کن که در هر صفحه 20 مورد قرار گیرد. حالا می خواهیم سایر امکانات paginator را مرور کنیم.

# count the number of elements in the paginator
paginator.count
104

# total number of pages
# 104 elements, paginating 20 per page gives you 6 pages
# where the last page will have only 4 elements
paginator.num_pages
6

# range of pages that can be used to iterate and create the
# links to the pages in the template
paginator.page_range
range(1, 7)

# returns a Page instance
paginator.page(2)
<Page 2 of 6>

page = paginator.page(2)

type(page)
django.core.paginator.Page

type(paginator)
django.core.paginator.Paginator

در این قسمت لازم است که دقت کافی صورت پذیرد. مثلاً اگر بخواهیم به صفحه ای که وجود ندارد دسترسی پیدا کنیم؛ paginator خطا می دهد.

paginator.page(7)
EmptyPage: That page contains no results

یا اگر بخواهیم به جای شمارۀ صفحه پارامتر نامناسبی را وارد برنامه کنیم:

paginator.page('abc')
PageNotAnInteger: That page number is not an integer

پس لازم است در زمان طراحی واسط کاربری تمام این موارد را در ذهن داشته باشیم.

در ادامه به سایر توابع و امکانات برای صفحه بندی می پردازیم:

page = paginator.page(1)

# Check if there is another page after this one
page.has_next()
True

# If there is no previous page, that means this one is the first page
page.has_previous()
False

page.has_other_pages()
True

page.next_page_number()
2

# Take care here, since there is no previous page,
# if we call the method `previous_page_number() we will get an exception:
page.previous_page_number()
EmptyPage: That page number is less than 1

ترجمۀ اختصاصی توسط تمدن

 

مطلب بعدی: صفحه بندی با استفاده از FBV

مطلب قبلی: ویوی لیست | List View

بدون دیدگاه

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

جنگو
پیکربندی گواهینامۀ https

سلام حالا می خواهیم برنامۀ خودمان را با گواهینامۀ https امن کنیم. ساده ترین کار برای انجام آن Let’s Encrypt است. قبل از Let’s Encrypt هرگز تنظیمات https به این راحتی نبوده و مهمتر اینکه اینکار کاملاً رایگان است. آن ها راه حلی به نام certbot را ارائه داده اند …

جنگو
پیکربندی سرویس ایمیل

سلام یکی از بهتر سرویس دهنده های ایمیل Mailgun با قابلیت ۱۲ هزار ایمیل رایگان در ماه است. به صورت رایگان ثبت نام کنید. برای اینکار باید آن را با سرویس دهندۀ دامین خود تنظیم کنید که در این آموزش از tamadon.org استفاده شده است. حالا اولین رکورد DNS را …

جنگو
پیکربندی NGINX

سلام کار بعدی که قرار است انجام شود؛ تنظیمان Nginx به شکلی است که پاسخگویی و سرویس دهی مربوط به فایل های استاتیک را خود انجام دهد و سایر درخواست ها را به Gunicorn بفرستد. یک فایل پیکربندی با نام boards را درون /etc/nginx/sites-available/ و با محتوای زیر اضافه می …

هرگونه استفادۀ از این آموزش به صورت رایگان و با ارجاع به تمدن جایز است.