Django Model Choice Fields 显示完整名称教程_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Django Model Choice Fields 显示完整名称教程

2025-10-19

浏览次数：次

返回列表

django model choice fields 显示完整名称教程

本文档旨在解决 Django 模型中使用 `CharField` 和 `choices` 属性时，如何在模板中显示选项的完整名称，而不是存储在数据库中的缩写值。通过 `get_FIELD_display()` 方法，可以轻松地在模板中呈现更具可读性的选项名称。

在 Django 开发中，我们经常需要在模型中使用下拉选择框来限制用户输入。为了节省存储空间，通常会使用简短的字符串来表示选项值，而在界面上显示更友好的完整名称。本文将介绍如何利用 Django 提供的 get_FIELD_display() 方法，在模板中轻松地显示这些完整名称。

使用 choices 属性定义选项

首先，在 models.py 文件中，使用 choices 属性定义 CharField 字段的选项。choices 属性接受一个元组列表，其中每个元组包含两个元素：

第一个元素是存储在数据库中的实际值（通常是简短的字符串）。
第二个元素是将在界面上显示的完整名称。

例如：

from django.db import models

class StuData(models.Model):
    id_num = models.IntegerField(primary_key=True)
    entry_date = models.DateTimeField('Date of Entry')
    MALE = 'm'
    FEMALE = 'f'
    OTHER = 'x'
    GENUNK = 'u'
    GENDER_SELECTIONS = [
        (MALE,'Male'),
        (FEMALE,'Female'),
        (OTHER,'Non-Binary'),
        (GENUNK,'Unknown'),
    ]
    gender = models.CharField(max_length=1, choices=GENDER_SELECTIONS)
    ## Build the selections for the race field
    AFR_RACE = 'AA'
    ASI_RACE = 'AS'
    WHI_RACE = 'WH'
    UNK_RACE = 'UN'
    RACE_SELECTIONS = [
        (AFR_RACE, 'African-American'),
        (ASI_RACE, 'Asian/Pacific Islander'),
        (WHI_RACE, 'White'),
        (UNK_RACE, 'Unknown Race'),
    ]
    race = models.CharField(max_length=2, choices=RACE_SELECTIONS)
    ## Build the selections for the ethnicity field
    HSP = 'HIS'
    NHP = 'NHP'
    UNK = 'UNE'
    ETHNICITY_SELECTIONS = [
        (HSP, 'Hispanic Origin'),
        (NHP, 'Not of Hispanic Origin'),
        (UNK, 'Unknown Ethnicity'),
    ]
    ethnicity = models.CharField(max_length=10, choices=ETHNICITY_SELECTIONS)
    stu_count = models.IntegerField(default=1)
    user = models.ForeignKey(User, on_delete=models.CASCADE)

    class Meta:
        ordering = ["id_num"]

    def __str__(self):
        return str(self.id_num) # 修改为返回id_num字符串

注意事项：

AI Surge Cloud

低代码数据分析平台，帮助企业快速交付深度数据

87 查看详情 AI Surge Cloud

确保 max_length 属性足够存储最长的完整名称，或者存储数据库中实际的值。
choices 属性是可选的，但强烈建议使用它来规范用户输入。
__str__ 方法需要返回一个字符串，因此需要将 self.id_num 转换为字符串。

在模板中使用 get_FIELD_display() 方法

Django 提供了一个方便的方法 get_FIELD_display()，可以用来获取 choices 属性中与数据库值对应的完整名称。在模板中，可以通过以下方式使用该方法：

{% for stu in studata_list %}
    <tr>
        <td>{{ stu.id_num }}</td>
        <td>{{ stu.entry_date }}</td>
        <td>{{ stu.get_gender_display }}</td>
        <td>{{ stu.get_race_display }}</td>
        <td>{{ stu.get_ethnicity_display }}</td>
        <td>{{ stu.stu_count }}</td>
    </tr>
{% endfor %}