Django Model Choices字段显示问题解决方案

本文旨在解决Django Model中使用`choices`字段时，在模板中显示对应文本而非存储值的问题。我们将通过示例代码演示如何使用`get_FIELD_display()`方法，方便地在模板中展示可读性更强的选项文本，提升用户体验。

在Django开发中，我们经常使用choices选项来限制字段的取值范围，并提供友好的用户界面。例如，在用户注册时，性别字段通常会提供“男”、“女”、“其他”等选项。然而，在数据库中，我们通常存储更短的字符，如'm'、'f'、'x'，以节省空间。当我们需要在模板中显示这些字段时，如何将存储值转换为对应的文本呢？Django提供了一个便捷的方法：get_FIELD_display()。

问题描述

假设我们有一个StuData模型，其中包含gender、race和ethnicity等字段，这些字段都使用了choices选项。在studata_list.html模板中，我们直接显示这些字段的值，但希望显示的是选项文本，而不是数据库中存储的缩写。

解决方案

Django为每个定义了choices的字段自动生成了一个get_FIELD_display()方法，其中FIELD是字段名。这个方法返回与字段当前值对应的可读性强的文本。

因此，在studata_list.html模板中，我们可以使用get_gender_display、get_race_display和get_ethnicity_display方法来显示对应的文本。

修改后的studata_list.html模板

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


    {% for stu in studata_list %}
    
    {% endfor %}
    

    

        
ID Number
        
Entry Date
        
Gender
        
Race
        
Ethnicity
        
Count
    

    

        
{{ stu.id_num }}
        
{{ stu.entry_date }}
        
{{ stu.stu.get_gender_display }}
        
{{ stu.stu.get_race_display }}
        
{{ stu.stu.get_ethnicity_display }}
        
{{ stu.occupants }}
    

{% endblock %}

示例代码解释

• {{ stu.get_gender_display }}：调用StuData对象stu的get_gender_display方法，返回gender字段对应的文本，例如 "Male"、"Female" 或 "Non-Binary"。
• {{ stu.get_race_display }}：调用StuData对象stu的get_race_display方法，返回race字段对应的文本，例如 "African-American"、"Asian/Pacific Islander" 或 "White"。
• {{ stu.get_ethnicity_display }}：调用StuData对象stu的get_ethnicity_display方法，返回ethnicity字段对应的文本，例如 "Hispanic Origin" 或 "Not of Hispanic Origin"。

注意事项

• 确保在模型中正确定义了choices选项，并且选项的键值对与数据库中存储的值一致。
• get_FIELD_display()方法只能用于定义了choices的字段。

总结

通过使用Django提供的get_FIELD_display()方法，我们可以轻松地在模板中显示choices字段对应的文本，而无需编写额外的逻辑。这不仅提高了代码的可读性，也提升了用户体验。该方法简单易用，是处理choices字段显示问题的首选方案。