메시지 프레임워크

메시지 프레임워크 강의자료

1. 메시지 프레임워크란?

Django에서 flash message를 구현하는 방법.

요청과 응답 사이의 한 번성 메시지를 저장하고, 템플릿에서 표시합니다.

Django 메시지 프레임워크는 사용자에게 알림 메시지를 보여줄 때 유용한 기능입니다. 예를 들어 회원가입/로그인 성공, 오류 안내 등 다양한 상황에서 활용됩니다.

2. 사용 준비

settings.py

# 기본적으로 포함되어 있음 (확인만 하면 됨)
'django.contrib.messages',
Python
복사

Middleware 설정

# 기본적으로 포함되어 있음
'django.contrib.sessions.middleware.SessionMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
Python
복사

Template context processor 확인

# settings.py의 TEMPLATES > OPTIONS > context_processors
'django.contrib.messages.context_processors.messages',
Python
복사

3. 메시지 사용 방법

views.py

from django.contrib import messages
from django.shortcuts import redirect

def sample_view(request):
    messages.success(request, '성공적으로 처리되었습니다.')
    messages.error(request, '오류가 발생했습니다.')
    messages.warning(request, '주의가 필요합니다.')
    messages.info(request, '정보성 메시지입니다.')
    return redirect('home')
Python
복사

4. 템플릿에 메시지 표시

templates/base.html 예시

{% if messages %}
  <ul class="messages">
    {% for message in messages %}
      <li class="{{ message.tags }}">{{ message }}</li>
    {% endfor %}
  </ul>
{% endif %}
HTML
복사

 message.tags → success, error, warning 등의 부트스트랩 클래스와 연결 가능

Bootstrap 적용 예시

{% for message in messages %}
  <div class="alert alert-{{ message.tags }}">
    {{ message }}
  </div>
{% endfor %}
HTML
복사

5. 실습: 회원가입 후 메시지 보여주기

views.py

from django.contrib import messages
from django.shortcuts import render, redirect
from .forms import CustomUserCreationForm

def signup(request):
    if request.method == "POST":
        form = CustomUserCreationForm(request.POST)
        if form.is_valid():
            form.save()
            messages.success(request, "회원가입이 완료되었습니다. 로그인해주세요.")
            return redirect('login')
        else:
            messages.error(request, "입력값을 다시 확인해주세요.")
    else:
        form = CustomUserCreationForm()
    return render(request, "accounts/signup.html", {"form": form})
Python
복사

6. 메시지 수준(Level)

메시지	함수	message.tags 값
성공	messages.success()	success
오류	messages.error()	danger
경고	messages.warning()	warning
정보	messages.info()	info
디버그	messages.debug()	debug

7. 정리

•

메시지 프레임워크는 한 번성 사용자 알림에 적합

•

views.py에서 messages.add() 하고, 템플릿에서 for message in messages

•

Bootstrap과 함께 활용하면 시각적으로 깔끔한 알림 구현 가능

Bootstrap 메시지 템플릿 예시

Bootstrap과 함께 사용하는 Django 메시지 템플릿 예시입니다. 메시지의 종류에 따라 Bootstrap 경고(alert) 클래스를 적용해 사용자에게 시각적으로 알림을 전달할 수 있습니다.

templates/base.html

base.html 템플릿이나 메시지를 출력하고 싶은 템플릿에 아래 코드 삽입

{% if messages %}
  {% for message in messages %}
    <div class="alert alert-{{ message.tags }} alert-dismissible fade show mt-3" role="alert">
      {{ message }}
      <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
    </div>
  {% endfor %}
{% endif %}
HTML
복사

결과 예시

Django 메시지 함수	Bootstrap 클래스 예시 (message.tags)	메시지 색상
messages.success()	alert-success	초록 (성공)
messages.error()	alert-danger	빨강 (에러)
messages.warning()	alert-warning	노랑 (경고)
messages.info()	alert-info	파랑 (정보)

Bootstrap 5용 스크립트가 있어야 작동합니다

템플릿에 Bootstrap JS가 포함되어 있어야 btn-close로 알림 닫기가 작동합니다.

<!-- Bootstrap 5 JS CDN (base.html 하단에 넣기) -->
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
HTML
복사

테스트용 뷰 함수 예시

from django.contrib import messages
from django.shortcuts import redirect

def test_message(request):
    messages.success(request, '성공 메시지입니다!')
    messages.warning(request, '경고 메시지입니다!')
    messages.error(request, '에러 메시지입니다!')
    messages.info(request, '정보 메시지입니다!')
    return redirect('home')
Python
복사

메시지 자동 사라지기 설정 (예: 3초 후)

Django 메시지를 Bootstrap으로 출력할 때 자동으로 일정 시간 뒤 사라지게 하고 싶다면, JavaScript의 setTimeout()을 이용하면 됩니다.

템플릿 코드 (예: base.html)

{% if messages %}
  <div id="django-messages">
    {% for message in messages %}
      <div class="alert alert-{{ message.tags }} alert-dismissible fade show mt-3" role="alert">
        {{ message }}
        <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
      </div>
    {% endfor %}
  </div>

  <script>
    // 3초(3000ms) 후 메시지 자동 닫힘
    setTimeout(function() {
      const alerts = document.querySelectorAll('#django-messages .alert');
      alerts.forEach(function(alert) {
        // Bootstrap 5에서 제공하는 닫기 처리
        const bsAlert = bootstrap.Alert.getOrCreateInstance(alert);
        bsAlert.close();
      });
    }, 3000);
  </script>
{% endif %}
HTML
복사

주의사항

•

Bootstrap 5의 JS가 반드시 포함되어 있어야 합니다:

<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
HTML
복사

•

3000 값을 원하는 시간(ms)으로 변경하면 됩니다 (예: 5초면 5000).