[Django] ModelForm으로 폼을 간단히! 그런데 레이블을 잃었다...

🧩 상황

Django에서 사용자 입력 폼을 만들 때 forms.Form을 쓰면 유효성 검사나 필드 구성이 번거로워요. 그래서 forms.ModelForm을 사용하면 모델 기반으로 폼을 자동 생성할 수 있어서 매우 간편합니다.

class ReviewForm(forms.ModelForm):
    class Meta:
        model = Review
        fields = "__all__"

위와 같이 쓰면 Review 모델의 모든 필드를 자동으로 폼으로 생성해줍니다. 하지만 문제는...

❗ 레이블(label)이 다 영어 변수명으로 나와요!

변수 명이 이상하다..? 고유의 값으로 나옴

🔍 원인

ModelForm은 Model 클래스에 정의된 필드 이름을 그대로 label로 사용합니다. verbose_name을 모델에서 정의하지 않으면 변수명을 그대로 출력하죠.

🛠 해결 방법: labels와 error_messages 설정

아래처럼 Meta 클래스 안에 labels와 error_messages를 지정해주면 forms.Form 못지않게 친절한 UI와 메시지를 보여줄 수 있어요.

class ReviewForm(forms.ModelForm):
    class Meta:
        model = Review
        fields = "__all__"

        labels = {
            "user_name": "Your Name",
            "review_text": "Your Feedback",
            "rating": "Your Rating"
        }

        error_messages = {
            "user_name": {
                "required": "Your name must not be empty!",
                "max_length": "Please enter a shorter name!"
            }
        }

✅ 결과

내가 원하는 변수명으로 설정 가능!

• 사용자에게 보이는 레이블을 친절하게 지정 가능
• required 조건 위반 시 사용자 친화적인 메시지 제공

---

🔖 요약

항목 방법

모델 기반 폼 생성	forms.ModelForm
레이블 지정	Meta.labels
에러 메시지 지정	Meta.error_messages

---

🏷 추천 태그

#Django #ModelForm #FormValidation #PythonWebDev #웹개발기초