From 7e2c87809ca601b7290203dd54ba3e9f90a702bd Mon Sep 17 00:00:00 2001 From: gyx1000 Date: Thu, 29 May 2014 17:15:01 +0200 Subject: Fixed #22684 -- Amended SelectDateWidget.empty_label to accept a tuple of values. Thanks danielsamuels for the report --- docs/ref/forms/widgets.txt | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) (limited to 'docs/ref/forms') diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt index cf309f0298..7ed235b9e3 100644 --- a/docs/ref/forms/widgets.txt +++ b/docs/ref/forms/widgets.txt @@ -787,9 +787,20 @@ Composite widgets .. versionadded:: 1.8 If the :class:`~django.forms.DateField` is not required, - :class:`SelectDateWidget` will have an empty choice at the top of - the list. You can change the text of this label - (which is ``---`` by default) with the ``empty_label`` attribute:: + :class:`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 + .. code-block:: python + + # 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")) -- cgit v1.3