Django | models : verbose_name

verbose name

사람이 알아보기 쉽도록 따로 지정하는 이름

 

verbose name 지정하기

장고에서 ForeignKey, ManyToManyField  OneToOneField를 제외하고 모든 필드 타입에서 첫번째 위치 인자로 verbose name을 지정할 수 있다.

따로 지정하지 않으면 장고에서 자동으로 필드명을 이용해서 verbose name을 만든다.(_가 들어가있다면 띄어쓰기로 바꿔준다)

 

first_name = models.CharField("person's first name", max_length=30)

# verbose name: person's first name

 

first_name = models.CharField(max_length=30)

# verbose name: first name

 

ForeignKey, ManyToManyField  OneToOneField의 verbose name

위 필드들의 첫 번째 인자로는 모델 클래스가 들어가야 한다.

그래서 위 필드에서 verbose name을 지정하려면 verbose_name키워드 인자를 사용해야 한다.

 

poll = models.ForeignKey(
    Poll,
    on_delete=models.CASCADE,
    verbose_name="the related poll",
)
sites = models.ManyToManyField(Site, verbose_name="list of sites")
place = models.OneToOneField(
    Place,
    on_delete=models.CASCADE,
    verbose_name="related place",
)

 

verbose name의 첫글자를 대문자로 하지 않는것이 컨벤션이다. 필요하다면 장고에서 자동으로 첫글자를 대문자로 바꿔준다.

 

 

 

 

참고

https://docs.djangoproject.com/en/4.1/topics/db/models/#verbose-field-names