如何修改Django DateRangeField组件默认模板添加起止时间子标签

实现方法 #

这里提供两种方案，可根据你的使用场景选择：

方案1：模板内直接拆分渲染（轻量，适合单页面使用）

无需修改Python代码，直接调整你的模板渲染逻辑即可，DateRangeField对应的表单部件内置了两个子输入框，可通过下标直接调用分别渲染：

{% with field=form.date_range %}
{{ field.label }}
<div class="date-range-group">
    <div class="range-input-item">
        <label>开始时间</label>
        {{ field.subwidgets.0 }}
    </div>
    <div class="range-input-item">
        <label>结束时间</label>
        {{ field.subwidgets.1 }}
    </div>
</div>
{% endwith %}

该方案不会影响原有表单的验证、提交逻辑，子部件的name、id等属性和默认渲染完全一致。

方案2：自定义全局部件（适合所有DateRangeField统一渲染样式）

如果需要全局所有的日期范围字段都带标签，可重写默认部件：

1. 首先在你的APP下新建widgets.py，定义自定义部件：

from django.contrib.postgres.forms.widgets import DateRangeWidget

class LabeledDateRangeWidget(DateRangeWidget):
    # 指定自定义渲染模板
    template_name = 'widgets/labeled_date_range.html'

2. 新建模板文件templates/widgets/labeled_date_range.html，写入自定义渲染逻辑：

<div class="date-range-widget">
    <div class="range-item">
        <label>开始时间</label>
        {{ widget.subwidgets.0 }}
    </div>
    <div class="range-item">
        <label>结束时间</label>
        {{ widget.subwidgets.1 }}
    </div>
</div>

3. 在你的表单类中指定使用该自定义部件：

from django import forms
from .models import MyModel
from .widgets import LabeledDateRangeWidget

class MyModelForm(forms.ModelForm):
    class Meta:
        model = MyModel
        fields = '__all__'
        widgets = {
            'date_range': LabeledDateRangeWidget
        }

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