Django ModelForm组件属性无法传递到模板及日期格式设置问题

问题1：ModelForm配置的widget属性不生效 #

根因 #

1. 视图未绑定自定义表单：你定义了UserDeliveryForm但在DeliveryCreateView中没有指定form_class，仅配置了fields参数，Django会自动生成默认ModelForm，不会加载你自定义的widget配置。
2. 模板手动覆盖字段渲染：你在模板中对document、delivery_status字段手动编写了<input>标签，没有使用{{ form.字段名 }}渲染，Form中配置的属性自然不会生效。
3. 存在拼写错误：视图中request.FILES.getlist("decument")的字段名拼写错误，正确为document。

修复步骤 #

1. 调整视图代码：

class DeliveryCreateView(LoginRequiredMixin, UserPassesTestMixin, CreateView):
    model = Delivery
    form_class = UserDeliveryForm # 指定自定义表单
    template_name = "deliveries/customer/edit_deliveries.html"
    success_url = reverse_lazy("account:dashboard")

    def test_func(self):
        return self.request.user.is_customer and self.request.user.is_active

    def post(self, request, *args, **kwargs):
        form_class = self.get_form_class()
        form = self.get_form(form_class)
        files = request.FILES.getlist("document") # 修复字段拼写错误
        # 多文件上传需要额外编写逻辑保存所有文件，此处仅修复拼写问题
        if form.is_valid():
            return self.form_valid(form)
        else:
            return self.form_invalid(form)

    def form_valid(self, form):
        form.instance.user_id = self.request.user.id
        return super().form_valid(form)

2. 调整模板代码：删除手动编写的document、delivery_status的<input>标签，统一使用{{ form.document }}、{{ form.delivery_status }}渲染字段。
3. 额外优化：原模板中使用JS提交表单后立即reset，会导致部分浏览器未完成提交就清空数据，建议直接将按钮改为<button type="submit" class="xxx">，删除多余的提交JS逻辑。

问题2：日期选择器格式不满足dd/mm/yyyy需求 #

根因 #

原生HTML5的type="date"输入框的显示格式由浏览器的系统区域语言决定，后端仅识别yyyy-mm-dd格式的提交值，无法直接指定显示格式。

修复方案 #

方案1（兼容性最佳）：使用自定义日期选择插件

引入bootstrap-datepicker等第三方日期组件，配置显示格式为dd/mm/yyyy，修改Form中的日期字段配置：

from django.forms.widgets import DateInput

class UserDeliveryForm(forms.ModelForm):
    operation_date = forms.DateField(
        input_formats=['%d/%m/%Y', '%Y-%m-%d'], # 兼容多种输入格式
        label=_("desired pickup date")
    )
    class Meta:
        model = Delivery
        fields = [ ... ] # 保持原有fields配置不变
        widgets = {
            'operation_date': DateInput(
                attrs={
                    'type': 'text', # 关闭原生date控件
                    'class': 'form-control mb-2 delivery-form datepicker',
                    'placeholder': 'dd/mm/yyyy'
                }
            )
        }
    # __init__中无需再重复配置operation_date的attrs

在模板中引入插件资源后，初始化日期选择器：

$('.datepicker').datepicker({
    format: 'dd/mm/yyyy',
    autoclose: true
})

方案2（依赖浏览器配置）：调整Django本地化设置

在settings.py中添加以下配置，适配支持区域识别的浏览器：

USE_L10N = True
DATE_FORMAT = 'd/m/Y'
DATE_INPUT_FORMATS = ['%d/%m/%Y', '%Y-%m-%d']

内容的提问来源于stack exchange，提问作者E.Mohammed