ウィジェットは、Django が HTML の input 要素の表現方法です。ウィジェットは、HTML のレンダリングをコントロールして、ウィジェットに合致する GET/POST ディクショナリからデータを取り出します。
\nBuilt-in widgets によって作られる HTML は、<!DOCTYPE html> を対象とした HTML5 シンタックスを使います。例えば、XHTML スタイルである checked='checked' よりも、checked といった boolean 属性を使います。
フォーム上でフィールドを指定したときは、Django は描画されるデータのタイプに適したデフォルトのウィジェットを使用します。各フィールドで使われるウィジェットを調べるためには、 ビルトインの Field クラス をご覧ください。
\nHowever, if you want to use a different widget for a field, you can\nuse the widget argument on the field definition. For example:
from django import forms\n\nclass CommentForm(forms.Form):\n name = forms.CharField()\n url = forms.URLField()\n comment = forms.CharField(widget=forms.Textarea)\nこれは、comment のフォームに対して、デフォルトの TextInput ウィジェットではなく、より大きなサイズの Textarea ウィジェットを指定しています。
多くのウィジェットは、省略可能な追加の引数を持っています; これらは、フィールド上でウィジェットを定義する際にセットできます。以下の例では、SelectDateWidget に対して years 属性がセットされます:
from django import forms\n\nBIRTH_YEAR_CHOICES = ['1980', '1981', '1982']\nFAVORITE_COLORS_CHOICES = [\n ('blue', 'Blue'),\n ('green', 'Green'),\n ('black', 'Black'),\n]\n\nclass SimpleForm(forms.Form):\n birth_year = forms.DateField(widget=forms.SelectDateWidget(years=BIRTH_YEAR_CHOICES))\n favorite_colors = forms.MultipleChoiceField(\n required=False,\n widget=forms.CheckboxSelectMultiple,\n choices=FAVORITE_COLORS_CHOICES,\n )\n使用可能なウィジェットとそれぞれの引数の詳細については、ビルトインのウィジェット をご覧ください。
\nSelect ウィジェットを継承したウィジェットLink to this heading#Select ウィジェットを継承したウィジェットは、選択肢を扱います。これらはユーザーに選択肢のリストを提示します。提示される選択肢はウィジェットによって異なります; Select ウィジェット自体は、<select> HTML のリスト表現を使い、一方で RadioSelect はラジオボタンを使います。
Select ウィジェットは、 ChoiceField フィールド上でデフォルトで使われます。ウィジェットに表示される選択肢は ChoiceField から継承され、 ChoiceField.choices を変更すると Select.choices が更新されます。たとえば:
>>> from django import forms\n>>> CHOICES = [('1', 'First'), ('2', 'Second')]\n>>> choice_field = forms.ChoiceField(widget=forms.RadioSelect, choices=CHOICES)\n>>> choice_field.choices\n[('1', 'First'), ('2', 'Second')]\n>>> choice_field.widget.choices\n[('1', 'First'), ('2', 'Second')]\n>>> choice_field.widget.choices = []\n>>> choice_field.choices = [('1', 'First and only')]\n>>> choice_field.widget.choices\n[('1', 'First and only')]\nとは言うものの、choices 属性を提供するウィジェットは、選択肢に基づかないフィールド -- 例えば CharField -- とともに使うことができますが、選択肢がモデルに継承され、単に表示されるだけのウィジェットではないときには、ChoiceField に基づいたフィールドを使うことをお勧めします。
When Django renders a widget as HTML, it only renders very minimal markup -\nDjango doesn't add class names, or any other widget-specific attributes. This\nmeans, for example, that all TextInput widgets will appear the same\non your web pages.
ウィジェットをカスタマイズする方法には 2 つあります: ウィジェットごとのインスタンス と ウィジェットごとのクラス です。
\n1 つのウィジェットのインスタンスを他と異なる見た目にしたい場合、ウィジェットのオブジェクトをインスタンス化してフォームフィールドに割り当てるタイミングで、追加の属性を指定する必要があります (そしておそらく、あなたの CSS ファイルにいくつか記述を追加する必要もあります)。
\nFor example, take the following form:
\nfrom django import forms\n\nclass CommentForm(forms.Form):\n name = forms.CharField()\n url = forms.URLField()\n comment = forms.CharField()\nこのフォームは、デフォルトのレンダリングとともに、3 つのデフォルトの TextInput ウィジェットを含みます -- CSS のクラスも追加の属性もありません。これは、それぞれのウィジェットに対して提供された input ボックスが、以下とまったく同じくレンダリングされることを意味します。
>>> f = CommentForm(auto_id=False)\n>>> f.as_table()\n<tr><th>Name:</th><td><input type="text" name="name" required></td></tr>\n<tr><th>Url:</th><td><input type="url" name="url" required></td></tr>\n<tr><th>Comment:</th><td><input type="text" name="comment" required></td></tr>\nOn a real web page, you probably don't want every widget to look the same. You\nmight want a larger input element for the comment, and you might want the\n'name' widget to have some special CSS class. It is also possible to specify\nthe 'type' attribute to take advantage of the new HTML5 input types. To do\nthis, you use the Widget.attrs argument when creating the widget:
class CommentForm(forms.Form):\n name = forms.CharField(widget=forms.TextInput(attrs={'class': 'special'}))\n url = forms.URLField()\n comment = forms.CharField(widget=forms.TextInput(attrs={'size': '40'}))\nYou can also modify a widget in the form definition:
\nclass CommentForm(forms.Form):\n name = forms.CharField()\n url = forms.URLField()\n comment = forms.CharField()\n\n name.widget.attrs.update({'class': 'special'})\n comment.widget.attrs.update(size='40')\nOr if the field isn't declared directly on the form (such as model form fields),\nyou can use the Form.fields attribute:
class CommentForm(forms.ModelForm):\n def __init__(self, *args, **kwargs):\n super().__init__(*args, **kwargs)\n self.fields['name'].widget.attrs.update({'class': 'special'})\n self.fields['comment'].widget.attrs.update(size='40')\nDjango はこれで、レンダリングされたアウトプットに、追加的な要素を含むようになります:
\n>>> f = CommentForm(auto_id=False)\n>>> f.as_table()\n<tr><th>Name:</th><td><input type="text" name="name" class="special" required></td></tr>\n<tr><th>Url:</th><td><input type="url" name="url" required></td></tr>\n<tr><th>Comment:</th><td><input type="text" name="comment" size="40" required></td></tr>\nattrs を使った HTML の id をセットすることもできます。BoundField.id_for_label で例をご覧ください。
ウィジェットとともに、アセット (css や javascript) 、およびより詳細にカスタマイズされた見た目や動作を追加することができます。
要するに、ウィジェットをサブクラス化して、 "Media" 内部クラスの定義 か "media" プロパティの作成 のどちらかをする必要があります。
\nこれらのメソッドにはやや高度なPythonプログラミングが含まれており、トピックガイド Form Assets で詳しく説明しています。
\nWidget や MultiWidget といった基本ウィジェットは、ビルトインのウィジェット によってサブクラス化され、カスタムウィジェットのための基礎となります。
ウィジェットLink to this heading#この抽象クラスはレンダリングできませんが、基本的な属性 attrs を提供します。カスタムウィジェット上で render() を実行するかオーバーライドできます。
ディクショナリは、レンダリングされたウィジェット上にセットされる HTML の属性を含んでいます。
\n>>> from django import forms\n>>> name = forms.TextInput(attrs={'size': 10, 'title': 'Your name'})\n>>> name.render('name', 'A name')\n'<input title="Your name" type="text" name="name" value="A name" size="10">'\nTrue か False の値を割り当てた場合は、HTML5 の ブール属性としてレンダリングされます。
>>> name = forms.TextInput(attrs={'required': True})\n>>> name.render('name', 'A name')\n'<input name="name" type="text" value="A name" required>'\n>>>\n>>> name = forms.TextInput(attrs={'required': False})\n>>> name.render('name', 'A name')\n'<input name="name" type="text" value="A name">'\nTrue をデフォルト値にする属性です。False にセットされた場合は、datetime と time のマイクロ秒の部分の値は、0 にセットされます。
ウィジェットのテンプレートで使うための値を整えて返します。value は入力値が検証されるとは限りません。そのため、サブクラスの実行は防衛的にプログラムされなければなりません。
Returns a dictionary of values to use when rendering the widget\ntemplate. By default, the dictionary contains a single key,\n'widget', which is a dictionary representation of the widget\ncontaining the following keys:
'name': The name of the field from the name argument.
'is_hidden': A boolean indicating whether or not this widget is\nhidden.
'required': A boolean indicating whether or not the field for\nthis widget is required.
'value': The value as returned by format_value().
'attrs': HTML attributes to be set on the rendered widget. The\ncombination of the attrs attribute and the attrs argument.
'template_name': The value of self.template_name.
Widget subclasses can provide custom context values by overriding\nthis method.
このウィジェットのフィールドの ID が付与された <label> で使われるための HTML の ID 属性を返します。 IDが有効でない場合は None を返します。
いくつかのウィジェットは複数の HTML 要素、そして、複数の ID を持っているため、このフックが必要です。この場合、このメソッドは、ウィジェットのタグの最初の ID と一致する ID 値を返す必要があります。
\nRenders a widget to HTML using the given renderer. If renderer is\nNone, the renderer from the FORM_RENDERER setting is\nused.
データとこのウィジェットの名前のディクショナリが与えられ、このウィジェットの値を返します。files には request.FILES からのデータが含まれている可能性があります。値が指定されなかった場合は None を返します。 また、value_from_datadict はフォームデータの処理中に複数回呼び出される可能性があるので、カスタマイズして複雑な処理を追加する場合は、自分でキャッシュの仕組みを実装する必要があります。
data と files のディクショナリとこのウィジェットの名前が与えられ、ウィジェットのためのデータやファイルが存在するかを返します。
メソッドの結果は、モデルフォームのフィールドが デフォルトに逆戻りする かどうかに影響します。
\nSpecial cases are CheckboxInput,\nCheckboxSelectMultiple, and\nSelectMultiple, which always return\nFalse because an unchecked checkbox and unselected\n<select multiple> don't appear in the data of an HTML form\nsubmission, so it's unknown whether or not the user submitted a value.
フォームフィールドの 初期の 値が与えられ、ウィジェットが 必要な HTML 属性とともにレンダリングできるかどうかを返します。フォームは、各フィールドに 必要な 属性を描画するかどうかを決定するために、Field.required と Form.use_required_attribute とともにこのメソッドを使います。
By default, returns False for hidden widgets and True\notherwise. Special cases are FileInput and\nClearableFileInput, which return False when\ninitial is set, and CheckboxSelectMultiple,\nwhich always returns False because browser validation would require\nall checkboxes to be checked instead of at least one.
ブラウザの検証と互換性のないカスタムウィジェットでは、このメソッドをオーバーライドしてください。例えば、ある非表示の textarea 要素が背後にある WSYSIWG テキストエディタのウィジェットは、ブラウザが非表示のフィールドを検証するのを避けるため、常に False を返したがるかもしれません。
MultiWidgetLink to this heading#複数のウィジェットで構成されたウィジェットです。MultiWidget は MultiValueField と協調して動作します。
MultiWidget には 1 つの必要な引数があります。
An iterable containing the widgets needed. For example:
\n>>> from django.forms import MultiWidget, TextInput\n>>> widget = MultiWidget(widgets=[TextInput, TextInput])\n>>> widget.render('name', ['john', 'paul'])\n'<input type="text" name="name_0" value="john"><input type="text" name="name_1" value="paul">'\nYou may provide a dictionary in order to specify custom suffixes for\nthe name attribute on each subwidget. In this case, for each\n(key, widget) pair, the key will be appended to the name of the\nwidget in order to generate the attribute value. You may provide the\nempty string ('') for a single key, in order to suppress the suffix\nfor one widget. For example:
>>> widget = MultiWidget(widgets={'': TextInput, 'last': TextInput})\n>>> widget.render('name', ['john', 'paul'])\n'<input type="text" name="name" value="john"><input type="text" name="name_last" value="paul">'\nそれと、1 つの必要なメソッドです:
\nこのメソッドは、フィールドから単一の "圧縮された" 値を取り、"解凍された" 値のリストを返します。入力された値は検証済みと見なせますが、空 (empty)でないとは限りません。
\nこのメソッドは、サブクラスによって 実行される必要があり、値が空 (empty) かもしれないので、処理は防衛的である必要があります。
\n"解凍" の裏にある根本的な原理は、フォームのフィールドから各ウィジェットの値に、結合された値を "分割する" 必要があることです。
\n以下は、SplitDateTimeWidget が どのように SplitDateTimeWidget の値を 2 つの分割された値に日付や時刻とともにリストに入れるかの例です:
from django.forms import MultiWidget\n\nclass SplitDateTimeWidget(MultiWidget):\n\n # ...\n\n def decompress(self, value):\n if value:\n return [value.date(), value.time()]\n return [None, None]\nIt provides some custom context:
\nIn addition to the 'widget' key described in\nWidget.get_context(), MultiWidget adds a\nwidget['subwidgets'] key.
These can be looped over in the widget template:
\n{% for subwidget in widget.subwidgets %}\n {% include subwidget.template_name with widget=subwidget %}\n{% endfor %}\n異なるセレクトボックス内で MultiWidget を日、月、年とともに日付を表示するためにサブクラス化するウィジェットの例です。このウィジェットは MultiValueField ではなく DateField とともに使われることを意図しています。そして、value_from_datadict() が実行されています:
from datetime import date\nfrom django import forms\n\nclass DateSelectorWidget(forms.MultiWidget):\n def __init__(self, attrs=None):\n days = [(day, day) for day in range(1, 32)]\n months = [(month, month) for month in range(1, 13)]\n years = [(year, year) for year in [2018, 2019, 2020]]\n widgets = [\n forms.Select(attrs=attrs, choices=days),\n forms.Select(attrs=attrs, choices=months),\n forms.Select(attrs=attrs, choices=years),\n ]\n super().__init__(widgets, attrs)\n\n def decompress(self, value):\n if isinstance(value, date):\n return [value.day, value.month, value.year]\n elif isinstance(value, str):\n year, month, day = value.split('-')\n return [day, month, year]\n return [None, None, None]\n\n def value_from_datadict(self, data, files, name):\n day, month, year = super().value_from_datadict(data, files, name)\n # DateField expects a single string that it can parse into a date.\n return '{}-{}-{}'.format(year, month, day)\nThe constructor creates several Select widgets in a list. The\nsuper() method uses this list to set up the widget.
The required method decompress() breaks up a\ndatetime.date value into the day, month, and year values corresponding\nto each widget. If an invalid date was selected, such as the non-existent\n30th February, the DateField passes this method a\nstring instead, so that needs parsing. The final return handles when\nvalue is None, meaning we don't have any defaults for our\nsubwidgets.
The default implementation of value_from_datadict() returns a\nlist of values corresponding to each Widget. This is appropriate when\nusing a MultiWidget with a MultiValueField. But\nsince we want to use this widget with a DateField,\nwhich takes a single value, we have overridden this method. The\nimplementation here combines the data from the subwidgets into a string in\nthe format that DateField expects.
Django は、全ての基本的な HTML ウィジェットの表現のほか、django.forms.widgets でいくつかの一般的に使われるウィジェットのグループを提供します。これは テキストの入力、多種のチェックボックスおよび選択肢、ファイルアップロード、複数値の入力の扱い を含みます。
これらのウィジェットは、 input と textarea の HTML 要素を使います。
TextInputLink to this heading#input_type: 'text'
template_name: 'django/forms/widgets/text.html'
Renders as: <input type="text" ...>
NumberInputLink to this heading#input_type: 'number'
template_name: 'django/forms/widgets/number.html'
Renders as: <input type="number" ...>
全てのブラウザが number input タイプへローカライズされた数値を入力することをサポートしていない点に注意してください。Django 自身、localize プロパティが True にセットされたフィールドでは、これらを使用しません。
EmailInputLink to this heading#input_type: 'email'
template_name: 'django/forms/widgets/email.html'
Renders as: <input type="email" ...>
URLInputLink to this heading#input_type: 'url'
template_name: 'django/forms/widgets/url.html'
Renders as: <input type="url" ...>
PasswordInputLink to this heading#input_type: 'password'
template_name: 'django/forms/widgets/password.html'
Renders as: <input type="password" ...>
1 つの省略可能な引数を取ります:
\nバリデーションエラーの後、フォームが再描画されるときにウィジェットに値を書き込むかどうかを決めます (デフォルトは False です)。
DateInputLink to this heading#input_type: 'text'
template_name: 'django/forms/widgets/date.html'
Renders as: <input type="text" ...>
TextInput と同じ引数を取り、さらに 1 つ省略可能な引数があります:
このフィールドの初期値が描画されるフォーマットです。
\nformat 引数が渡されないとき、デフォルトのフォーマットは DATE_INPUT_FORMATS 内で最初に見つかったフォーマットで、表示形式のローカル化 を尊重します。
DateTimeInputLink to this heading#input_type: 'text'
template_name: 'django/forms/widgets/datetime.html'
Renders as: <input type="text" ...>
TextInput と同じ引数を取り、さらに 1 つ省略可能な引数があります:
このフィールドの初期値が描画されるフォーマットです。
\nformat 引数が渡されないとき、デフォルトのフォーマットは DATETIME_INPUT_FORMATS 内で最初に見つかったフォーマットで、表示形式のローカル化 を尊重します。
デフォルトでは、時刻のマイクロ秒部分は常に 0 にセットされます。マイクロ秒が必要な場合は、サブクラスで supports_microseconds 属性を True にセットして使ってください。
TimeInputLink to this heading#input_type: 'text'
template_name: 'django/forms/widgets/time.html'
Renders as: <input type="text" ...>
TextInput と同じ引数を取り、さらに 1 つ省略可能な引数があります:
このフィールドの初期値が描画されるフォーマットです。
\nformat 引数が渡されないとき、デフォルトのフォーマットは TIME_INPUT_FORMATS 内で最初に見つかったフォーマットで、表示形式のローカル化 を尊重します。
マイクロ秒の扱いについては、DateTimeInput を参照してください。
TextareaLink to this heading#template_name: 'django/forms/widgets/textarea.html'
Renders as: <textarea>...</textarea>
These widgets make use of the HTML elements <select>,\n<input type="checkbox">, and <input type="radio">.
Widgets that render multiple choices have an option_template_name attribute\nthat specifies the template used to render each choice. For example, for the\nSelect widget, select_option.html renders the <option> for a\n<select>.
CheckboxInputLink to this heading#input_type: 'checkbox'
template_name: 'django/forms/widgets/checkbox.html'
Renders as: <input type="checkbox" ...>
1 つの省略可能な引数を取ります:
\nCheckboxInput の値を受け取り、チェックボックスがチェックされる必要がある場合は True を返す callable です。
SelectLink to this heading#template_name: 'django/forms/widgets/select.html'
option_template_name: 'django/forms/widgets/select_option.html'
Renders as: <select><option ...>...</select>
フォームのフィールドに choices 属性がない場合、この属性は省略可能です。この属性がある場合には、Field で属性が更新されたときにセットされた全てをオーバーライドします。
NullBooleanSelectLink to this heading#template_name: 'django/forms/widgets/select.html'
option_template_name: 'django/forms/widgets/select_option.html'
'Unknown'、'Yes'、'No' の選択肢ウィジェット
\nSelectMultipleLink to this heading#template_name: 'django/forms/widgets/select.html'
option_template_name: 'django/forms/widgets/select_option.html'
Similar to Select, but allows multiple selection:\n<select multiple>...</select>
RadioSelectLink to this heading#template_name: 'django/forms/widgets/radio.html'
option_template_name: 'django/forms/widgets/radio_option.html'
Similar to Select, but rendered as a list of radio buttons within\n<div> tags:
<div>\n <div><input type="radio" name="..."></div>\n ...\n</div>\nFor more granular control over the generated markup, you can loop over the\nradio buttons in the template. Assuming a form myform with a field\nbeatles that uses a RadioSelect as its widget:
<fieldset>\n <legend>{{ myform.beatles.label }}</legend>\n {% for radio in myform.beatles %}\n <div class="myradio">\n {{ radio }}\n </div>\n {% endfor %}\n</fieldset>\nThis would generate the following HTML:
\n<fieldset>\n <legend>Radio buttons</legend>\n <div class="myradio">\n <label for="id_beatles_0"><input id="id_beatles_0" name="beatles" type="radio" value="john" required> John</label>\n </div>\n <div class="myradio">\n <label for="id_beatles_1"><input id="id_beatles_1" name="beatles" type="radio" value="paul" required> Paul</label>\n </div>\n <div class="myradio">\n <label for="id_beatles_2"><input id="id_beatles_2" name="beatles" type="radio" value="george" required> George</label>\n </div>\n <div class="myradio">\n <label for="id_beatles_3"><input id="id_beatles_3" name="beatles" type="radio" value="ringo" required> Ringo</label>\n </div>\n</fieldset>\nThat included the <label> tags. To get more granular, you can use each\nradio button's tag, choice_label and id_for_label attributes.\nFor example, this template...
<fieldset>\n <legend>{{ myform.beatles.label }}</legend>\n {% for radio in myform.beatles %}\n <label for="{{ radio.id_for_label }}">\n {{ radio.choice_label }}\n <span class="radio">{{ radio.tag }}</span>\n </label>\n {% endfor %}\n</fieldset>\n...will result in the following HTML:
\n<fieldset>\n <legend>Radio buttons</legend>\n <label for="id_beatles_0">\n John\n <span class="radio"><input id="id_beatles_0" name="beatles" type="radio" value="john" required></span>\n </label>\n <label for="id_beatles_1">\n Paul\n <span class="radio"><input id="id_beatles_1" name="beatles" type="radio" value="paul" required></span>\n </label>\n <label for="id_beatles_2">\n George\n <span class="radio"><input id="id_beatles_2" name="beatles" type="radio" value="george" required></span>\n </label>\n <label for="id_beatles_3">\n Ringo\n <span class="radio"><input id="id_beatles_3" name="beatles" type="radio" value="ringo" required></span>\n </label>\n</fieldset>\nIf you decide not to loop over the radio buttons -- e.g., if your template\nincludes {{ myform.beatles }} -- they'll be output in a <div> with\n<div> tags, as above.
The outer <div> container receives the id attribute of the widget,\nif defined, or BoundField.auto_id otherwise.
When looping over the radio buttons, the label and input tags include\nfor and id attributes, respectively. Each radio button has an\nid_for_label attribute to output the element's ID.
CheckboxSelectMultipleLink to this heading#template_name: 'django/forms/widgets/checkbox_select.html'
option_template_name: 'django/forms/widgets/checkbox_option.html'
Similar to SelectMultiple, but rendered as a list of checkboxes:
<div>\n <div><input type="checkbox" name="..." ></div>\n ...\n</div>\nThe outer <div> container receives the id attribute of the widget,\nif defined, or BoundField.auto_id otherwise.
Like RadioSelect, you can loop over the individual checkboxes for the\nwidget's choices. Unlike RadioSelect, the checkboxes won't include the\nrequired HTML attribute if the field is required because browser validation\nwould require all checkboxes to be checked instead of at least one.
When looping over the checkboxes, the label and input tags include\nfor and id attributes, respectively. Each checkbox has an\nid_for_label attribute to output the element's ID.
FileInputLink to this heading#template_name: 'django/forms/widgets/file.html'
Renders as: <input type="file" ...>
ClearableFileInputLink to this heading#template_name: 'django/forms/widgets/clearable_file_input.html'
Renders as: <input type="file" ...> with an additional checkbox\ninput to clear the field's value, if the field is not required and has\ninitial data.
SplitDateTimeWidgetLink to this heading#template_name: 'django/forms/widgets/splitdatetime.html'
Wrapper (using MultiWidget) around two widgets: DateInput\nfor the date, and TimeInput for the time. Must be used with\nSplitDateTimeField rather than DateTimeField.
SplitDateTimeWidget has several optional arguments:
DateInput.format と同様。
TimeInput.format と同様
Similar to Widget.attrs. A dictionary containing HTML\nattributes to be set on the rendered DateInput and\nTimeInput widgets, respectively. If these attributes aren't\nset, Widget.attrs is used instead.
SelectDateWidgetLink to this heading#template_name: 'django/forms/widgets/select_date.html'
Wrapper around three Select widgets: one each for\nmonth, day, and year.
Takes several optional arguments:
\nAn optional list/tuple of years to use in the "year" select box.\nThe default is a list containing the current year and the next 9 years.
\nAn optional dict of months to use in the "months" select box.
\nThe keys of the dict correspond to the month number (1-indexed) and\nthe values are the displayed months:
\nMONTHS = {\n 1:_('jan'), 2:_('feb'), 3:_('mar'), 4:_('apr'),\n 5:_('may'), 6:_('jun'), 7:_('jul'), 8:_('aug'),\n 9:_('sep'), 10:_('oct'), 11:_('nov'), 12:_('dec')\n}\nIf the DateField is not required,\nSelectDateWidget will have an empty choice at the top of the\nlist (which is --- by default). You can change the text of this\nlabel with the empty_label attribute. empty_label can be a\nstring, list, or tuple. When a string is used, all select\nboxes will each have an empty choice with this label. If empty_label\nis a list or tuple of 3 string elements, the select boxes will\nhave their own custom label. The labels should be in this order\n('year_label', 'month_label', 'day_label').
# A custom empty label with string\nfield1 = forms.DateField(widget=SelectDateWidget(empty_label="Nothing"))\n\n# A custom empty label with tuple\nfield1 = forms.DateField(\n widget=SelectDateWidget(\n empty_label=("Choose Year", "Choose Month", "Choose Day"),\n ),\n)\n