Django Model Choices字段显示问题及解决方案_技术教程

本文旨在解决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 字段的值，例如：

Status: {{ my_object.status }}

那么显示的将是 draft、published 或 archived，而不是 Draft、Published 或 Archived。

解决方案：使用 get_FIELD_display() 方法

Django 提供了一个内置方法 get_FIELD_display()，可以方便地获取 choices 字段的易读名称。其中 FIELD 是你的字段名。

在上面的例子中，我们可以使用 get_status_display() 方法来获取 status 字段的易读名称。

修改模板代码如下：

Status: {{ my_object.get_status_display }}

这样，模板中就会显示 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:




    Django Choices Example


    Status: {{ my_object.get_status_display }}

在这个示例中，my_view 函数创建了一个 MyModel 对象，并将其传递给 my_template.html 模板。模板使用 get_status_display() 方法来显示 status 字段的易读名称。

注意事项

确保你的模型字段定义了 choices 选项。
get_FIELD_display() 方法只能用于定义了 choices 选项的字段。
在模板中使用 get_FIELD_display 时，不要忘记加括号 ()，因为它是一个方法调用。虽然在Django模板语言中，对于无参数的方法调用可以省略括号，但为了代码的可读性和避免潜在的混淆，推荐始终加上括号。