Django Admin界面FloatField如何允许逗号作为十进制分隔符进行前端校验

方案1：最小改造成本（无需自定义字段/组件） #

无需重写FloatField或自定义组件，仅在表单清洗阶段新增逗号预处理逻辑即可，全局本地化配置不会影响该逻辑：

from django import forms
from django.forms import FloatField, TextInput

class ExampleAdminForm(forms.ModelForm):
    class Meta:
        model = Example

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        for key, field in self.fields.items():
            if isinstance(field, FloatField):
                # 使用TextInput并关闭前端默认校验，避免浏览器规则拦截逗号输入
                self.fields[key].widget = TextInput(attrs={"novalidate": ""})
    
    def clean(self):
        cleaned_data = super().clean()
        for field_name, field in self.fields.items():
            if isinstance(field, FloatField):
                input_val = self.data.get(field_name, "")
                if isinstance(input_val, str) and "," in input_val:
                    # 替换逗号为小数点后复用原生FloatField校验逻辑
                    try:
                        cleaned_data[field_name] = field.to_python(input_val.replace(",", "."))
                    except forms.ValidationError:
                        self.add_error(field_name, "请输入合法数字，支持逗号或小数点作为分隔符")
        return cleaned_data

该方案完全复用Django原生校验规则，仅新增1步字符替换预处理，不需要修改全局配置，适配所有FloatField字段。

方案2：新增前端实时校验（可选） #

如果需要用户输入时就给出格式提示，避免提交后才返回报错，可给Admin配置自定义JS实现前端校验：

1. 配置Admin类引入自定义JS

from django.contrib import admin

class ExampleAdmin(admin.ModelAdmin):
    form = ExampleAdminForm
    class Media:
        js = ("js/float_comma_validator.js",)

2. 新增静态文件static/js/float_comma_validator.js

document.addEventListener('DOMContentLoaded', function() {
    const floatInputs = document.querySelectorAll('input[type="text"]');
    floatInputs.forEach(input => {
        input.addEventListener('input', function() {
            // 自定义正则：支持整数、逗号/小数点为分隔符的小数
            const validRule = /^\d*[,.]?\d*$/;
            if (!validRule.test(this.value) && this.value !== '') {
                this.setCustomValidity('请输入合法数字，支持逗号或小数点作为分隔符');
            } else {
                this.setCustomValidity('');
            }
        });
    });
});

补充说明 #

之前在settings.py中配置DECIMAL_SEPARATOR不生效的原因是，该配置仅在开启USE_L10N = True且对应字段显式设置localize=True时才会生效，且仍然会受全局本地化规则影响，稳定性低于上述自定义预处理方案。

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