Is é giuirléid léiriú Django ar eilimint ionchuir HTML. Láimhseálann an giuirléid rindreáil an HTML, agus eastóscadh sonraí ó fhoclóir GET/POST a fhreagraíonn don ghuirléid.
\nÚsáideann an HTML a ghineann na giuirléidí ionsuite comhréir HTML5, ag díriú ar <DOCTYPE html>. Mar shampla, úsáideann sé tréithe boolean mar checked seachas an stíl XHTML de ``checked='checked'`.
Aon uair a shonraíonn tú réimse ar fhoirm, úsáidfidh Django giuirléid réamhshocraithe atá oiriúnach don chineál sonraí atá le taispeáint. Chun a fháil amach cén giuirléid a úsáidtear ar an réimse, féach an doiciméadú fao:ref: built-in-fields.
\nMar sin féin, más mian leat giuirléid dhifriúil a úsáid le haghaidh réimse, is féidir leat an argóint:attr: ~field.widget a úsáid ar an sainmhíniú réimse. Mar shampla:
\nfrom django import forms\n\n\nclass CommentForm(forms.Form):\n name = forms.CharField()\n url = forms.URLField()\n comment = forms.CharField(widget=forms.Textarea)\nSonródh sé seo foirm le trácht a úsáideann giuirléid níos mó: class: Textarea, seachas an giuirléid réamhshocraithe:class: TextInput.
\nTá argóintí breise roghnacha ag go leor giuirléidí; is féidir iad a shocrú agus an giuirléid ar an réimse á shain Sa sampla seo a leanas, socraítear tréith an:attr: ~django.forms.selectDateWidget.years le haghaidh a:class: ~django.forms.selectDateWidget:
\nfrom 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 )\nFéach na:ref: `giuirléidí ionsuite 'le haghaidh tuilleadh faisnéise faoi na giuirléidí atá ar fáil agus cé na hargóintí a nglacann siad leo.
\nNuair a dhéanann Django giuirléid mar HTML, ní dhéanann sé ach marcáil an-íosta - ní chuireann Django ainmneacha ranga leis, ná aon tréithe eile a bhaineann go sonrach le giuirléid. Ciallaíonn sé seo, mar shampla, go mbeidh giuirléidí uill:class: TextInput le feiceáil mar an gcéanna ar do leathanaigh ghréasáin.
\n<styling-widget-classes>Tá dhá bhealach ann chun giuirléidí a shaincheapadh: :ref: in aghaidh an tsampla giuirléid <styling-widget-instances>`agus:ref: `in aghaidh an aicme giuirléid.
\nMás mian leat a chur ar shampla giuirléid amháin difriúil ó shampla eile, beidh ort tréithe breise a shonrú ag an am nuair a dhéantar an réad giuirléid a shannú agus a shannadh do réimse foirme (agus b'fhéidir roinnt rialacha a chur le do chomhaid CSS).
\nMar shampla, glac an fhoirm seo a leanas:
\nfrom django import forms\n\n\nclass CommentForm(forms.Form):\n name = forms.CharField()\n url = forms.URLField()\n comment = forms.CharField()\nThis form will include TextInput widgets for the name and comment\nfields, and a URLInput widget for the url field. Each has default\nrendering - no CSS class, no extra attributes:
>>> 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>\nOn a real web page, you probably want to customize this. You might want a\nlarger input element for the comment, and you might want the 'name' widget to\nhave some special CSS class. It is also possible to specify the 'type'\nattribute to use a different HTML5 input type. To do this, you use the\nWidget.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"}))\nIs féidir leat giuirléid a mhodhnú sa mhíniú foirm freisin:
\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")\nNó mura bhfuil an réimse dearbhaithe go díreach ar an bhfoirm (mar shampla réimsí foirme samhail), is féidir leat an tréith: attr: Form.fields a úsáid:
\nclass 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")\nCuirfidh Django ansin san áireamh na tréithe breise san aschur rindreáilte:
\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>\nIs féidir leat an HTML id a shocrú freisin ag baint úsáid:attr: ~Widget.Attrs. Féach:attr: BoundField.id_for_label mar shampla.
Le giuirléidí, is féidir sócmhainní a chur leis (css` agus javascript`) agus a gcuma agus a n-iompar a shaincheapadh níos doimhne.
\n<dynamic-property>Go hachomair, beidh ort an giuirléid a fho-aicmiú agus fiú:ref: aicme istigh “Meáin” a shainiú `nó: ref: `maoin “meáin” <assets-as-a-static-definition>a chruthú.
\nTá cláir Python beagán chun cinn i gceist leis na modhanna seo agus déantar cur síos mionsonraithe orthu sa threoir ábhair: doc: Foirm Assets </topics/forms/media>.
\n<built-in widgets>Tá ranganna giuirléidí bonn:class: Widget agus:class: MultiWidget fo-aicmithe ag uile na:ref: `giuirléidí ionsuite `agus féadfaidh siad a bheith mar bhunús le haghaidh giuirléidí saincheaptha.
\nGiuirléidLink to this heading#This abstract class cannot be rendered, but provides the basic attribute\nattrs. You may also implement or override the\nrender() method on custom widgets.
Foclóir ina bhfuil tréithe HTML le socrú ar an ngiuirléid rindreáilte.
\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">'\nMá shannann tú luach True nó False` do thréith, déanfar é mar thréith boolean 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">'\nTréith atá réamhshocraithe go True. Má tá sé socraithe go False, socraítear na luachanna micreasoicind de:class: ~datetime.datetime agus:class: ~datetime.time go 0`.
Glanann agus filleann sé luach le húsáid sa teimpléad giuirléid. Ní ráthaítear go mbeidh “luach” ionchur bailí, dá bhrí sin ba cheart forfheidhmithe fo-aicme a chlárú go cosanta.
\nFilleann foclóir luachanna le húsáid agus an teimpléad giuirléid á rindreáil. De réir réamhshocraithe, tá eochair amháin sa fhoclóir, “'giuirléid”, ar léiriú foclóra é ar an ngiuirléid ina bhfuil na heochracha seo a leanas:
\n'is_hidden': Boolean a léiríonn an bhfuil an giuirléid seo i bhfolach nó nach bhfuil.
'riachtan: Boolean a léiríonn cibé an bhfuil an réimse don ghuirléid seo ag teastáil nó nach bhfuil.
`luach: An luach mar a thug ar ais ag: meth: format_value.
'attrs': tréithe HTML atá le socrú ar an ngiuirléid rindreáilte. An teaglaim den tréith: attr: attrs agus an argóint attrs.
`'template_name': Luach self.template_name.
Is féidir le fo-aicmí Widget luachanna comhthéacs saincheaptha a sholáthar tríd an modh seo a shárú.
Tugann sé tréith ID HTML an ghuirléid seo ar ais le húsáid ag <label>```, i bhfianaise ID an réimse. Tugann teaghrán folamh ar ais mura bhfuil aitheantas ar fáil.
\nTá an crúca seo riachtanach toisc go bhfuil ileilimintí HTML ag roinnt giuirléidí agus, dá bhrí sin, iolracha Sa chás sin, ba cheart don modh seo luach aitheantais a fhreagraíonn don chéad aitheantas i gclibeanna an ghuirléid a thabhairt ar ais.
\nTaispeánann sé giuirléid chuig HTML ag baint úsáide as an renderer a thugtar. Más é `renderer None`, úsáidtear an rindeoir ón socrú:setting: FORM_RENDER.
Mar gheall ar fhoclóir sonraí agus ainm an ghuirléid seo, filleann sé luach an ghuirléid seo ar ais. <django.http.HttpRequest.FILES>D'fhéadfadh sonraí a thagann ó:attr: request.files `a bheith i ``comhaid`. Tugann sé ar ais None mura gcuirfí luach ar fáil. Tabhair faoi deara freisin gur féidir glaoch ar value_from_datadict` níos mó ná uair amháin le linn láimhseáil sonraí foirme, mar sin má shaincheapann tú iad agus má chuireann tú próiseáil daor leis, ba cheart duit meicníocht caching éigin a chur i bhfeidhm tú féin.
Mar gheall ar fhoclóirí sonra` agus `comhad ``agus ainm an ghuirléid seo, tugann sé ar ais cibé an bhfuil sonraí nó comhaid ann don ghuirléid nó nach bhfuil.
\n<topics-modelform-save>Bíonn tionchar ag toradh an mhodha cibé acu an dtagann réimse i bhfoirm mhúnla:ref: `ar ais go dtí a réamhshocraithe `nó nach bhfuil.
\n<select multiple>Is iad cásanna speisialta:class: ~django.forms.checkboxInput, :class: ~django.forms.checkboxSelectMultiple, agus:class: ~django.forms.selectMultiple, a fhilleann False i gcónaí toisc nach bhfuil bosca seiceála neamhsheiceáilte agus ```` neamhroghnaithe le feiceáil i sonraí aighneacht HTML, mar sin níl sé anaithnid cibé an chuir an t-úsáideoir luach isteach nó nach bhfuil.
Tréith chun a aithint an gcaithfear an giuirléid a ghrúpáil i ```` le <fieldset>```` nuair a rindreáiltear <legend>é. Réamhshocraithe go False ach tá sé True nuair a bhíonn clibeanna iolracha ```` sa ghuirléid amsúil:class: ~django.forms.CheckboxSelectMultiple, :class: ~django.forms.radioSelect, <input>:class: ~django.forms.datsplitMeWidget, agus:aicme: ~django.forms.selectDateWidget.
Mar gheall ar luach tosaithe réimse foirme, tugann tuairisceáin cibé acu is féidir an giuirléid a léiriú leis an tréith HTML riachtan nó nach féidir. <django.forms.Form.use_required_attribute>Úsáideann fo <django.forms.Field.required>irmeacha an modh seo in éineacht le: attr: Field.Required agus:attr: Form.USE_REQUIRED_ATTRIBUT chun a chinneadh an bhfuil an tréith riachtan a thaispeáint do gach réimse nó nach bhfuil.
De réir réamhshocraithe, filleann False le haghaidh giuirléidí i bhfolach agus True ar shlí eile. Is iad cásanna speisialta:class: ~django.forms.fileInput agus:class: ~django.forms.clearaableFileInput, a fhilleann False nuair a shocraítear initial, agus:class: ~django.forms.checkboxSelectMultiple a sheiceáil i gcónaí in ionad ceann amháin ar a laghad.
Override this method in custom widgets that aren't compatible with\nbrowser validation. For example, a WYSIWYG text editor widget backed by\na hidden textarea element may want to always return False to\navoid browser validation on the hidden field.
MultiwidgetLink to this heading#Giuirléid atá comhdhéanta de iliomad giuirléidí. :class: ~Django.Forms.MultiWidget oibríonn láimh ar láimh leis an: class: ~Django.Forms.MultivalueField.
\nMultiWidget has one required argument:
Athraitheach ina bhfuil na giuirléidí is gá. Mar shampla:
\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">'\nFéadfaidh tú foclóir a sholáthar chun iarmhairtí saincheaptha a shonrú don tréith ainm ``ar gach foghuirléid. Sa chás seo, do gach péire ``(eochair, giuirléid), cuirfear an eochair le ainm ``den ghuirléid d'fhonn an luach tréithe a ghiniúint. Féadfaidh tú an teaghrán folamh ("``) a sholáthar d'eochair amháin, d'fhonn an iarmhír do ghuirléid amháin a chur faoi chois. Mar shampla:
>>> 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">'\nAgus modh amháin riachtanach:
\nTógann an modh seo luach amháin “comhbhrúite” ón réimse agus filleann sé liosta de luachanna “díchomhbhrúite” ar ais. Is féidir glacadh leis an luach ionchuir bailí, ach ní gá go bhfuil sé folamh.
\nCaithfidh an fo-aicme an modh seo a chur i bhfeidhme, agus ós rud é go bhféadfadh an luach a bheith folamh, caithfidh an cur i bhfeidhm a bheith cosanta.
\nIs é an réasúnaíocht atá taobh thiar de “díchomhbhrúite” ná go bhfuil sé riachtanach luach comhcheangailte na réimse foirme a “roinnt” sna luachanna do gach giuirléid.
\nSampla de seo is ea conas a chasann: class: SplitDateTimeWidget luach a: class: ~datetime.datetime ina liosta le dáta agus am roinnte ina dhá luach ar leithligh:
\nfrom 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]\nSoláthraíonn sé roinnt comhthéacs saincheaptha:
\nChomh maith leis an eochair 'widget' a thuairiscítear in:meth: Widget.get_context, cuireann MultiWidget eochair ``widget ['subwidgets'] ``leis.
Is féidir iad seo a lúbadh sa teimpléad giuirléid:
\n{% for subwidget in widget.subwidgets %}\n {% include subwidget.template_name with widget=subwidget %}\n{% endfor %}\nSeo giuirléid shampla a dhéanann fo-aicmi:class: MultiWidget chun dáta a thaispeáint leis an lá, an mhí agus an bhliain i mboscaí roghnaithe éagsúla. Tá sé beartaithe an giuirléid seo a úsáid le a:class: ~django.forms.datefield seachas a:class: ~django.forms.multivaluefield, mar sin tá: meth: ~Widget.value_from_dataDict curtha i bhfeidhm againn:
\nfrom 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)\nCruthaíonn an tógálaí giuirléidí roinnt: class: Roghnaithe i liosta. Úsáideann an modh ``super () ``an liosta seo chun an giuirléid a chur ar bun.
\nBriseann an modh riachtanach: “~ MultiWidget.Decompress` luach datetime.date ``isteach sna luachanna lae, míosa agus bliana a fhreagraíonn do gach giuirléid. Má roghnaíodh dáta neamhbhailí, mar shampla an 30 Feabhra nach raibh ann, téann an:class: `~django.forms.datefield teaghrán ar an modh seo ina ionad sin, ionas gur gá parsáil air sin. Láimhseálann an fillead deiridh nuair is é `luach None, rud a chiallaíonn nach bhfuil aon réamhshocraithe againn dár bhfo-ghuirléidí.
Tugann cur i bhfeidhm réamhshocraithe de:meth: ~Widget.value_from_datadict liosta luachanna a fhreagraíonn do gach Widget. Tá sé seo oiriúnach nuair a úsáidtear MultiWidget le a:class: ~django.forms.MultivalueField. Ach ós rud é gur mhaith linn an giuirléid seo a úsáid le a:class: ~django.forms.datefield, a thógann luach amháin, tá an modh seo curtha againn. Comhcheanglaíonn an cur i bhfeidhm anseo na sonraí ó na fo-ghuirléidí i sreang san fhormáid a bhfuil súil ag: Class: ~Django.Forms.DateField ag súil leis.
<selector-widgets><file-upload-widgets><composite-widgets>Soláthraíonn Django léiriú ar na giuirléidí HTML bunúsacha go léir, móide roinnt grúpaí giuirléidí a úsáidtear go coitianta sa mhodúl django.forms.widgets`, lena n-áirítear: ref: ionchur téacs <text-widgets>, :ref: `láimhseáil ionchur illuacha'.
\nBaineann na giuirléidí seo úsáid as na heilimintí HTML input agus textarea.
TextinputLink to this heading#Ionchur UimhreachLink to this heading#input_type: 'uimhreach'
template_name: django/foirmeach/giuirléid/uimh.html'
Bí cúramach nach dtacaíonn gach brabhsálaí le huimhreacha áitiúla a iontráil i gcineálacha ionchuir uim Seachnaíonn Django féin iad a úsáid le haghaidh réimsí a bhfuil a maoin: attr: `~django.forms.field.localize` socraithe go ``True.
Ionchur ríomhphostLink to this heading#UrlinputLink to this heading#ColorInputLink to this heading#input_type: 'color'
template_name:'django/forms/widgets/color.html'
Renders as: <input type="color" ...>
SearchInputLink to this heading#input_type: 'search'
template_name: 'django/forms/widgets/search.html'
Renders as: <input type="search" ...>
TelInputLink to this heading#input_type: 'tel'
template_name: 'django/forms/widgets/tel.html'
Renders as: <input type="tel" ...>
Browsers perform no client-side validation by default because telephone\nnumber formats vary so much around the world. You can add some by setting\npattern, minlength, or maxlength in the Widget.attrs\nargument.
Additionally, you can add server-side validation to your form field with a\nvalidator like RegexValidator or via\nthird-party packages, such as django-phonenumber-field.
PasswordInputLink to this heading#input_type: ``pasfhocal `
template_name: django/foirmeach/giuirléid/pasfho.html'
Tógann sé argóint roghnach amháin:
\nCinneann sé an mbeidh luach líonta isteach sa ghuirléid nuair a aththaispeántar an fhoirm tar éis earráid bailíochtaithe (is é “False” réamhshocraithe).
\nDateInputLink to this heading#input_type: 'téacs'
template_name: django/foirmeach/giuirléid/date.html'
Glacann sé argóintí céanna as:class: TextInput, le argóint roghnach amháin eile:
\nAn fhormáid ina taispeánfar luach tosaigh an réimse seo.
\nMura gcuirtear argóint formáid ar fáil, is é an fhormáid réamhshocraithe an chéad fhormáid atá le fáil in:setting: DATE_INPUT_FORMATS agus respts:doc: /topics/i18n/formatting. Ní thacaíonn an giuirléid seo le formáidí %U, %W`, agus %j.
DateTimeInputLink to this heading#input_type: 'téacs'
template_name: django/foirmeach/giuirléid/datetime.html'
Glacann sé argóintí céanna as:class: TextInput, le argóint roghnach amháin eile:
\nAn fhormáid ina taispeánfar luach tosaigh an réimse seo.
\nMura gcuirtear argóint formáid ar fáil, is é an fhormáid réamhshocraithe an chéad fhormáid a fhaightear in:setting: DATETIME_INPUT_FORMATS agus respts:doc: /topics/i18n/formatting. Ní thacaíonn an giuirléid seo le formáidí %U, %W`, agus %j.
De réir réamhshocraithe, socraítear an chuid micrea-soicind den luach ama i gcónaí go 0. Má tá micreasoicind ag teastáil, bain úsáid as fo-aicme leis an tréith: attr: ~Widget.supports_microseconds atá socraithe go True.
input_type: 'téacs'
template_name: django/foirmeach/giuirléid/time.html'
Glacann sé argóintí céanna as:class: TextInput, le argóint roghnach amháin eile:
\nAn fhormáid ina taispeánfar luach tosaigh an réimse seo.
\nMura gcuirtear argóint formáid ar fáil, is é an fhormáid réamhshocraithe an chéad fhormáid atá le fáil in:setting: TIME_INPUT_FORMATS agus respts:doc: /topics/i18n/formatting.
Chun micreasoicind a chóireáil, féach: aicme: DateTimeInput.
\nTextareaLink to this heading#template_name: django/foirmeach/giuirléid/textarea.html'
<textarea>Léiríonn sé mar: ``...</textarea> ``
<input type="radio">Úsáideann na giuirléidí seo na heilimintí HTML <select>, , agus<input type="checkbox"> `` `.
Tá tréith option_template_name ag giuirléidí a dhéanann roghanna iolracha a shonraíonn an teimpléad a úsáidtear chun gach rogha a rinneadh. <option><select>Mar shampla, don ghuirléid: Class: Select, tugann select_option.html an ```` le haghaidh ``.
Bosca Seiceála IonchuLink to this heading#input_type: 'bosca seiceála
template_name: django/foirmeach/giuirléid/seicebox.html'
Tógann sé argóint roghnach amháin:
\nInghlaonta a thógann luach an CheckboxInput agus a thugann ar ais True má chóir an bosca seiceála a sheiceáil don luach sin.
RoghnaitheLink to this heading#template_name: django/foirmeach/giuirléid/roghnaithe.html'
option_template_name: `django/foirmeach/giuirléid/roghnaithe_roghnaithe.html'
<select>Léiríonn sé mar: ``...</select> <option ...> ``
Tá an tréith seo roghnach nuair nach bhfuil tréith “roghanna” ag an réimse foirme. Má dhéanann sé, athróidh sé aon rud a shocraíonn tú anseo nuair a dhéantar an tréith a nuashonrú ar:class: Field.
\nNullbooleanSelectLink to this heading#template_name: django/foirmeach/giuirléid/roghnaithe.html'
option_template_name: `django/foirmeach/giuirléid/roghnaithe_roghnaithe.html'
Roghnaigh giuirléid le roghanna 'Anaithnid', 'Tá' agus 'Níl'
\nRoghnaigh IolraitheLink to this heading#template_name: django/foirmeach/giuirléid/roghnaithe.html'
option_template_name: `django/foirmeach/giuirléid/roghnaithe_roghnaithe.html'
<select multiple>Cosúil le:aicme: Roghnaigh `, ach ceadaíonn roghnú iolrach: `...</select> ``
\nRadioSelectLink to this heading#template_name: django/foirmeach/giuirléid/radio.html'
option_template_name: django/foirmeach/giuirléid/radio_option.html'
<div>Cosúil le:class: Roghnaigh `, ach rinneadh mar liosta de na cnaipí raidió laistigh de chlibeanna ``:
\n<div>\n <div><input type="radio" name="..."></div>\n ...\n</div>\nLe haghaidh níos mó rialaithe gráinneach ar an marcáil a ghintear, is féidir leat lúb thar na cnaipí raidió sa teimpléad. Ag glacadh le foirm myform le réimse beatles a úsáideann RadioSelect mar a ghuirléid:
<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>\nGhinfeadh sé seo an HTML seo a leanas:
\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>\nÁiríodh sin na clibeanna <label>```. Chun níos gráinneach a fháil, is féidir leat tréithe tag, choice_label` agus id_for_label gach cnaipe raidió a úsáid. Mar shampla, an teimpléad seo...
<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... beidh an HTML seo a leanas mar thoradh air:
\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>\n<div>Má shocraíonn tú gan lúb thar na cnaipí raidió - m.sh., má chuimsíonn do theimpléad {{myform.beatles}} -- aschur iad i ```` le clibeanna <div>, mar atá thuas.
Faigheann an co <div>imeádán seachtrach `tréith `id den ghuirléid, má tá sé sainmhínithe, nó:attr: BoundField.AUTO_ID ar shlí eile.
Agus tú ag lúbadh thar na cnaipí raidió, cuimsíonn na clibeanna lip agus ionchuir tréithe for agus id`, faoi seach. Tá tréith id_for_label ag gach cnaipe raidió chun aitheantas an eilimint a aschur.
SeiceboxSelectMultipleLink to this heading#template_name: django/foirmeach/giuirléid/checkbox_select.html'
option_template_name: django/foirmeach/giuirléid/seicebox_option.html'
Cosúil le:class: SelectMultiple, ach rinneadh mar liosta boscaí seiceála:
\n<div>\n <div><input type="checkbox" name="..." ></div>\n ...\n</div>\nFaigheann an co <div>imeádán seachtrach `tréith `id den ghuirléid, má tá sé sainmhínithe, nó:attr: BoundField.AUTO_ID ar shlí eile.
Cosúil le: Class: RadioSelect, is féidir leat lúb thar na boscaí seiceála aonair le haghaidh roghanna an ghuirléid. Gan amhlai:Class: RadioSelect, ní chuimsíonn na boscaí seiceála an tréith HTML riachtan má theastaíonn an réimse toisc go mbeadh bailíochtú brabhsálaí ag iarraidh gach bosca seiceála a sheiceáil in ionad ceann amháin ar a laghad.
Nuair a dhéantar na boscaí seiceála, cuimsíonn na clibeanna lip agus ionchur ``tréithe ``for agus id, faoi seach. Tá tréith id_for_label ag gach bosca seiceála chun aitheantas an eilimint a aschur.
FileInputLink to this heading#ClearableFileInputLink to this heading#template_name: django/foirmeach/giuirléid/clearable_file_input.html'
Léiríonn sé mar: <input type="file" ...> le hionchur bosca seiceála breise chun luach an réimse a ghlanadh, mura bhfuil an réimse ag teastáil agus mura bhfuil sonraí tosaigh aige.
SplitDateTimeWidgetLink to this heading#template_name: django/foirmeach/giuirléid/splitdatetime.html'
Fillteán (ag baint úsáide:class: MultiWidget) timpeall dhá ghuirléid: :class: DateInput don dáta, agus:class: TimeInput don am. Ní mór é a úsáid le:class: SplitDateTimeField seachas: class: DateTimeField.
\nTá roinnt argóintí roghnacha ag SplitDateTimeWidget:
Cosúil le:attr: DateInput.format
\nCosúil le:attr: TimeInput.format
\nCosúil le:attr: Widget.Attrs. Foclóir ina bhfuil tréithe HTML le socrú ar na giuirléidí rindered:class: DateInput agus:class: TimeInput faoi seach. Mura bhfuil na tréithe seo socraithe, úsáidtear: attr: Widget.attrs ina ionad.
\nSelectDateWidgetLink to this heading#template_name: django/foirmeach/giuirléid/roghnaithe_dát.html'
Fillteán timpeall trí: aicme: ~django.forms.select giuirléidí: ceann amháin ar feadh míosa, lá agus bliana.
\nGlacann sé roinnt argóintí roghnach
\nLiosta roghnach de na blianta le húsáid sa bhosca roghnaithe “bliain”. Is é an réamhshocrú liosta ina bhfuil an bhliain reatha agus na 9 mbliana amach romhainn.
\nOrdú roghnach míonna le húsáid sa bhosca roghnaithe “míonna”.
\nFreagraíonn eochracha an dict d'uimhir na míosa (1-innéacsaithe) agus is iad na luachanna na míonna a thaispeántar:
\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}\nMura bhfuil an: class: ~django.forms.DateField ag teastáil, beidh rogha folamh ag :class: SelectDateWidget ag barr an liosta (atá --- de réir réamhshocraithe). Is féidir leat téacs an lipéid seo a athrú leis an tréith empty_label. Is féidir le empty_label a bheith ina string, liost`, nó tuple. Nuair a úsáidtear sreang, beidh rogha folamh ag gach bosca roghnaithe leis an lipéad seo. Más liosta ``nó ``tuple de 3 eilimint sreangán é empty_label, beidh a lipéad saincheaptha féin ag na boscaí roghnaithe. Ba chóir go mbeadh na lipéid san ord seo ('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