如何将Django表单字段映射到自定义模板单选按钮组并获取选中值？

1. 规范表单字段（可选但更适配） #

虽然用CharField也能接收值，但单选按钮组更适合搭配ChoiceField+RadioSelect组件，自带选项验证，更符合Django的设计逻辑：

class SelectTypeForm(forms.Form):
    # 先定义单选按钮的可选值，可根据实际需求修改
    TYPE_CHOICES = [
        ('article', '文章'),
        ('video', '视频'),
        ('image', '图片'),
    ]
    the_type = forms.ChoiceField(choices=TYPE_CHOICES, widget=forms.RadioSelect)

要是你坚持用原来的CharField也可以，但ChoiceField能自动处理选项合法性校验，更省心。

2. 自定义模板绑定字段核心规则 #

不管用哪种字段类型，自定义模板里的单选按钮必须满足两个条件：

• 所有单选按钮的name属性必须和表单字段名一致（也就是the_type）
• 每个单选按钮的value对应你要传递的选项值

示例模板代码：

<form method="post">
    {% csrf_token %}
    <!-- 自定义单选按钮组 -->
    <div class="radio-group">
        <input type="radio" id="article" name="the_type" value="article" {% if form.the_type.value == 'article' %}checked{% endif %}>
        <label for="article">文章</label>
    </div>
    <div class="radio-group">
        <input type="radio" id="video" name="the_type" value="video" {% if form.the_type.value == 'video' %}checked{% endif %}>
        <label for="video">视频</label>
    </div>
    <div class="radio-group">
        <input type="radio" id="image" name="the_type" value="image" {% if form.the_type.value == 'image' %}checked{% endif %}>
        <label for="image">图片</label>
    </div>
    <button type="submit">确认选择</button>
</form>

其中{% if form.the_type.value == 'xxx' %}checked{% endif %}是用来回显已选中状态的，不需要的话可以删掉。

3. 视图中获取选中值 #

在视图里按常规流程处理表单提交，验证通过后直接从cleaned_data里取值即可：

from django.shortcuts import render
from .forms import SelectTypeForm

def type_select_view(request):
    selected_type = None
    if request.method == 'POST':
        form = SelectTypeForm(request.POST)
        if form.is_valid():
            # 拿到单选按钮选中的值
            selected_type = form.cleaned_data['the_type']
            # 这里写后续业务逻辑，比如保存到数据库或跳转页面
    else:
        form = SelectTypeForm()
    return render(request, 'your_template.html', {'form': form, 'selected_type': selected_type})

关键注意点 #

• 要是用原始的CharField，要确保单选按钮的value长度不超过max_length=100，否则表单验证会失败
• 表单里必须加{% csrf_token %}，不然会触发CSRF防护错误

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