Django Model Choice Fields 显示对应文本而非存储值

django model choice fields 显示对应文本而非存储值

本文旨在解决 Django Model 中使用 CharField 配合 choices 选项时，如何在模板中显示易读的文本标签，而不是数据库中存储的简短值的问题。通过使用 Django 提供的 get_FIELD_display() 方法，开发者可以轻松地在视图层展示清晰的用户选项，提升用户体验。

在使用 Django 开发 Web 应用时，经常会遇到需要让用户从预定义选项中选择的情况。Django 的 CharField 配合 choices 选项可以很好地满足这个需求。然而，通常为了节省存储空间，数据库中存储的往往是选项对应的简短代码，而不是完整的文本标签。如何在前端页面上显示这些文本标签，而不是简短的代码呢？ Django 提供了一个简单而强大的方法来解决这个问题。

使用 get_FIELD_display() 方法

Django 自动为每个定义了 choices 的字段生成一个 get_FIELD_display() 方法。这个方法可以返回与数据库中存储的值对应的文本标签。其中 FIELD 是你的字段名。

例如，如果你的模型中有一个名为 gender 的字段，定义如下：

class StuData(models.Model):
    # ... 其他字段 ...
    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)
    # ... 其他字段 ...

那么，你就可以在模板中使用 stu.get_gender_display() 来获取 gender 字段对应的文本标签，而不是数据库中存储的 'm'、'f' 等值。

模板中的使用示例

假设你在 views.py 中将 StuData 对象传递到模板中，那么你可以在模板中这样使用：

<table id="studata">
    <tr>
        <th>ID Number</th>
        <th>Entry Date</th>
        <th>Gender</th>
        <th>Race</th>
        <th>Ethnicity</th>
        <th>Count</th>
    </tr>
    {% 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 %}
</table>

在这个例子中，{{ stu.get_gender_display }} 会显示 "Male"、"Female"、"Non-Binary" 或 "Unknown"，而不是 'm'、'f'、'x' 或 'u'。同理， {{ stu.get_race_display }} 和 {{ stu.get_ethnicity_display }} 会显示对应的种族和民族的文本标签。

完整示例

以下是一个完整的示例，展示了如何在 Django 项目中使用 get_FIELD_display() 方法：

SONIFY.io

设计和开发音频优先的产品和数据驱动的解决方案

75 查看详情 SONIFY.io

models.py:

from django.db import models
from django.contrib.auth.models import User

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)

    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)

    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) # 修改了 __str__ 方法，返回 id_num

views.py:

from django.shortcuts import render
from django.views.generic.list import ListView
from .models import StuData

class StuDataList(ListView):
    model = StuData
    template_name = 'myapp/studata_list.html' # 修正了模板路径
    context_object_name = 'studata_list' # 显式设置 context_object_name
    paginate_by = 25

    def get_queryset(self): # 修正了 ordering 的方式
        return StuData.objects.all().order_by('id_num')

studata_list.html:

{% extends "./base.html" %}
{% block content %}
Most recent entries

<table id="studata">
    <tr>
        <th>ID Number</th>
        <th>Entry Date</th>
        <th>Gender</th>
        <th>Race</th>
        <th>Ethnicity</th>
        <th>Count</th>
    </tr>
    {% 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 %}
</table>
{% endblock %}

注意事项：

确保 choices 选项定义正确，每个选项都是一个元组，包含存储值和文本标签。
在模板中使用 get_FIELD_display() 方法时，确保 FIELD 是模型中定义的字段名。
如果你的模型中没有定义 choices 选项，那么 get_FIELD_display() 方法将不存在。

总结：

get_FIELD_display() 是 Django 提供的一个非常方便的方法，用于在模板中显示 CharField 字段的文本标签。通过使用这个方法，你可以轻松地在视图层展示清晰的用户选项，提升用户体验。记住，正确定义 choices 选项是使用这个方法的前提。

以上就是Django Model Choice Fields 显示对应文本而非存储值的详细内容，更多请关注其它相关文章！

# 前端 # 信阳网站建设方案表格 # 是一个 # 都是 # 文本框 # 使用这个 # 如何在 # 你可以 # 而非 # 表单 # 而不是 # django # app # cad # go # html # 数据库中 # bb00seo # seo术语站点地图 # 朔州关键词排名意义在哪 # 兰州全域营销推广 # 商品推广策划营销方案 # 云南抖音seo排名费用 # 惠州seo公司解答火星 # 大庆seo教程如何营销 # 甘肃seo公司技巧

相关栏目：【 Google疑问12 】【 Facebook疑问10 】【优化推广96088 】【技术知识133117 】【 IDC资讯59369 】【网络运营7196 】【 IT资讯61894 】

2025-10-19

SQL多表关联如何理解_核心原理解析助你掌握关键方法【教程】 SQL多表连接如何理解_JOIN关联关系详细步骤解析【指导】 SQL多表连接结果异常怎么办_JOIN条件排查方法解析【指导】 SQL索引下推是什么_ICP机制性能提升原理【教程】 SQL跨表统计怎么写_重要技巧总结提升查询效率【技巧】 SQL注入如何防护_完整逻辑拆解助力系统化掌握【技巧】 SQL上传文件信息建模方法_SQL存储文件元数据方案 SQL多语种存储方案设计_SQL字符集选择策略 SQL字符串处理如何编写_重要技巧总结提升查询效率【教学】 SQL去重查询怎么实现_优化思路讲解帮助高效处理数据【技巧】 SQL统计复购用户怎么做_多次行为分析SQL思路【教程】 SQL字符串处理如何编写_优化思路讲解帮助高效处理数据【教程】 SQL动态字段解析技巧_SQL解析JSON多层字段 SQL线上慢SQL如何治理_规范与工具实践总结【技巧】 SQL表结构如何演进_兼容老数据设计思路【教程】 SQL排序规则如何设置_ORDERBY排序原理与性能说明【指导】 SQL去重查询怎么实现_真实案例解析强化复杂查询思维【教学】 SQL按字段范围分批处理_SQL避免长时间锁表 SQL统计不同字段组合数量_多列聚合查询技巧【技巧】 SQL多字段去重怎么处理_GROUPBY去重思路说明【教学】

了解您产品搜索量及市场趋势，制定营销计划

同行竞争及网站分析保障您的广告效果

点击免费数据支持

提交您的需求，1小时内享受我们的专业解答。

运城市盐湖区信雨科技有限公司

运城市盐湖区信雨科技有限公司是一家深耕海外推广领域十年的专业服务商，作为谷歌推广与Facebook广告全球合作伙伴，聚焦外贸企业出海痛点，以数字化营销为核心，提供一站式海外营销解决方案。公司凭借十年行业沉淀与平台官方资源加持，打破传统外贸获客壁垒，助力企业高效开拓全球市场，成为中小企业出海的可靠合作伙伴。