سلام
این کار با استفاده از CBV بسیار آسان است. اما قبل از آن می خواهیم صفحه بندی مطالب را به صورت دستی انجام دهیم تا از مکانیسم واقعی آن آگاهی پیدا کنی و سپس از تکنولوژی CBV بهره برداری می کنیم.
از الآن به بعد روی ویوی board_topics کار می کنیم.
در مرحلۀ اول می خواهیم چند پست اضافه کنیم. برای این کار هم می توانیم قسمت کاربری را در برنامه باز و چند پست ایجاد کنیم و هم می توانیم با استفاده از شل پایتون و اسکریپت نویسی مختصر این کار را انجام دهیم:
|
1 |
python manage.py shell |
|
1 2 3 4 5 6 7 8 9 10 11 |
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) |
بسیار عالی! حالا یک سری داده برای بازی با آن ها داریم!
قبل از اینکه وارد کدزنی شویم کمی بیشتر با شل پایتون تفریح کنیم.
|
1 |
python manage.py shell |
|
1 2 3 4 5 6 7 8 9 10 11 12 |
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 به معنای صفحه بندی است.)
|
1 2 3 |
from django.core.paginator import Paginator paginator = Paginator(queryset, 20) |
در قطعه کد بالا به برنامه گفته ایم که کوئری ست ما را به گونه ای استفاده کن که در هر صفحه 20 مورد قرار گیرد. حالا می خواهیم سایر امکانات paginator را مرور کنیم.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
# 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 خطا می دهد.
|
1 2 |
paginator.page(7) EmptyPage: That page contains no results |
یا اگر بخواهیم به جای شمارۀ صفحه پارامتر نامناسبی را وارد برنامه کنیم:
|
1 2 |
paginator.page('abc') PageNotAnInteger: That page number is not an integer |
پس لازم است در زمان طراحی واسط کاربری تمام این موارد را در ذهن داشته باشیم.
در ادامه به سایر توابع و امکانات برای صفحه بندی می پردازیم:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
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
بدون دیدگاه