forms.SelectDateWidget.empty_label

empty_label

If the DateField is not required, SelectDateWidget will have an empty choice at the top of the list (which is --- by default). You can change the text of this label with the empty_label attribute. empty_label can be a string, list, or tuple. When a string is used, all select boxes will each have an empty choice with this label. If empty_label is a list or tuple of 3 string elements, the select boxes will have their own custom label. The labels should be in this order ('year_label', 'month_label', 'day_label').

# A custom empty label with string
field1 = forms.DateField(widget=SelectDateWidget(empty_label="Nothing"))

# A custom empty label with tuple
field1 = forms.DateField(
    widget=SelectDateWidget(
        empty_label=("Choose Year", "Choose Month", "Choose Day"),
    ),
)
Changed in Django 1.9:

This widget used to be located in the django.forms.extras.widgets package. It is now defined in django.forms.widgets and like the other widgets it can be imported directly from django.forms.

doc_Django
2016-10-09 18:37:06
Comments
Leave a Comment

Please login to continue.