En widget är Djangos representation av ett HTML-inmatningselement. Widgeten hanterar rendering av HTML och extrahering av data från en GET/POST-ordbok som motsvarar widgeten.
\nDen HTML som genereras av de inbyggda widgetarna använder HTML5-syntax och riktar sig till <!DOCTYPE html>. Exempelvis används booleska attribut som checked i stället för XHTML-stilen checked='checked'.
När du anger ett fält i ett formulär kommer Django att använda en standardwidget som är lämplig för den typ av data som ska visas. För att ta reda på vilken widget som används för vilket fält, se dokumentationen om Inbyggda Field-klasser.
\nMen om du vill använda en annan widget för ett fält kan du använda argumentet widget i fältdefinitionen. Till exempel:
from django import forms\n\n\nclass CommentForm(forms.Form):\n name = forms.CharField()\n url = forms.URLField()\n comment = forms.CharField(widget=forms.Textarea)\nDetta skulle ange ett formulär med en kommentar som använder en större Textarea-widget i stället för standardwidgeten TextInput.
Många widgetar har valfria extra argument; de kan anges när widgeten definieras på fältet. I följande exempel anges attributet years för en SelectDateWidget:
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\n\nclass SimpleForm(forms.Form):\n birth_year = forms.DateField(\n widget=forms.SelectDateWidget(years=BIRTH_YEAR_CHOICES)\n )\n favorite_colors = forms.MultipleChoiceField(\n required=False,\n widget=forms.CheckboxSelectMultiple,\n choices=FAVORITE_COLORS_CHOICES,\n )\nSe inbyggda widgetar för mer information om vilka widgetar som finns tillgängliga och vilka argument de accepterar.
\nNär Django renderar en widget som HTML, renderar den bara mycket minimal markup - Django lägger inte till klassnamn eller andra widgetspecifika attribut. Detta innebär till exempel att alla TextInput-widgets kommer att se likadana ut på dina webbsidor.
Det finns två sätt att anpassa widgetar: per widget instance och per widget class.
\nOm du vill att en widgetinstans ska se annorlunda ut än en annan måste du ange ytterligare attribut när widgetobjektet instansieras och tilldelas ett formulärfält (och kanske lägga till några regler i dina CSS-filer).
\nTa till exempel följande formulär:
\nfrom django import forms\n\n\nclass CommentForm(forms.Form):\n name = forms.CharField()\n url = forms.URLField()\n comment = forms.CharField()\nDetta formulär kommer att innehålla TextInput-widgetar för namn- och kommentarsfälten, och en URLInput-widget för url-fältet. Varje widget har standardrendering - ingen CSS-klass, inga extra attribut:
>>> f = CommentForm(auto_id=False)\n>>> print(f)\n<div>Name:<input type="text" name="name" required></div>\n<div>Url:<input type="url" name="url" required></div>\n<div>Comment:<input type="text" name="comment" required></div>\nPå en riktig webbsida vill du förmodligen anpassa detta. Du kanske vill ha ett större inmatningselement för kommentaren, och du kanske vill att widgeten ”name” ska ha någon speciell CSS-klass. Det är också möjligt att ange attributet ’type’ för att använda en annan HTML5-ingångstyp. För att göra detta använder du argumentet Widget.attrs när du skapar widgeten:
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"}))\nDu kan också ändra en widget i formulärdefinitionen:
\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")\nOm fältet inte deklareras direkt i formuläret (t.ex. fält i modellformulär) kan du använda attributet Form.fields:
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 kommer då att inkludera de extra attributen i den återgivna utdata:
\n>>> f = CommentForm(auto_id=False)\n>>> print(f)\n<div>Name:<input type="text" name="name" class="special" required></div>\n<div>Url:<input type="url" name="url" required></div>\n<div>Comment:<input type="text" name="comment" size="40" required></div>\nDu kan också ställa in HTML id med hjälp av attrs. Se BoundField.id_for_label för ett exempel.
Med widgets är det möjligt att lägga till tillgångar (css och javascript) och mer djupgående anpassa deras utseende och beteende.
I ett nötskal måste du underklassa widgeten och antingen definiera en ”Media” inre klass eller skapa en ”media” egenskap.
\nDessa metoder kräver lite avancerad Python-programmering och beskrivs i detalj i ämnesguiden Form Assets.
\nBaswidgetklasserna Widget och MultiWidget är underklasser till alla inbyggda widgetar och kan fungera som en grund för anpassade widgetar.
WidgetLink to this heading#Den här abstrakta klassen kan inte renderas, men tillhandahåller grundattributet attrs. Du kan också implementera eller åsidosätta metoden render() i anpassade widgetar.
En ordlista som innehåller HTML-attribut som ska ställas in på den renderade widgeten.
\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">'\nOm du tilldelar ett värde av True eller False till ett attribut, kommer det att återges som ett HTML5 booleskt attribut:
>>> 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">'\nEtt attribut som har standardvärdet True. Om det sätts till False kommer mikrosekunderna i värdena datetime och time att sättas till 0.
Rensar och returnerar ett värde för användning i widgetmallen. värde garanteras inte vara giltig indata, därför bör implementeringar av underklasser programmeras defensivt.
Returnerar en ordbok med värden som ska användas vid rendering av widgetmallen. Som standard innehåller ordboken en enda nyckel, 'widget', som är en ordboksrepresentation av widgeten som innehåller följande nycklar:
'namn': Namnet på fältet från argumentet name.
'is_hidden': En boolean som anger om denna widget är dold eller inte.
'required': En boolean som anger om fältet för den här widgeten är obligatoriskt eller inte.
'värde': Det värde som returneras av format_value().
'attrs': HTML-attribut som ska ställas in på den renderade widgeten. Kombinationen av attributet attrs och argumentet attrs.
'template_name': Värdet av self.template_name.
underklasser till Widget kan tillhandahålla anpassade kontextvärden genom att åsidosätta denna metod.
Returnerar HTML ID-attributet för denna widget för användning av en <label>, givet fältets ID. Returnerar en tom sträng om ett ID inte är tillgängligt.
Denna hook är nödvändig eftersom vissa widgetar har flera HTML-element och därmed flera ID:n. I så fall bör den här metoden returnera ett ID-värde som motsvarar det första ID:t i widgetens taggar.
\nRenderar en widget till HTML med hjälp av den angivna renderaren. Om renderer är None används renderaren från inställningen FORM_RENDERER.
Givet en ordbok med data och denna widgets namn, returnerar värdet av denna widget. files kan innehålla data som kommer från request.FILES. Returnerar None om inget värde har angetts. Observera också att value_from_datadict kan anropas mer än en gång under hanteringen av formulärdata, så om du anpassar det och lägger till dyr bearbetning bör du implementera någon cachemekanism själv.
Med hjälp av ordböckerna data och files och widgetens namn returneras om det finns data eller filer för widgeten eller inte.
Metodens resultat påverkar om ett fält i ett modellformulär faller tillbaka till sin standard eller inte.
\nSpecialfall är CheckboxInput, CheckboxSelectMultiple och SelectMultiple, som alltid returnerar False eftersom en avmarkerad kryssruta och omarkerad <select multiple> inte visas i data från en HTML-formulärinlämning, så det är okänt om användaren skickade in ett värde eller inte.
Ett attribut för att identifiera om widgeten ska grupperas i en <fieldset> med en <legend> när den renderas. Standardvärdet är False men är True när widgeten innehåller flera <input> taggar som CheckboxSelectMultiple, RadioSelect, MultiWidget, SplitDateTimeWidget, och SelectDateWidget.
Med tanke på ett formulärfälts initial-värde returneras huruvida widgeten kan återges med HTML-attributet required eller inte. Formulär använder den här metoden tillsammans med Field.required och Form.use_required_attribute för att avgöra om attributet required ska visas eller inte för varje fält.
Som standard returneras False för dolda widgetar och True annars. Specialfall är FileInput och ClearableFileInput, som returnerar False när initial är inställt, och CheckboxSelectMultiple, som alltid returnerar False eftersom webbläsarvalidering skulle kräva att alla kryssrutor är markerade istället för minst en.
Åsidosätt den här metoden i anpassade widgetar som inte är kompatibla med webbläsarvalidering. En WYSIWYG-textredigerarwidget som till exempel bygger på ett dolt textarea-element kanske alltid vill returnera False för att undvika webbläsarvalidering av det dolda fältet.
MultiWidgetLink to this heading#En widget som består av flera widgetar. MultiWidget arbetar hand i hand med MultiValueField.
MultiWidget har ett obligatoriskt argument:
En iterabel som innehåller de widgetar som behövs. Till exempel:
\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">'\nDu kan tillhandahålla en ordbok för att ange anpassade suffix för attributet name på varje subwidget. I det här fallet kommer nyckeln för varje par (nyckel, widget) att läggas till widgetens namn för att generera attributvärdet. Du kan ange den tomma strängen ('') för en enda nyckel, för att undertrycka suffixet för en widget. Till exempel:
>>> 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">'\nOch en nödvändig metod:
\nDenna metod tar ett enda ”komprimerat” värde från fältet och returnerar en lista med ”dekomprimerade” värden. Inmatningsvärdet kan antas vara giltigt, men inte nödvändigtvis icke-tomt.
\nDenna metod måste implementeras av underklassen, och eftersom värdet kan vara tomt måste implementeringen vara defensiv.
\nTanken bakom ”dekomprimering” är att det är nödvändigt att ”dela upp” det kombinerade värdet för formulärfältet i värden för varje widget.
\nEtt exempel på detta är hur SplitDateTimeWidget förvandlar ett datetime-värde till en lista med datum och tid uppdelade i två separata värden:
from django.forms import MultiWidget\n\n\nclass SplitDateTimeWidget(MultiWidget):\n # ...\n\n def decompress(self, value):\n if value:\n return [value.date(), value.time()]\n return [None, None]\nDet ger ett anpassat sammanhang:
\nFörutom nyckeln 'widget' som beskrivs i Widget.get_context(), lägger MultiWidget till en nyckel widget['subwidgets'].
Dessa kan loopas över i widgetmallen:
\n{% for subwidget in widget.subwidgets %}\n {% include subwidget.template_name with widget=subwidget %}\n{% endfor %}\nHär är ett exempel på en widget som underklassar MultiWidget för att visa ett datum med dag, månad och år i olika valboxar. Denna widget är avsedd att användas med en DateField snarare än en MultiValueField, därför har vi implementerat value_from_datadict():
from datetime import date\nfrom django import forms\n\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)\nKonstruktören skapar flera Select widgetar i en lista. Metoden super() använder denna lista för att konfigurera widgeten.
Den nödvändiga metoden decompress() delar upp ett datetime.date-värde i värdena för dag, månad och år som motsvarar varje widget. Om ett ogiltigt datum valdes, till exempel den icke-existerande 30 februari, skickar DateField den här metoden en sträng istället, så det måste analyseras. Den sista return hanterar när value är None, vilket innebär att vi inte har några standardvärden för våra underwidgets.
Standardimplementeringen av value_from_datadict() returnerar en lista med värden som motsvarar varje Widget. Detta är lämpligt när man använder en MultiWidget med en MultiValueField. Men eftersom vi vill använda denna widget med en DateField, som tar ett enda värde, har vi åsidosatt denna metod. Implementationen här kombinerar data från underwidgetarna till en sträng i det format som DateField förväntar sig.
Django tillhandahåller en representation av alla grundläggande HTML-widgets, plus några vanligt förekommande grupper av widgets i modulen django.forms.widgets, inklusive inmatning av text, olika kryssrutor och väljare, uppladdning av filer och hantering av flervärdesinmatning.
Dessa widgets använder HTML-elementen input och textarea.
TextInputLink to this heading#inmatningstyp: ”text
template_name: 'django/forms/widgets/text.html'
Renderas som: <input type="text" ...>
NummerInmatningLink to this heading#inmatningstyp: ”tal
template_name: 'django/forms/widgets/number.html'
Renderas som: <input type="number" ...>
Tänk på att inte alla webbläsare stöder inmatning av lokaliserade siffror i inmatningstyperna number. Django själv undviker att använda dem för fält som har sin localize egenskap inställd på True.
EmailInputLink to this heading#input_type: 'email'
template_name: 'django/forms/widgets/email.html'
Renderas som: <input type="email" ...>
URLInputLink to this heading#inmatningstyp: ”url
template_name: 'django/forms/widgets/url.html'
Renderas som: <input type="url" ...>
FärgInmatningLink to this heading#inmatningstyp: ”färg
template_name:'django/forms/widgets/color.html'
Renderas som: <input type="color" ...>
SökningInputLink to this heading#input_type: 'search'
template_name: 'django/forms/widgets/search.html'
Renderas som: <input type="search" ...>
TelInputLink to this heading#inmatningstyp: ”tel
template_name: 'django/forms/widgets/tel.html'
Renderas som: <input type="tel" ...>
Webbläsare utför ingen validering på klientsidan som standard eftersom telefonnummerformat varierar så mycket runt om i världen. Du kan lägga till några genom att ställa in pattern, minlength eller maxlength i argumentet Widget.attrs.
Dessutom kan du lägga till validering på serversidan till ditt formulärfält med en validerare som RegexValidator eller via tredjepartspaket, t.ex. django-phonenumber-field.
LösenordInmatningLink to this heading#inmatningstyp: ”Lösenord
template_name: 'django/forms/widgets/password.html'
Renderas som: <input type="password" ...>
Tar emot ett valfritt argument:
\nBestämmer om widgeten ska ha ett värde ifyllt när formuläret visas igen efter ett valideringsfel (standard är False).
DatumInmatningLink to this heading#inmatningstyp: ”text
template_name: 'django/forms/widgets/date.html'
Renderas som: <input type="text" ...>
Tar samma argument som TextInput, med ytterligare ett valfritt argument:
Det format som fältets initiala värde ska visas i.
\nOm inget format-argument anges är standardformatet det första formatet som hittas i DATE_INPUT_FORMATS och respekterar Lokalisering av format. formaten %U, %W och %j stöds inte av den här widgeten.
DateTimeInputLink to this heading#inmatningstyp: ”text
template_name: 'django/forms/widgets/datetime.html'
Renderas som: <input type="text" ...>
Tar samma argument som TextInput, med ytterligare ett valfritt argument:
Det format som fältets initiala värde ska visas i.
\nOm inget format-argument anges är standardformatet det första formatet som hittas i DATETIME_INPUT_FORMATS och respekterar Lokalisering av format. formaten %U, %W och %j stöds inte av den här widgeten.
Som standard är mikrosekunderdelen av tidsvärdet alltid satt till 0. Om mikrosekunder krävs, använd en subklass med attributet supports_microseconds satt till True.
TimeInputLink to this heading#inmatningstyp: ”text
template_name: 'django/forms/widgets/time.html'
Renderas som: <input type="text" ...>
Tar samma argument som TextInput, med ytterligare ett valfritt argument:
Det format som fältets initiala värde ska visas i.
\nOm inget format-argument anges är standardformatet det första formatet som hittas i TIME_INPUT_FORMATS och respekterar Lokalisering av format.
För behandling av mikrosekunder, se DateTimeInput.
TextareaLink to this heading#template_name: 'django/forms/widgets/textarea.html'
Återges som: .<textarea>.</textarea>.
Dessa widgets använder HTML-elementen <select>, <input type="checkbox"> och <input type="radio">.
Widgetar som återger flera val har ett attribut option_template_name som anger den mall som används för att återge varje val. Till exempel:, för widgeten Select, select_option.html renderar <option> för en <select>.
CheckboxInputLink to this heading#inmatningstyp: ”Checkbox
template_name: 'django/forms/widgets/checkbox.html'
Renderas som: <input type="checkbox" ...>
Tar emot ett valfritt argument:
\nEn anropsbar funktion som tar värdet i CheckboxInput och returnerar True om kryssrutan ska markeras för det värdet.
VäljLink to this heading#template_name: 'django/forms/widgets/select.html'
option_template_name: 'django/forms/widgets/select_option.html'
Renderas som: ``<select><option …>…``</select>
Detta attribut är valfritt om formulärfältet inte har något choices-attribut. Om det gör det kommer det att åsidosätta allt du anger här när attributet uppdateras på Field.
NullBooleanSelectLink to this heading#template_name: 'django/forms/widgets/select.html'
option_template_name: 'django/forms/widgets/select_option.html'
Välj widget med alternativen ”Okänd”, ”Ja” och ”Nej
\nVäljMultipelLink to this heading#template_name: 'django/forms/widgets/select.html'
option_template_name: 'django/forms/widgets/select_option.html'
Liknar Select, men tillåter flera val: .<select multiple>.</select>.
RadioSelectLink to this heading#template_name: 'django/forms/widgets/radio.html'
option_template_name: 'django/forms/widgets/radio_option.html'
Liknar Select, men återges som en lista med alternativknappar inom <div> taggar:
<div>\n <div><input type="radio" name="..."></div>\n ...\n</div>\nOm du vill ha mer detaljerad kontroll över den genererade markeringen kan du loopa över radioknapparna i mallen. Anta ett formulär myform med ett fält beatles som använder en RadioSelect som sin 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>\nDetta skulle generera följande 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>\nDet inkluderade taggarna <label>. För att bli mer detaljerad kan du använda varje radioknapps attribut tag, choice_label och id_for_label. Till exempel:, den här mallen…
<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…kommer att resultera i följande 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>\nOm du bestämmer dig för att inte loopa över alternativknapparna - t.ex. om din mall innehåller {{ myform.beatles }} - kommer de att matas ut i en <div> med <div>-taggar, enligt ovan.
Den yttre behållaren <div> får widgetens id-attribut, om det är definierat, eller BoundField.auto_id annars.
När du loopar över radioknapparna innehåller taggarna label och input attributen for respektive id. Varje radioknapp har ett id_for_label-attribut för att mata ut elementets ID.
CheckboxSelectMultipleLink to this heading#template_name: 'django/forms/widgets/checkbox_select.html'
option_template_name: 'django/forms/widgets/checkbox_option.html'
Liknar SelectMultiple, men återges som en lista med kryssrutor:
<div>\n <div><input type="checkbox" name="..." ></div>\n ...\n</div>\nDen yttre behållaren <div> får widgetens id-attribut, om det är definierat, eller BoundField.auto_id annars.
Precis som i RadioSelect kan du loopa över de enskilda kryssrutorna för widgetens val. Till skillnad från RadioSelect kommer kryssrutorna inte att innehålla HTML-attributet required om fältet är obligatoriskt eftersom webbläsarvalidering skulle kräva att alla kryssrutor är markerade istället för minst en.
När man loopar över kryssrutorna innehåller taggarna label och input attributen for respektive id. Varje kryssruta har ett id_for_label-attribut för att mata ut elementets ID.
FileInputLink to this heading#template_name: 'django/forms/widgets/file.html'
Renderas som: <input type="file" ...>
Rensa filinmatningLink to this heading#template_name: 'django/forms/widgets/clearable_file_input.html'
Renderas som: <input type="file" ...> med en extra kryssruta för att rensa fältets värde, om fältet inte är obligatoriskt och har initiala data.
SplitDateTimeWidgetLink to this heading#template_name: 'django/forms/widgets/splitdatetime.html'
Omslag (med hjälp av MultiWidget) runt två widgets: DateInput för datum och TimeInput för tid. Måste användas med SplitDateTimeField snarare än DateTimeField.
SplitDateTimeWidget har flera valfria argument:
Liknande DateInput.format
Liknande TimeInput.format
Liknar Widget.attrs. En dictionary som innehåller HTML-attribut som ska ställas in på de renderade widgetarna DateInput respektive TimeInput. Om dessa attribut inte är inställda används istället Widget.attrs.
SelectDateWidgetLink to this heading#template_name: 'django/forms/widgets/select_date.html'
Omslag runt tre Select widgets: en vardera för månad, dag och år.
Tar emot flera valfria argument:
\nEn valfri lista/tupel av år som ska användas i valboxen ”year”. Standard är en lista som innehåller det aktuella året och de kommande 9 åren.
\nEtt valfritt antal månader som ska användas i valboxen ”månader”.
\nDiktens nycklar motsvarar månadsnumret (1-indexerat) och värdena är de visade månaderna:
\nMONTHS = {\n 1: _("jan"),\n 2: _("feb"),\n 3: _("mar"),\n 4: _("apr"),\n 5: _("may"),\n 6: _("jun"),\n 7: _("jul"),\n 8: _("aug"),\n 9: _("sep"),\n 10: _("oct"),\n 11: _("nov"),\n 12: _("dec"),\n}\nOm DateField inte krävs kommer SelectDateWidget att ha ett tomt val längst upp i listan (som är --- som standard). Du kan ändra texten på denna etikett med attributet empty_label. empty_label kan vara en sträng, lista eller tupel. När en sträng används kommer alla valboxar att ha ett tomt val med denna etikett. Om empty_label är en list eller tuple med 3 strängelement, kommer valboxarna att ha sin egen anpassade etikett. Etiketterna bör vara i denna ordning ('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