如何为Django表单字段添加aria-label？有无标准实现方法？

错误原因分析 #

你遇到的TypeError是因为**attrs参数属于widget的初始化参数，不是表单字段（Field）的参数**，你把它直接传给了DateField，所以会报错。

标准实现方式：在Widget中设置attrs #

这是Django官方推荐的标准做法，将attrs传递给字段对应的widget，而非字段本身。示例代码如下：

range_start = forms.DateField(
    required=False,
    widget=forms.DateInput(attrs={'aria-label': '起始日期'})
)

如果需要动态设置（比如在表单初始化时根据条件修改），可以在表单的__init__方法中更新widget的attrs：

class YourForm(forms.Form):
    range_start = forms.DateField(required=False, widget=forms.DateInput())

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.fields['range_start'].widget.attrs.update({'aria-label': '起始日期'})

在Crispy Forms布局中设置 #

如果你使用django-crispy-forms，有两种常见方式添加aria-label：

1. 在Layout的Field组件中指定attrs

from crispy_forms.helper import FormHelper
from crispy_forms.layout import Layout, Field

class YourForm(forms.Form):
    range_start = forms.DateField(required=False, widget=forms.DateInput())

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.helper = FormHelper()
        self.helper.layout = Layout(
            Field('range_start', attrs={'aria-label': '起始日期'})
        )

2. 通过Crispy的Field组件简化设置
   可以直接在Field中使用下划线形式的参数（Crispy会自动转换为对应的HTML属性）：

Field('range_start', aria_label='起始日期')

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