Django Form

<aside> 🚫

[HTML Form의 한계]

• 지금까지 사용자로부터 데이터를 제출 받기 위해 활용한 방법이지만, 비정상적 혹은 악의적인 요청을 필터링 할 수 없음

  ⇒ 유효한 데이터인지에 대한 확인이 필요하다

</aside>

• 유효성 검사란?

  • 수집한 데이터가 정확하고 유효한지 확인하는 과정
  • ex) 필수 입력 값이 비어 있거나 잘못된 이메일 형식을 입력하면 오류를 알려줌

  ⇒ 그런데 이런 유효성 검사를 구현하기 위해서는 입력 값, 형식, 중복, 범위 등 많은 걸 고려해야 함

  이런 과정과 기능을 직접 개발하지 않고 Django가 제공하는 Form을 사용

Form class

• Django Form
  • 사용자 입력 데이터를 수집하고, 처리 및 유효성 검사를 수행하기 위한 도구
  • 유효성 검사를 단순화하고 자동화할 수 있는 기능을 제공함
  • 사용자가 잘못 입력한 데이터는 자동으로 오류로 처리되어 안전성을 높임
  • 개발자는 이를 통해 빠르고 일관된 입력 검증 기능을 구현할 수 있음
• Form Class 정의

  • Form Class를 상속 받아 내용과 제목에 대한 사용자 입력을 받는 ArticleForm을 정의하는 방법

    # articles/forms.py
    
    from django import forms
    
    class ArticleForm(forms.Form):
        title = forms.CharField(max_length=10)
        content = forms.CharField()
    

  • Form Class를 적용한 새로운 Logic

    • view 함수 new 변경

      # articles/views.py
      
      from .forms import ArticleForm
      
      def new(request):
          form = ArticleForm()
          context = {
              'form': form,
          }
          return render(request, 'articles/new.html', context)
      

    • new 페이지에서 form 인스턴스 출력

      <!-- articles/new.html -->
      
      <h1>NEW</h1>
      <form action="{% url 'articles:create' %}" method="POST">
        {% csrf token %}
        {{ form }}
        <input type="submit">
      </form>
      

      

  • Form class가 대체하는 것

    

Widgets

: HTML ‘input’ element의 표현을 담당함. Django Form의 widgets은 각 필드가 HTML에서 어떻게 렌더링 될지를 결정함

• Widget 적용

  • Widget은 단순히 input 요소의 속성 및 출력되는 부분을 변경하는 것

    

Django ModelForm

<aside> 📌

Form vs ModelForm

• Form

  • 사용자 입력 데이터를 DB에 저장하지 않을 때 (ex-검색, 로그인)

• ModelForm

  • 사용자 입력 데이터를 DB에 저장해야 할 때 (ex-게시글 작성, 회원가입) </aside>

• ModelForm

  • Model과 연결된 Form을 자동으로 생성해주는 기능을 제공
  • ModelForm은 Form 클래스와 Model 클래스를 결합한 형태로, 모델 필드를 기반으로 입력 폼을 자동으로 생성해줌
  • 데이터 수집과 저장 과정을 동시에 처리할 수 있도록 해줌

• ModelForm class 정의

  • 기존 ArticleForm 클래스 수정

    # articles/forms.py
    
    from django import forms
    from .models import Article
    
    class ArticleForm(forms.ModelForm):
        class Meta:
            model = Article
            fields = '__all__'
    

Meta class

: ModelForm 의 정보를 작성하는 곳

• Meta class는 ModelForm 내부에서 어떤 모델과 연결할지, 어떤 필드를 사용할지 등을 정의하는 설정 공간임

• 폼의 동작 방식을 제어하는 핵심 역할을 함

• fields 및 exclude 속성

  • exclude 속성을 사용하여 모델에서 포함하지 않도록 필드를 지정할 수도 있음

    # articles/forms.py
    
    class ArticleForm(forms.ModelForm):
        class Meta:
            model = Article
            exclude = ('title',)
    

• Meta class 주의사항

  • Django에서 ModelForm에 대한 추가 정보나 속성을 작성하는 클래스 구조를 Meta 클래스로 작성했을 뿐이며, 파이썬의 inner class와 같은 문법적인 관점으로 접근하지 말 것!