
本文旨在解决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
| 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 }} |
示例代码解释
- {{ 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字段显示问题的首选方案。










