Django 클래스 기반 제네릭 ListViews를 사용하여 페이징을 수행하는 방법

2024-07-27

Django 클래스 기반 제네릭 ListViews를 사용하여 페이징을 수행하는 방법

이 중 ListView는 모델에서 객체 목록을 표시하는 데 사용되는 유용한 뷰입니다. 하지만 데이터 양이 많아질 경우 모든 객체를 한 페이지에 표시하기에는 적합하지 않을 수 있습니다. 이런 경우 페이징 기능을 사용하여 여러 페이지로 나누어 보여주는 것이 효과적입니다.

Django에서는 기본적으로 PaginationMixin 클래스를 제공하여 페이징 기능을 구현할 수 있도록 돕습니다. 이 클래스를 상속받은 ListView를 만들면 페이지 번호, 페이지당 표시되는 객체 수, 이전/다음 페이지 링크 등을 자동으로 처리할 수 있습니다.

다음은 Django 클래스 기반 제네릭 ListViews를 사용하여 페이징을 수행하는 방법에 대한 단계별 설명입니다.

필요한 모듈 임포트하기:

from django.views.generic import ListView
from django.core.paginator import Paginator

모델 정의하기:

from django.db import models

class MyModel(models.Model):
    # 모델 필드 정의
    pass

ListView 클래스 만들기:

class MyListView(ListView):
    model = MyModel  # 표시할 모델 설정
    paginate_by = 10  # 페이지당 표시되는 객체 수 설정

위 코드는 MyModel 모델에서 객체 목록을 표시하는 ListView를 정의합니다. paginate_by 속성을 사용하여 페이지당 표시되는 객체 수를 10으로 설정합니다.

템플릿 만들기:

<table>
    <thead>
        <tr>
            </tr>
    </thead>
    <tbody>
        {% for object in object_list %}
            <tr>
                </tr>
        {% endfor %}
    </tbody>
</table>

{% if is_paginated %}
    <nav>
        {% if page_obj.has_previous %}
            <a href="?page={{ page_obj.previous_page_number }}">이전</a>
        {% endif %}

        <span> {{ page_obj.number }} of {{ page_obj.num_pages }}</span>

        {% if page_obj.has_next %}
            <a href="?page={{ page_obj.next_page_number }}">다음</a>
        {% endif %}
    </nav>
{% endif %}

위 템플릿은 my_list_view.html이라는 이름으로 저장됩니다. 테이블을 사용하여 객체 목록을 표시하고, 페이지 네비게이션을 위한 링크를 제공합니다.

URL 매핑 설정하기:

from django.urls import path

urlpatterns = [
    path('my-list-view/', MyListView.as_view(), name='my-list-view'),
]

위 코드는 my-list-view/ URL을 MyListView 클래스 기반 뷰에 매핑합니다.

실행 및 확인하기:

위 단계를 모두 완료하면 Django 프로젝트를 실행하고 my-list-view/ URL을 방문하면 데이터 목록이 페이지당 10개씩 표시되고 페이지 네비게이션 링크를 사용하여 다른 페이지로 이동할 수 있습니다.

참고:

paginate_by 속성은 페이지당 표시되는 객체 수를 조정할 수 있습니다.
템플릿에서 제공되는 is_paginated 변수를 사용하여 페이지 네비게이션 영역을 표시할지 여부를 제어할 수 있습니다.

예제 코드: Django 클래스 기반 제네릭 ListViews를 사용하여 페이징을 수행하는 방법

models.py

from django.db import models

class MyModel(models.Model):
    # 모델 필드 정의
    pass

views.py

from django.views.generic import ListView
from django.core.paginator import Paginator

class MyListView(ListView):
    model = MyModel
    paginate_by = 10

templates/my_list_view.html

<table>
    <thead>
        <tr>
            </tr>
    </thead>
    <tbody>
        {% for object in object_list %}
            <tr>
                </tr>
        {% endfor %}
    </tbody>
</table>

{% if is_paginated %}
    <nav>
        {% if page_obj.has_previous %}
            <a href="?page={{ page_obj.previous_page_number }}">이전</a>
        {% endif %}

        <span> {{ page_obj.number }} of {{ page_obj.num_pages }}</span>

        {% if page_obj.has_next %}
            <a href="?page={{ page_obj.next_page_number }}">다음</a>
        {% endif %}
    </nav>
{% endif %}

urls.py

from django.urls import path

urlpatterns = [
    path('my-list-view/', MyListView.as_view(), name='my-list-view'),
]

위 코드는 다음과 같이 작동합니다.

models.py: MyModel 모델을 정의합니다. 이 모델은 페이징할 객체를 나타냅니다.
views.py: MyListView 클래스 기반 뷰를 정의합니다. 이 뷰는 MyModel 모델에서 객체 목록을 가져와 템플릿에 렌더링합니다. paginate_by 속성을 사용하여 페이지당 표시되는 객체 수를 10으로 설정합니다.
templates/my_list_view.html: 객체 목록을 표시하는 템플릿입니다. 테이블을 사용하여 객체를 표시하고 페이지 네비게이션을 위한 링크를 제공합니다.

from django.shortcuts import render
from django.core.paginator import Paginator

def my_list_view(request):
    object_list = MyModel.objects.all()
    paginator = Paginator(object_list, 10)
    page_number = request.GET.get('page')
    page_obj = paginator.get_page(page_number)

    context = {
        'object_list': page_obj.object_list,
        'page_obj': page_obj,
    }
    return render(request, 'my_list_view.html', context)