Django中如何为基于模型CharField的表单下拉框添加占位符

核心原理 #

你不需要手写任何自定义校验逻辑，Django 表单自带的必填校验规则可以直接拦截占位符提交：你的se_name字段在模型层设置了blank=False，对应表单字段默认required=True，只要占位选项的 value 设为空字符串，用户未选择有效选项直接提交时，会自动触发必填校验，完全不需要额外编写clean方法或拦截逻辑。

你之前了解到的加choices占位符需要额外校验的问题，本质是因为这类方案大多用None作为占位项的值，而CharField类型的字段默认将空字符串识别为空值，None无法触发自带的必填校验，才需要手写拦截逻辑，换用空字符串作为占位值就可以避开这个问题。

具体修改 #

只需要修改SideEffectForm的__init__方法，在动态生成的选项列表最前面插入占位项即可，其余视图、模型、formset相关代码完全不需要改动：

class SideEffectForm(ModelForm):

    class Meta:
        model = SideEffect
        fields = ['se_name']

    def __init__(self, *args, p, **kwargs):
        super().__init__(*args, **kwargs)

        if p == 'antipsychotic':
            self.fields['se_name'].choices = [
                ("", "请选择副作用"),  # 占位项，value固定为空字符串
                ("insomnia_and_agitation", "Insomnida and Agitation"),
                ("akathisia", "Akathisia"),
                ("dystonia", "Dystonia"),
            ]
            # 如需自定义必填校验的提示文本，可取消注释下一行
            # self.fields['se_name'].error_messages['required'] = '请选择对应的副作用选项'

注意事项 #

• 占位项的value必须使用空字符串，不要使用None：你的字段是CharField类型，Django对字符串类型字段的空值识别默认匹配空字符串，使用None反而会导致自带校验失效，需要额外处理。
• 模型层的SE_CHOICES不需要做任何修改，表单层动态覆盖的choices仅作用于当前表单的渲染和提交校验，模型层原有合法值校验逻辑依然生效，不会出现非法值入库的问题。
• 现有formset的渲染、提交、存库逻辑完全不需要调整，动态传p参数的逻辑也可以正常运行。

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