django-yearmonth-widget组件优化需求：月份显示为名称、设置默认选择项及字段标签

我来帮你逐个搞定这三个需求，都是这个widget的常见配置调整，上手很简单：

1. 将月份以名称形式显示而非数字 #

默认的月份选项是数字，我们可以通过给DjangoYearMonthWidget的month_widget参数传递一个自定义的Select组件，用月份名称作为选项文本。Django内置了MONTH_NAMES（全称）和MONTH_ABBREVIATIONS（缩写）可以直接用：

首先导入必要的模块：

from django.utils.dates import MONTH_NAMES
from django_yearmonth_widget.widgets import DjangoYearMonthWidget

然后修改表单的widget配置：

widgets = {
    'file_upload_datetime': DjangoYearMonthWidget(
        # 用月份全称作为选项，比如"一月"、"二月"（中文环境下）或"January"、"February"（英文）
        month_widget=forms.Select(
            choices=[(i, name) for i, name in enumerate(MONTH_NAMES) if i != 0]
        )
    ),
    'file_remote': forms.HiddenInput()
}

如果想要月份缩写，把MONTH_NAMES换成MONTH_ABBREVIATIONS即可。

2. 给年份和月份选择框添加默认提示选项 #

要让下拉框默认显示--请选择年份--、--请选择月份--这类提示，只需要在对应的choices前面添加一个空选项即可：

from datetime import datetime
from django.utils.dates import MONTH_NAMES
from django_yearmonth_widget.widgets import DjangoYearMonthWidget

# 表单内的widget配置
widgets = {
    'file_upload_datetime': DjangoYearMonthWidget(
        # 自定义年份选择框，添加默认提示，年份范围可按需调整
        year_widget=forms.Select(
            choices=[('', '--请选择年份--')] + [(year, year) for year in range(2020, datetime.date.today().year + 2)]
        ),
        # 自定义月份选择框，添加默认提示
        month_widget=forms.Select(
            choices=[('', '--请选择月份--')] + [(i, name) for i, name in enumerate(MONTH_NAMES) if i != 0]
        )
    ),
    'file_remote': forms.HiddenInput()
}

这里年份范围我设置为2020到明年，你可以根据业务需求调整起始和结束年份。

3. 为file_upload_datetime字段设置自定义标签 #

有两种简单的方式设置字段标签：

方法一：在表单Meta类中定义labels字典 #

直接在Meta类里添加labels属性，指定字段的显示标签：

class FileUploadForm(forms.ModelForm):
    file = forms.FileField(required=True,widget=forms.ClearableFileInput(attrs={'multiple':True}), label='Select Files')
    file_remote = forms.FileField(widget=forms.ClearableFileInput(attrs={'multiple':True}), required=False)
    
    class Meta():
        model = FileUpload
        fields= ('file_upload_datetime','file','file_remote')
        widgets = {
            # 上面的widget配置
            'file_remote':forms.HiddenInput()
        }
        labels = {
            'file_upload_datetime': '选择上传年月',  # 这里替换成你想要的标签文本
        }

方法二：显式定义字段时指定label #

如果需要更灵活的配置，可以直接在表单中显式声明file_upload_datetime字段并指定label：

class FileUploadForm(forms.ModelForm):
    file = forms.FileField(required=True,widget=forms.ClearableFileInput(attrs={'multiple':True}), label='Select Files')
    file_remote = forms.FileField(widget=forms.ClearableFileInput(attrs={'multiple':True}), required=False)
    # 显式定义字段并设置标签和widget
    file_upload_datetime = forms.DateField(
        widget=DjangoYearMonthWidget(
            # 这里放之前的widget配置
            year_widget=forms.Select(choices=[('', '--请选择年份--')] + [(y, y) for y in range(2020, datetime.date.today().year + 2)]),
            month_widget=forms.Select(choices=[('', '--请选择月份--')] + [(i, name) for i, name in enumerate(MONTH_NAMES) if i != 0])
        ),
        label='选择上传年月'
    )
    
    class Meta():
        model = FileUpload
        fields= ('file_upload_datetime','file','file_remote')
        widgets = {
            'file_remote':forms.HiddenInput()
        }

把这些配置整合起来，你的表单就能完美实现所有需求啦！

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