本文旨在解决Django模型中使用`choices`字段时，在模板中显示实际值而非存储值的问题。我们将通过示例代码，详细讲解如何利用Django内置方法`get_FIELD_display()`来正确显示`choices`字段的易读名称。
在使用Django进行Web开发时，经常会遇到需要在模型中使用预定义选项的情况。Django提供了choices选项来方便地实现这一功能。然而，直接在模板中显示choices字段的值，通常会显示存储在数据库中的缩略值，而不是用户友好的完整名称。本文将介绍如何解决这个问题，确保在模板中显示choices字段的完整名称。
理解 Django choices 字段
choices 是 Django 模型字段的一个选项，用于限制字段的可选值。它接受一个由二元元组组成的列表，每个元组的第一个元素是存储在数据库中的值，第二个元素是在表单或模板中显示的易读名称。
例如：
class MyModel(models.Model):
STATUS_CHOICES = [
('draft', 'Draft'),
('published', 'Published'),
('archived', 'Archived'),
]
status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='draft')在这个例子中，status 字段只能取 draft、published 或 archived 这三个值。
问题：直接显示存储值
如果在模板中直接显示 status 字段的值，例如：
<p>Status: {{ my_object.status }}</p>那么显示的将是 draft、published 或 archived，而不是 Draft、Published 或 Archived。
解决方案：使用 get_FIELD_display() 方法
Django 提供了一个内置方法 get_FIELD_display()，可以方便地获取 choices 字段的易读名称。其中 FIELD 是你的字段名。
在上面的例子中，我们可以使用 get_status_display() 方法来获取 status 字段的易读名称。
修改模板代码如下：
<p>Status: {{ my_object.get_status_display }}</p>这样，模板中就会显示 Draft、Published 或 Archived，而不是存储值。
示例：完整代码
下面是一个完整的示例，包含模型、视图和模板代码：
models.py:
from django.db import models
class MyModel(models.Model):
STATUS_CHOICES = [
('draft', 'Draft'),
('published', 'Published'),
('archived', 'Archived'),
]
status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='draft')
def __str__(self):
return f"Status: {self.get_status_display()}"views.py:
from django.shortcuts import render
from .models import MyModel
def my_view(request):
my_object = MyModel.objects.create(status='published') # 创建一个示例对象
return render(request, 'my_template.html', {'my_object': my_object})my_template.html:
<!DOCTYPE html>
<html>
<head>
<title>Django Choices Example</title>
</head>
<body>
<p>Status: {{ my_object.get_status_display }}</p>
</body>
</html>在这个示例中，my_view 函数创建了一个 MyModel 对象，并将其传递给 my_template.html 模板。模板使用 get_status_display() 方法来显示 status 字段的易读名称。
注意事项
- 确保你的模型字段定义了 choices 选项。
- get_FIELD_display() 方法只能用于定义了 choices 选项的字段。
- 在模板中使用 get_FIELD_display 时，不要忘记加括号 ()，因为它是一个方法调用。 虽然在Django模板语言中，对于无参数的方法调用可以省略括号，但为了代码的可读性和避免潜在的混淆，推荐始终加上括号。
总结
通过使用 Django 的 get_FIELD_display() 方法，可以轻松地在模板中显示 choices 字段的易读名称，从而提升用户体验。 这种方法简单易用，无需编写额外的代码或查询数据库。希望本文能帮助你更好地理解和使用 Django 的 choices 字段。
