如何在Django手动表单中通过Model生成选择字段？

嘿，我来帮你搞定这个问题！Django其实提供了非常便捷的方式来基于模型生成表单的选择字段，不用手动写一堆重复的<option>标签，下面给你两种常用的方案，你可以根据自己的场景选择：

方法一：用ModelForm（推荐，最省心） #

如果你的表单是用来创建/编辑某个关联了TeachingLanguage的主模型（比如课程、教程这类模型），那ModelForm绝对是最佳选择——它会自动根据模型字段生成对应的表单控件，包括你需要的选择字段。

步骤1：补全模型并定义__str__方法 #

首先确保你的TeachingLanguage模型完整，并且定义__str__方法，这样表单的选择项会显示友好的名称（而不是默认的TeachingLanguage object）：

# models.py
import uuid
from django.db import models

class Category(models.Model):
    name = models.CharField(max_length=100)
    # 其他字段按需添加...

class TeachingLanguage(models.Model):
    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
    category = models.ForeignKey(Category, on_delete=models.CASCADE)
    # 假设你有name字段标识语言，比如"英语""中文"
    name = models.CharField(max_length=50)

    def __str__(self):
        # 返回下拉框要显示的友好文本
        return f"{self.name} ({self.category.name})"

假设你的主模型（比如Course）包含表单里的name、description和teaching_language外键：

class Course(models.Model):
    name = models.CharField(max_length=255)
    description = models.TextField()
    teaching_language = models.ForeignKey(TeachingLanguage, on_delete=models.CASCADE)

步骤2：创建ModelForm类 #

在你的app下新建forms.py，编写Form类：

# forms.py
from django import forms
from .models import Course

class CourseForm(forms.ModelForm):
    class Meta:
        # 指定关联的模型
        model = Course
        # 指定要生成的表单字段
        fields = ['name', 'description', 'teaching_language']
        # 给字段添加你需要的样式类
        widgets = {
            'name': forms.TextInput(attrs={'class': 'form-control'}),
            'description': forms.Textarea(attrs={'class': 'form-control'}),
            'teaching_language': forms.Select(attrs={'class': 'form-control'}),
        }

步骤3：在模板里渲染表单 #

现在你不用手动写<input>、<textarea>、<select>了，直接在模板里渲染表单即可：

<form method="post">
    {% csrf_token %}
    <!-- 用as_p渲染每个字段为p标签，也可以用as_table/as_ul，或者手动渲染单个字段 -->
    {{ form.as_p }}
    <button type="submit" class="btn btn-primary">提交</button>
</form>

如果想要更精细的控制，也可以单独渲染每个字段：

<form method="post">
    {% csrf_token %}
    <div class="form-group">
        {{ form.name.label_tag }}
        {{ form.name }}
    </div>
    <div class="form-group">
        {{ form.description.label_tag }}
        {{ form.description }}
    </div>
    <div class="form-group">
        {{ form.teaching_language.label_tag }}
        {{ form.teaching_language }}
    </div>
    <button type="submit">提交</button>
</form>

方法二：手动创建Form类（无主模型时用） #

如果你的表单不需要关联到某个主模型，只是一个单独的表单，那可以手动创建Form类，用ModelChoiceField来关联TeachingLanguage模型：

# forms.py
from django import forms
from .models import TeachingLanguage

class MyLanguageForm(forms.Form):
    name = forms.CharField(widget=forms.TextInput(attrs={'class': 'form-control'}))
    description = forms.CharField(widget=forms.Textarea(attrs={'class': 'form-control'}))
    teaching_language = forms.ModelChoiceField(
        # 指定要获取的选项集合，这里是所有TeachingLanguage实例
        queryset=TeachingLanguage.objects.all(),
        # 可选：设置默认的空选项文本
        empty_label="请选择教学语言",
        # 添加样式类
        widget=forms.Select(attrs={'class': 'form-control'})
    )

模板渲染方式和上面一样，直接用{{ form.as_p }}或者手动渲染即可。

额外技巧：过滤选项 #

如果不需要显示所有的TeachingLanguage实例，比如只显示某个分类下的语言，可以修改queryset：

teaching_language = forms.ModelChoiceField(
    queryset=TeachingLanguage.objects.filter(category__name="编程"),
    widget=forms.Select(attrs={'class': 'form-control'})
)

这样就能生成符合你需求的下拉选择字段啦，而且Django还会自动处理表单验证、数据保存这些环节，比手动写表单高效太多～

内容的提问来源于stack exchange，提问作者Anuj TBE