Django表单：下拉仅一个选项时自动选中首个选项的简便方案

嘿，这个需求我之前刚好折腾过，完全不用修改所有表单的Widget就能搞定，给你几个实用的方案：

方案1：在单个Form/ModelForm的__init__方法中处理 #

不管是普通下拉框还是外键对应的ModelChoiceField，都可以在表单的初始化方法里统一检查并设置默认值：

普通Form示例 #

from django import forms

class MyForm(forms.Form):
    # 普通下拉框字段
    status = forms.ChoiceField(choices=[], required=True)
    # 外键关联字段
    category = forms.ModelChoiceField(queryset=Category.objects.all(), required=True)

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        
        for field_name, field in self.fields.items():
            # 处理ModelChoiceField（外键字段）
            if isinstance(field, forms.ModelChoiceField):
                if field.queryset.count() == 1:
                    # 直接把唯一选项的主键设为初始值
                    self.initial[field_name] = field.queryset.first().pk
            # 处理普通ChoiceField
            elif isinstance(field, forms.ChoiceField):
                # 过滤掉默认的空选项（如果有的话）
                valid_choices = [choice for choice in field.choices if choice[0] != '']
                if len(valid_choices) == 1:
                    self.initial[field_name] = valid_choices[0][0]

ModelForm示例 #

如果是基于模型的表单，逻辑是一样的，字段由模型自动生成：

from django.forms import ModelForm
from .models import Post

class PostForm(ModelForm):
    class Meta:
        model = Post
        fields = ['status', 'category']

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        
        for field_name, field in self.fields.items():
            if isinstance(field, forms.ModelChoiceField):
                if field.queryset.count() == 1:
                    self.initial[field_name] = field.queryset.first().pk
            elif isinstance(field, forms.ChoiceField):
                valid_choices = [choice for choice in field.choices if choice[0] != '']
                if len(valid_choices) == 1:
                    self.initial[field_name] = valid_choices[0][0]

方案2：写一个基类表单，所有表单继承它 #

如果项目里有很多表单需要这个功能，没必要每个都写一遍__init__，可以封装一个基类，其他表单直接继承：

基类Form #

from django import forms

class AutoSelectSingleChoiceForm(forms.Form):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        
        for field_name, field in self.fields.items():
            if isinstance(field, forms.ModelChoiceField):
                if field.queryset.count() == 1:
                    self.initial[field_name] = field.queryset.first().pk
            elif isinstance(field, forms.ChoiceField):
                valid_choices = [choice for choice in field.choices if choice[0] != '']
                if len(valid_choices) == 1:
                    self.initial[field_name] = valid_choices[0][0]

基类ModelForm #

from django.forms import ModelForm

class AutoSelectSingleChoiceModelForm(ModelForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        
        for field_name, field in self.fields.items():
            if isinstance(field, forms.ModelChoiceField):
                if field.queryset.count() == 1:
                    self.initial[field_name] = field.queryset.first().pk
            elif isinstance(field, forms.ChoiceField):
                valid_choices = [choice for choice in field.choices if choice[0] != '']
                if len(valid_choices) == 1:
                    self.initial[field_name] = valid_choices[0][0]

使用示例 #

# 普通表单继承基类
class MyForm(AutoSelectSingleChoiceForm):
    status = forms.ChoiceField(choices=[('active', 'Active')])
    category = forms.ModelChoiceField(queryset=Category.objects.filter(is_active=True))

# ModelForm继承基类
class PostForm(AutoSelectSingleChoiceModelForm):
    class Meta:
        model = Post
        fields = ['status', 'category']

注意事项 #

• 如果你的下拉框字段设置了empty_label=None（没有空选项），普通ChoiceField可以直接判断len(field.choices) == 1，不用过滤空选项。
• 对于必填字段（required=True），Django默认不会显示空选项，这时候判断逻辑也可以简化。

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