{"title":"Réimsí foirm","version":"6.1","locale":"ga","docname":"ref/forms/fields","url":"/ga/6.1/ref/forms/fields/","canonical":"https://djangodocs.dev/ga/6.1/ref/forms/fields/","summary":"Nuair a chruthaíonn tú rang Foirme, is é an chuid is tábhachtaí ná réimsí na foirme a shainiú.","html":"

Réimsí foirmLink to this heading#

\n
\n
\nclass FieldLink to this definition#
\n
\n\n

Nuair a chruthaíonn tú rang Foirme, is é an chuid is tábhachtaí ná réimsí na foirme a shainiú. Tá loighic bailíochtaithe saincheaptha ag gach réimse, mar aon le cúpla crúca eile.

\n
\n
\nField.clean(value)Link to this definition#
\n
\n\n

Cé go bhfuil an príomhbhealach a úsáidfidh tú ranganna Field i ranganna Foirme, is féidir leat iad a chur i bhfeidhm agus iad a úsáid go díreach chun tuairim níos fearr a fháil ar an gcaoi a n-oibríonn siad. Tá modh clean () ``ag gach cás ``Field`, a thógann argóint amháin agus a ardaíonn eisceacht ``Django.Core.Exceptions.ValidationError nó a thugann an luach glan ar ais:

\n
Python console
>>> from django import forms\n>>> f = forms.EmailField()\n>>> f.clean("foo@example.com")\n'foo@example.com'\n>>> f.clean("invalid email address")\nTraceback (most recent call last):\n...\nValidationError: ['Enter a valid email address.']\n
\n
\n

Argóintí lárnach réimseLink to this heading#

\n

Glacann gach tógálaí ranga Field` ar a laghad na hargóintí seo. Glacann roinnt ranganna ``Réimse argóintí breise, atá sonrach le réimse, ach ba cheart glacadh leis na rudaí seo a leanas i gcónaí*:

\n
\n

`riachtanaiLink to this heading#

\n
\n
\nField.requiredLink to this definition#
\n
\n\n

De réir réamhshocraithe, glacann gach rang Field go bhfuil an luach ag teastáil, mar sin má chuireann tú luach folamh -- None nó an teaghrán folamh (``````````) -- ansin ardóidh clean () ``eisceacht ``ValidationError:

\n
Python console
>>> from django import forms\n>>> f = forms.CharField()\n>>> f.clean("foo")\n'foo'\n>>> f.clean("")\nTraceback (most recent call last):\n...\nValidationError: ['This field is required.']\n>>> f.clean(None)\nTraceback (most recent call last):\n...\nValidationError: ['This field is required.']\n>>> f.clean(0)\n'0'\n>>> f.clean(True)\n'True'\n>>> f.clean(False)\n'False'\n
\n

Chun a shonrú go bhfuil réimse *ní gá, cuir required=False chuig an tógálaí Field:

\n
Python console
>>> f = forms.CharField(required=False)\n>>> f.clean("foo")\n'foo'\n>>> f.clean("")\n''\n>>> f.clean(None)\n''\n>>> f.clean(0)\n'0'\n>>> f.clean(True)\n'True'\n>>> f.clean(False)\n'False'\n
\n

Má tá required=false ``ag `Field agus má chuireann tú luach folamh ar clean (), ansin cuirfidh clean () ``luach folm*normalaithe* ar ais seachas ``ValidationError` a ardú. Maidir le charfield, cuirfidh sé seo ar ais: attr: ~charfield.empty_value atá réamhshocraithe go sreang folamh. Maidir le ranganna eile Field`, d'fhéadfadh sé a bheith ``None. (Athraíonn sé seo ó réimse go réimse.)

\n

Tá an tréith HTML “riachtanach” ag giuirléidí de réimsí foirme riachtanacha. Socraigh an tréith: attr: Form.USE_REQUIRED_ATTRIBUTE le False` chun é a dhíchumasú. Ní chuirtear an tréith “riachtanach” san áireamh ar fhoirmeacha foirmeacha mar b'fhéidir nach mbeidh bailíochtú an bhrabhsálaí ceart agus foirmeacha á gcur leis agus á scriosadh.

\n
\n
\n

lipéadLink to this heading#

\n
\n
\nField.labelLink to this definition#
\n
\n\n

Ligeann an argóint lipéad duit an lipéad “atá cairdiúil don duine” don réimse seo a shonrú. Úsáidtear é seo nuair a thaispeántar an Réimse i Foirm`.

\n

As explained in Foirmeacha a chur amach mar HTML, the default label for a\nField is generated from the field name by converting all underscores to\nspaces and upper-casing the first letter. Specify a string for label if\nthat default behavior doesn't result in an adequate label. Use an empty string\n("") to hide the label.

\n

Seo sampla iomlán Foirm ``a chuireann `lipéad i bhfeidhm do dhá cheann dá réimsí. Tá auto_id=false` sonraithe againn chun an t-aschur a shimpliú:

\n
Python console
>>> from django import forms\n>>> class CommentForm(forms.Form):\n...     name = forms.CharField(label="Your name")\n...     url = forms.URLField(label="Your website", required=False)\n...     comment = forms.CharField()\n...\n>>> f = CommentForm(auto_id=False)\n>>> print(f)\n<div>Your name:<input type="text" name="name" required></div>\n<div>Your website:<input type="url" name="url"></div>\n<div>Comment:<input type="text" name="comment" required></div>\n
\n
\n
\n

iarmhair_lipéadLink to this heading#

\n
\n
\nField.label_suffixLink to this definition#
\n
\n\n

Ligeann an argóint label_suffix` duit an fhoirm 's:attr: ~django.forms.form.label_suffix a shárú ar bhonn in aghaidh an réimse:

\n
Python console
>>> class ContactForm(forms.Form):\n...     age = forms.IntegerField()\n...     nationality = forms.CharField()\n...     captcha_answer = forms.IntegerField(label="2 + 2", label_suffix=" =")\n...\n>>> f = ContactForm(label_suffix="?")\n>>> print(f)\n<div><label for="id_age">Age?</label><input type="number" name="age" required id="id_age"></div>\n<div><label for="id_nationality">Nationality?</label><input type="text" name="nationality" required id="id_nationality"></div>\n<div><label for="id_captcha_answer">2 + 2 =</label><input type="number" name="captcha_answer" required id="id_captcha_answer"></div>\n
\n
\n
\n

tosaitheLink to this heading#

\n
\n
\nField.initialLink to this definition#
\n
\n\n

Ligeann an argóint tosaithe duit an luach tosaigh le húsáid a shonrú agus an Réimse seo a rindreáil i Foirme neamhcheangailte.

\n

Chun sonraí tosaigh dinimiciúla a shonrú, féach an paraiméadar: attr: Form.initial.

\n

Is é an cás úsáide seo nuair is mian leat foirm “folamh” a thaispeáint ina ndéantar réimse a thionscnamh go luach áirithe. Mar shampla:

\n
Python console
>>> from django import forms\n>>> class CommentForm(forms.Form):\n...     name = forms.CharField(initial="Your name")\n...     url = forms.URLField(initial="https://")\n...     comment = forms.CharField()\n...\n>>> f = CommentForm(auto_id=False)\n>>> print(f)\n<div>Name:<input type="text" name="name" value="Your name" required></div>\n<div>Url:<input type="url" name="url" value="https://" required></div>\n<div>Comment:<input type="text" name="comment" required></div>\n
\n

B'fhéidir go bhfuil tú ag smaoineamh, cén fáth nach rachadh foclóir de na luachanna tosaigh mar shonraí agus an fhoirm á thaispeáint agat? Bhuel, má dhéanann tú é sin, spreagfaidh tú bailíochtú, agus beidh aon earráidí bailíochtaithe san aschur HTML san áireamh:

\n
Python console
>>> class CommentForm(forms.Form):\n...     name = forms.CharField()\n...     url = forms.URLField()\n...     comment = forms.CharField()\n...\n>>> default_data = {"name": "Your name", "url": "https://"}\n>>> f = CommentForm(default_data, auto_id=False)\n>>> print(f)\n<div>Name:\n  <input type="text" name="name" value="Your name" required>\n</div>\n<div>Url:\n  <ul class="errorlist"><li>Enter a valid URL.</li></ul>\n  <input type="url" name="url" value="https://" required aria-invalid="true">\n</div>\n<div>Comment:\n  <ul class="errorlist"><li>This field is required.</li></ul>\n  <input type="text" name="comment" required aria-invalid="true">\n</div>\n
\n

Sin é an fáth nach dtaispeántar luachanna tosaithe ach le haghaidh foirmeacha neamhcheangailte. Maidir le foirmeacha ceangailte, úsáidfidh an t-aschur HTML na sonraí ceangailte.

\n

Tabhair faoi deara freisin nach n-úsáidtear luachanna tosaithe mar shonraí “fillte” i mbailíochtú mura dtugtar luach réimse áirithe. Is iad luachanna tosaithe amháin atá beartaithe le haghaidh taispeáint foirme tosaigh:

\n
Python console
>>> class CommentForm(forms.Form):\n...     name = forms.CharField(initial="Your name")\n...     url = forms.URLField(initial="https://")\n...     comment = forms.CharField()\n...\n>>> data = {"name": "", "url": "", "comment": "Foo"}\n>>> f = CommentForm(data)\n>>> f.is_valid()\nFalse\n# The form does *not* fallback to using the initial values.\n>>> f.errors\n{'url': ['This field is required.'], 'name': ['This field is required.']}\n
\n

In ionad tairiseach, is féidir leat aon ghlaoch a rith freisin:

\n
Python console
>>> import datetime\n>>> class DateForm(forms.Form):\n...     day = forms.DateField(initial=datetime.date.today)\n...\n>>> print(DateForm())\n<div><label for="id_day">Day:</label><input type="text" name="day" value="2023-02-11" required id="id_day"></div>\n
\n

Ní dhéanfar an glaoch a mheas ach amháin nuair a thaispeántar an fhoirm neamhcheangailte, ní nuair a shainmhínítear í.

\n
\n
\n

giuirléidLink to this heading#

\n
\n
\nField.widgetLink to this definition#
\n
\n\n

Ligeann an argóint widget duit rang Widget a shonrú le húsáid agus an `Réimse ``seo á rindreáil. Féach: doc: `/ref/forms/giuirléidí `le haghaidh tuilleadh faisnéise.

\n
\n
\n

téacs_cabhrachLink to this heading#

\n
\n
\nField.help_textLink to this definition#
\n
\n\n

Ligeann an argóint help_text duit téacs tuairisciúil a shonrú don Field seo. Má sholáthraíonn tú help_text, taispeánfar é in aice leis an Réimse nuair a dhéanfar an Field le ceann de na modhanna áisiúla Foirm (m.sh., ``as_ul () ``).

\n

Cosúil leis an réimse samhail:: attr: ~django.db.models.field.help_text, níl an luach seo ag éalú HTML i bhfoirmeacha a ghintear go huathoibríoch.

\n

Seo sampla iomlán Form a chuireann help_text i bhfeidhm do dhá cheann dá réimsí. Tá auto_id=false` sonraithe againn chun an t-aschur a shimpliú:

\n
Python console
>>> from django import forms\n>>> class HelpTextContactForm(forms.Form):\n...     subject = forms.CharField(max_length=100, help_text="100 characters max.")\n...     message = forms.CharField()\n...     contact_email = forms.EmailField(help_text="Your email (so we can reply).")\n...\n>>> f = HelpTextContactForm(auto_id=False)\n>>> print(f)\n<div>Subject:<div class="helptext">100 characters max.</div><input type="text" name="subject" maxlength="100" required></div>\n<div>Message:<input type="text" name="message" required></div>\n<div>Contact email:<div class="helptext">Your email (so we can reply).</div><input type="email" name="contact_email" maxlength="320" required></div>\n
\n

Nuair a bhíonn téacs cabhrach ag réimse tá baint aige lena ionchur ag baint úsáide as an tréith HTML aria-describedby. <input>Má chuirtear an giuirléid i `an <fieldset>sin cuirtear ``aria-describedby leis an eilimint seo, ar shlí eile cuirtear é le``` `giuirléid:

\n
Python console
>>> from django import forms\n>>> class UserForm(forms.Form):\n...     username = forms.CharField(max_length=255, help_text="e.g., user@example.com")\n...\n>>> f = UserForm()\n>>> print(f)\n<div>\n<label for="id_username">Username:</label>\n<div class="helptext" id="id_username_helptext">e.g., user@example.com</div>\n<input type="text" name="username" maxlength="255" required aria-describedby="id_username_helptext" id="id_username">\n</div>\n
\n

Agus tréith saincheaptha aria-describedby á chur leis, déan cinnte go gcuirfidh tú id ``den eilimint ``help_text (má úsáidtear é) san ord atá ag teastáil san áireamh freisin. Maidir le húsáideoirí léitheoirí scáileáin, léitear tuairiscí ina n-ord cuma laistigh de aria-describedby`:

\n
Python console
>>> class UserForm(forms.Form):\n...     username = forms.CharField(\n...         max_length=255,\n...         help_text="e.g., user@example.com",\n...         widget=forms.TextInput(\n...             attrs={"aria-describedby": "custom-description id_username_helptext"},\n...         ),\n...     )\n...\n>>> f = UserForm()\n>>> print(f["username"])\n<input type="text" name="username" aria-describedby="custom-description id_username_helptext" maxlength="255" id="id_username" required>\n
\n
\n
\n

teachtaireachtaí earráidLink to this heading#

\n
\n
\nField.error_messagesLink to this definition#
\n
\n\n

Ligeann an argóint error_messages duit na teachtaireachtaí réamhshocraithe a ardóidh an réimse a shárú. Pas isteach i bhfoclóir le heochracha a mheaitseálann leis na teachtaireachtaí earráide is mian leat a shárú. Mar shampla, seo an teachtaireacht earráide réamhshocraithe:

\n
Python console
>>> from django import forms\n>>> generic = forms.CharField()\n>>> generic.clean("")\nTraceback (most recent call last):\n  ...\nValidationError: ['This field is required.']\n
\n

Agus seo teachtaireacht earráide saincheaptha:

\n
Python console
>>> name = forms.CharField(error_messages={"required": "Please enter your name"})\n>>> name.clean("")\nTraceback (most recent call last):\n  ...\nValidationError: ['Please enter your name']\n
\n

Sa chuid ranganna Réimse ionsuite `_ thíos, sainmhíníonn gach ``Field na heochracha teachtaireachta earráide a úsáideann sé.

\n
\n
\n

``bailíochtóirí ``Link to this heading#

\n
\n
\nField.validatorsLink to this definition#
\n
\n\n

Ligeann an argóint bailíochtaire duit liosta feidhmeanna bailíochtaithe a sholáthar don réimse seo.

\n

Féach na:doc: doiciméadú bailíochtóir le haghaidh tuilleadh eolais. </ref/validators>

\n
\n
\n

logánaitheLink to this heading#

\n
\n
\nField.localizeLink to this definition#
\n
\n\n

Cuireann an argóint localize` ar chumas ionchur sonraí foirme a logánú, chomh maith leis an aschur rindreáilte.

\n

Féach an formáid doiciméadú logánaithe le haghaidh tuilleadh eolais.

\n
\n
\n

díchumasaLink to this heading#

\n
\n
\nField.disabledLink to this definition#
\n
\n\n

Déanann an argóint boolean díchumasa, nuair a shocraíonn sé go True, réimse foirme a dhíchumasú ag baint úsáide as an tréith HTML disabled ionas nach mbeidh úsáideoirí é in eagar. Fiú má chuireann úsáideoir isteach ar luach an réimse a chuirtear chuig an bhfreastalaí, déanfar neamhaird air i bhfabhar an luach ó shonraí tosaigh na foirme.

\n
\n
\n

ainmne_teimpléadLink to this heading#

\n
\n
\nField.template_nameLink to this definition#
\n
\n\n

Ligeann an argóint template_name teimpléad saincheaptha a úsáid nuair a dhéantar an réimse a léiriú le:meth: ~django.forms.boundfield.as_field_group. De réir réamhshocraithe tá an luach seo socraithe go ” django/forms/field.html “. Is féidir é a athrú in aghaidh an réimse tríd an tréith seo a shárú nó níos ginearálta tríd an teimpléad réamhshocraithe a shárú, féach freis:ref: overriding-built-in-field-templates.

\n
\n
\n

bound_field_classLink to this heading#

\n
\n
\nField.bound_field_classLink to this definition#
\n
\n\n

The bound_field_class attribute allows a per-field override of\nForm.bound_field_class.

\n
\n
\n
\n

Seiceáil an bhfuil athrú tagtha ar na sonraí réimseLink to this heading#

\n
\n

``aigh_athraigh () ``Link to this heading#

\n
\n
\nField.has_changed()Link to this definition#
\n
\n\n

Úsáidtear an modh has_changed () ``chun a chinneadh an bhfuil luach an réimse athraithe ón luach tosaigh. Tuairisceáin ``True nó False.

\n

See the Form.has_changed documentation for more information.

\n
\n
\n
\n

Ranganna ``Réimse ``tógthaLink to this heading#

\n

Ar ndóigh, tagann sraith ranganna Réimse sa leabharlann foirme` a léiríonn riachtanais choiteanna bailíochtaithe. Doiciméadaítear an chuid seo gach réimse ionsuite.

\n

I gcás gach réimse, déanaimid cur síos ar an ngiuirléid réamhshocraithe a úsáidtear mura sonraíonn tú giuirléid`. Sonraímid freisin an luach a chuirtear ar ais nuair a sholáthraíonn tú luach folamh (féach an chuid ar ``riachtan thuas chun a thuiscint cad a chiallaíonn sé sin).

\n
\n

BooleanfieldLink to this heading#

\n
\n
\nclass BooleanField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: CheckboxInput

    • \n

  • Luach folamh: Fréag

    • \n

  • Normalaítear go dtí: Luach Python True nó False`.

    • \n

  • Bailíonn sé gurb é an luach True (m.sh. seiceáiltear an bosca seiceála) má tá required=True sa réimse.

    • \n

  • Eochracha teachtaireachta earráide: riachtan

    • \n
\n\n
\n\n
\n
\n

CharfieldLink to this heading#

\n
\n
\nclass CharField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: textInput

    • \n

  • Luach folamh: Cibé rud a thug tú mar: attr: empty_value.

    • \n

  • Normalaítear go dtí: Sreang.

    • \n

  • Úsáid:aicme: ~django.core.validators.maxLengthValidator agus:class: ~django.core.validators.minLengthValidator má chuirtear max_length ``agus ``min_length `min_length` ``ar fáil. Seachas sin, tá gach ionchur bailí.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, max_length ``, `min_length `

    • \n
\n

Tá na hargóintí roghnacha seo a leanas ann le haghaidh bailíoch

\n
\n
\nmax_lengthLink to this definition#
\n
\n\n
\n
\nmin_lengthLink to this definition#
\n

Má chuirtear ar fáil, cinntíonn na hargóintí seo go bhfuil an sreang ar a mhéad nó ar a laghad an fad tugtha.

\n
\n\n
\n
\nstripLink to this definition#
\n

Má tá True (réamhshocraithe), déanfar an luach a bhaint as spás bán tosaigh agus rianúil.

\n
\n\n
\n
\nempty_valueLink to this definition#
\n

An luach le húsáid chun “folamh” a léiriú. Réamhshocraithe chuig teaghrán folamh.

\n
\n\n
\n\n
\n
\n

Réimse roghnaíLink to this heading#

\n
\n
\nclass ChoiceField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: `Roghnaigh `

    • \n

  • Luach folamh: ``"``(teaghrán folamh)

    • \n

  • Normalaítear go dtí: Sreang.

    • \n

  • Bailíonn sé go bhfuil an luach a thugtar ar liosta na roghanna.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, invalid_choice`

    • \n
\n

D'fhéadfadh go mbeadh % (value) s sa teachtaireacht earráide invalid_choice, agus cuirfear an rogha roghnaithe in ionad.

\n

Tógann sé argóint breise amháin:

\n
\n
\nchoicesLink to this definition#
\n

<field-choices-enum-types>Ceachtar:term: iterable de dhá thúpla le húsáid mar roghanna don réimse seo, :ref: cineál áireamh `, nó glaoch a thugann athraitheach den sórt sin. Glacann an argóint seo leis na formáidí céanna leis an argóint ``roghna` le réimse samhail. Féach an:ref: `doiciméadú tagartha réimse samhail maidir le roghanna <field-choices>`le haghaidh tuilleadh sonraí. Má tá an argóint inghlaonta, déantar é a mheas gach uair a thionscnaítear foirm an réimse, i dteannta le linn rindreála. Réamhshocraithe ar liosta folamh.

\n
\n\n\n
\n\n
\n
\n

Dáta réimseLink to this heading#

\n
\n
\nclass DateField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: DateInput

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Rud Python datetime.date.

    • \n

  • Bailíonn sé gur datetime.date`, datetime.datetime` nó teaghrán formáidithe i bhformáid dáta áirithe an luach a thugtar.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Tógann sé argóint roghnach amháin:

\n
\n
\ninput_formatsLink to this definition#
\n

Athraitheach formáidí a úsáidtear chun iarracht a dhéanamh teaghrán a thiontú go réad bailí datetime.date.

\n
\n\n

Mura gcuirtear argóint input_formats ar fáil, tógtar na formáidí ionchuir réamhshocraithe ón bhformáid áitiúil gníomhach DATE_INPUT_FORMATS eochair, nó ó:setting: DATE_INPUT_FORMATS má tá logánú díchumasaithe. Féach freis:doc: `formáid logánaithe' </topics/i18n/formatting>.

\n
\n\n
\n
\n

DataTimeFieldLink to this heading#

\n
\n
\nclass DateTimeField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: DateTimeInput

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Rud Python datetime.datetime.

    • \n

  • Bailíonn sé gur datetime.datetime`, datetime.date` nó teaghrán formáidithe i bhformáid dáta-ama áirithe an luach a thugtar.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Tógann sé argóint roghnach amháin:

\n
\n
\ninput_formatsLink to this definition#
\n

Athraitheach formáidí a úsáidtear chun iarracht a dhéanamh teaghrán a thiontú go réad bailí datetime.datetime`, i dteannta formáidí ISO 8601.

\n
\n\n

Glacann an réimse i gcónaí le teaghráin i ndátaí formáidithe ISO 8601 nó den chineál céanna aitheanta ar:func: ~django.utils.dateparse.parse_datetime. Is iad roinnt samplaí:

\n
    \n

  • `2006-10-25 14:30:59 '

    • \n

  • '2006-10-25H 14:30:59 '

    • \n

  • `'2006-10-25 14:30 '

    • \n

  • `'2006-10-25T 14:30 '

    • \n

  • ``'2006-10-25H 14:30 AR ``

    • \n

  • '2006-10-25H 14:30 + 02:00 '

    • \n

  • `'2006-10-25'

    • \n
\n

Mura gcuirtear argóint input_formats ar fáil, tógtar na formáidí ionchuir réamhshocraithe ón bhformáid áitiúil gníomhach DATETIME_INPUT_FORMATS agus DATE_INPUT_FORMATS eochracha, nó ó:setting: DATE_INPUT_FORMATS má dhíchumasaítear logánú. Féach freis:doc: `formáid logánaithe' </topics/i18n/formatting>.

\n
\n\n
\n
\n

DecimalfieldLink to this heading#

\n
\n
\nclass DecimalField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: NumberInput nuai:attr: Field.Localize is False, eile: class: TextInput.

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: A Python deachimal.

    • \n

  • Bailíonn sé gur deachúil é an luach a thugtar. Úsáid:aicme: ~django.core.validators.maxvalueValidator agus:class: ~django.core.validators.minvalueValidator má chuirtear max_value agus min_value ar fáil. Úsáid:aicme: ~django.core.validators.stepvalueValidator má chuirtear step_size ar fáil. Déantar neamhaird de spás bán ceannródaíoch agus leantach.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí`, luach_maxe`, luach_mine`, uas_digits`, max_decimal_places`, max_whole_digits`, step_size`.

    • \n
\n

D'fhéadfadh go mbeadh % (limit_value) s sna teachtaireachtaí earráide max_value agus min_value, a chuirfear an teorainn iomchuí in ionad. Ar an gcaoi chéanna, d'fhéadfadh go mbeadh % (max) s` sna teachtaireachtaí earráide max_digits, max_decimal_places` agus max_whole_digits.

\n

Tógann sé cúig argóint roghnach:

\n
\n
\nmax_valueLink to this definition#
\n
\n\n
\n
\nmin_valueLink to this definition#
\n

Rialaíonn siad seo an raon luachanna a cheadaítear sa réimse, agus ba cheart iad a thabhairt mar luachanna ``Decimal.Decimal`.

\n
\n\n
\n
\nmax_digitsLink to this definition#
\n

An líon uasta na ndigití (iad siúd roimh an bpointe deachúil móide iad siúd tar éis an phointe deachúil, le nialais tosaigh a scriosadh) a cheadaítear sa luach.

\n
\n\n
\n
\ndecimal_placesLink to this definition#
\n

An líon uasta na n-áiteanna deachúil a cheadaítear.

\n
\n\n
\n
\nstep_sizeLink to this definition#
\n

Cuir ionchuir bailí a theorannú go iolrach dhílis de step_size. Má chuirtear min_value ar fáil freisin, cuirtear é leis mar fhritháireamh chun a fháil amach an bhfuil méid an chéim ag teacht leis.

\n
\n\n
\n\n
\n
\n

Réimse tréimhseachLink to this heading#

\n
\n
\nclass DurationField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: textInput

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Déanann sé normalú go: A Python: Class: ~python: datetime.timedelta.

    • \n

  • Bailíonn sé gur sreang é an luach a thugtar ar féidir é a thiontú ina ``timedel`. Ní mór an luach a bheith idir: attr: datetime.timedelta.min agus:attr: datetime.timedelta.max.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `, overflow`.

    • \n
\n

Glacann sé le haon fhormáid a thuige:func: ~django.utils.dateparse.parse_duration.

\n
\n\n
\n
\n

Réimse ríomhphostLink to this heading#

\n
\n
\nclass EmailField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: emailInput

    • \n

  • Luach folamh: Cibé rud a thug tú mar empty_value`.

    • \n

  • Normalaítear go dtí: Sreang.

    • \n

  • Úsáid:Class: ~django.core.validators.emailValidator chun a bhailíochtú gur seoladh ríomhphoist bailí é an luach a thugtar, ag baint úsáide as léiriú rialta measartha casta.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Tá na hargóintí roghnacha max_length ``, `min_length, agus empty_value a oibríonn díreach mar a dhéanann siad le haghaidh: class: charfield. Tá an argóint ``max_length ``réamhshocraithe go 320 (féach: rfc: 3696 #section -3).

\n
\n\n
\n
\n

FileFieldLink to this heading#

\n
\n
\nclass FileField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: ClearableFileInput

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaíonn sé go: Rud UploadedFile` a fhilleann ábhar an chomhaid agus ainm an chomhaid i réad amháin.

    • \n

  • Is féidir a bhailíochtú go bhfuil sonraí comhad neamh-folamh ceangailte leis an bhfoirm.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí`, easna, folamh `, max_length`

    • \n
\n

Tá na hargóintí roghnacha ann maidir le bailíochtú: max_length ``agus ``allow_empty_file. Má chuirtear ar fáil, cinntíonn siad seo go bhfuil ainm an chomhaid ar a mhéad an fad tugtha, agus go n-éireoidh leis an mbailíochtú fiú má tá ábhar an chomhaid folamh.

\n

Chun tuilleadh eolais a fhoghlaim faoin réad uploadedfile, féach na:doc: doiciméadú uaslódála comhad. </topics/http/file-uploads>

\n

<binding-uploaded-files>Nuair a úsáideann tú FileField i bhfoirm, ní mór duit cuimhneamh freisin to:ref: `sonraí an chomhaid a cheangal leis an bhfoirm `.

\n

Tagraíonn an earráid max_length ``d'fhad an ainm comhaid. Sa teachtaireacht earráide don eochair sin, cuirfear an fad uasta ainm comhaid in ionad `% (max) d agus cuirfear an fad ainm comhaid reatha in ionad % (length) d`.

\n
\n\n
\n
\n

FilePathfieldLink to this heading#

\n
\n
\nclass FilePathField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: `Roghnaigh `

    • \n

  • Luach folamh: ``"``(teaghrán folamh)

    • \n

  • Normalaítear go dtí: Sreang.

    • \n

  • Bailíonn sé go bhfuil an rogha roghnaithe ar liosta na roghanna.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, invalid_choice`

    • \n
\n

Ligeann an réimse roghnú ó chomhaid taobh istigh de eolaire áirithe Tógann sé cúig argóint breise; ní theastaíonn ach path:

\n
\n
\npathLink to this definition#
\n

An cosán iomlán chuig an eolaire a bhfuil a n-ábhar is mian leat liostaithe. Caithfidh an t-eolaire seo a bheith ann.

\n
\n\n
\n
\nrecursiveLink to this definition#
\n

Má tá False (an réamhshocraithe) ní thairgfear ach ábhar díreach path mar roghanna. Má tá “Fíor”, cuirfear an t-eolaire isteach go athshlánach agus liostófar gach sliocht mar roghanna.

\n
\n\n
\n
\nmatchLink to this definition#
\n

Patrún abairt rialta; ní cheadófar ach comhaid le hainmneacha a mheaitseálann leis an abairt seo mar roghanna.

\n
\n\n
\n
\nallow_filesLink to this definition#
\n

Optional. Either True or False. Default is True. Specifies\nwhether files in the specified location should be included. Either this\nor allow_folders must be True.

\n
\n\n
\n
\nallow_foldersLink to this definition#
\n

Optional. Either True or False. Default is False. Specifies\nwhether folders in the specified location should be included. Either\nthis or allow_files must be True.

\n
\n\n

FilePathField has the following method:

\n
\n
\nset_choices()Link to this definition#
\n
\n

Scans the directory at path and refreshes the field's\nchoices. This is called automatically during __init__(), but it can\nalso be called explicitly to pick up files added to the directory\nafter the field was first instantiated (usually at server startup). For\nexample, call it in a form's __init__() to get fresh choices per\nrequest:

\n
Code
class MyForm(forms.Form):\n    my_file = forms.FilePathField(path="/path/to/dir")\n\n    def __init__(self, *args, **kwargs):\n        super().__init__(*args, **kwargs)\n        self.fields["my_file"].set_choices()\n
\n
\n\n
\n\n
\n
\n

``Floatfield ``Link to this heading#

\n
\n
\nclass FloatField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: NumberInput nuai:attr: Field.Localize is False, eile: class: TextInput.

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Snámhphointe Python.

    • \n

  • Bailíonn sé gur snámhphointe an luach a thugtar. Úsáid:aicme: ~django.core.validators.maxvalueValidator agus:class: ~django.core.validators.minvalueValidator má chuirtear max_value agus min_value ar fáil. Úsáid:aicme: ~django.core.validators.stepvalueValidator má chuirtear step_size ar fáil. Ceadaítear spás bán tosaigh agus rianaithe, mar atá i bhfeidhm ``float () ``Python.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí, luach_maxe`, luach_min`, step_size`.

    • \n
\n

Tógann sé trí argóint roghnacha:

\n
\n
\nmax_valueLink to this definition#
\n
\n\n
\n
\nmin_valueLink to this definition#
\n

Rialaíonn siad seo an raon luachanna a cheadaítear sa réimse.

\n
\n\n
\n
\nstep_sizeLink to this definition#
\n

Cuir ionchuir bailí a theorannú go iolrach dhílis de step_size. Má chuirtear min_value ar fáil freisin, cuirtear é leis mar fhritháireamh chun a fháil amach an bhfuil méid an chéim ag teacht leis.

\n
\n\n
\n\n
\n
\n

GenericipAddressFieldLink to this heading#

\n
\n
\nclass GenericIPAddressField(**kwargs)Link to this definition#
\n

Réimse ina bhfuil IPv4 nó seoladh IPv6.

\n
    \n

  • Giuirléid réamhshocraithe: :class: textInput

    • \n

  • Luach folamh: ``"``(teaghrán folamh)

    • \n

  • Normalaítear go dtí: Sreang. Déantar seoltaí IPv6 a normalú mar a thuairiscítear thíos.

    • \n

  • Bailíonn sé gur seoladh IP bailí é an luach a thugtar.

    • \n

  • Error message keys: required, invalid, max_length

    • \n
\n

Leanann normalú an seoladh IPv6: rfc: 4291 #section -2.2 alt 2.2, lena n-áirítear úsáid a bhaint as an bhformáid IPv4 a mholtar i mír 3 den chuid sin, cosúil le : :ffff:192.0.2.0. Mar shampla, bheadh 2001:0:: 0:01 normalaithe go 2001: :1, agus : :ffff:0a0a0a go``: :ffff:10.10.10``. Déantar gach carachtar a thiontú go litreacha beaga.

\n

Tógann sé trí argóint roghnacha:

\n
\n
\nprotocolLink to this definition#
\n

Teoraíonn sé ionchuir bailí don phrótacal sonraithe. Is iad na luachanna a nglactar leo ná an bheirt ``(réamhshocraithe), ``IPv4 nó IPv6. Tá an meaitseáil neamh-íogair.

\n
\n\n
\n
\nunpack_ipv4Link to this definition#
\n

Díphacáil seoltaí mapáilte IPv4 mar :: ffff: 192.0.2.1. Má tá an rogha seo cumasaithe déanfaí an seoladh sin a dhíphacáil go 192.0.2.1 ``. Tá réamhshocrú díchumasaithe. Ní féidir é a úsáid ach amháin nuair a shocraítear ``prótacol go ``beach'.

\n
\n\n
\n
\nmax_lengthLink to this definition#
\n

Defaults to 39, and behaves the same way as it does for\nCharField.

\n
\n\n
\n\n
\n
\n

ImageFieldLink to this heading#

\n
\n
\nclass ImageField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: ClearableFileInput

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaíonn sé go: Rud UploadedFile` a fhilleann ábhar an chomhaid agus ainm an chomhaid i réad amháin.

    • \n

  • Bailíonn sé go bhfuil sonraí comhaid ceangailte leis an bhfoirm. Úsáideann sé freisin: class: ~django.core.validators.fileExtensionValidator chun a bhailíochtú go dtacaíonn Pillow leis an síneadh comhaid.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí`, easna, folam`, invalid_image

    • \n
\n

Ag baint úsáide as ImageField is gá go bhfuil: pypi: pillow suiteáilte le tacaíocht do na formáidí íomhá a úsáideann tú. Má bhíonn earráid “íomhá truaillithe” ort nuair a uaslódálann tú íomhá, ciallaíonn sé de ghnáth nach dtuigeann Pillow a fhormáid. Chun é seo a shocrú, suiteáil an leabharlann cuí agus athshuiteáil Pillow.

\n

<binding-uploaded-files>Nuair a úsáideann tú ImageField ar fhoirm, ní mór duit cuimhneamh freisin to:ref: `sonraí an chomhaid a cheangal leis an bhfoirm `.

\n

Tar éis an réimse a ghlanadh agus a bhailíochtú, beidh tréith “íomhá” breise ag an réad uploadedfile ina bhfuil an sampla Pillow Image a úsáidtear chun seiceáil an raibh an comhad ina íomhá bailí. Dúnann Pillow an tuairisceoir comhaid bunúsach tar éis íomhá a fhíorú, mar sin cé go bhfuil tréithe sonraí neamh-íomhá, mar shampla ``formáid`, airde `, agus leithead, ar fáil, ní féidir modhanna a bhaineann rochtain ar shonraí íomhá bunúsacha, mar shampla ``getdata () nó `getpixel (), a úsáid gan an comhad a athoscailt. Mar shampla:

\n
Python console
>>> from PIL import Image\n>>> from django import forms\n>>> from django.core.files.uploadedfile import SimpleUploadedFile\n>>> class ImageForm(forms.Form):\n...     img = forms.ImageField()\n...\n>>> file_data = {"img": SimpleUploadedFile("test.png", b"file data")}\n>>> form = ImageForm({}, file_data)\n# Pillow closes the underlying file descriptor.\n>>> form.is_valid()\nTrue\n>>> image_field = form.cleaned_data["img"]\n>>> image_field.image\n<PIL.PngImagePlugin.PngImageFile image mode=RGBA size=191x287 at 0x7F5985045C18>\n>>> image_field.image.width\n191\n>>> image_field.image.height\n287\n>>> image_field.image.format\n'PNG'\n>>> image_field.image.getdata()\n# Raises AttributeError: 'NoneType' object has no attribute 'seek'.\n>>> image = Image.open(image_field)\n>>> image.getdata()\n<ImagingCore object at 0x7f5984f874b0>\n
\n

Ina theannta sin, déanfar uploadedfile.content_type a nuashonrú le cineál ábhair na híomhá más féidir le Pillow é a chinneadh, ar shlí eile socraítear é go ``None ``.

\n
\n\n
\n
\n

Réimse iomlánaLink to this heading#

\n
\n
\nclass IntegerField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: NumberInput nuai:attr: Field.Localize is False, eile: class: TextInput.

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Sláimhir Python.

    • \n

  • Bailíonn sé gur sláimhir é an luach a thugtar. Úsáid:aicme: ~django.core.validators.maxvalueValidator agus:class: ~django.core.validators.minvalueValidator má chuirtear max_value agus min_value ar fáil. Úsáid:aicme: ~django.core.validators.stepvalueValidator má chuirtear step_size ar fáil. Ceadaítear spás bán tosaigh agus rianaithe, mar atá i bhfeidhm ``int () ``Python.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí ``, `luach_maxe, luach_min`, méide_step`

    • \n
\n

D'fhéadfadh go mbeadh % (limit_value) s sna teachtaireachtaí earráide max_value, min_value` agus step_size, % (limit_value) s`, a chuirfear an teorainn iomchuí in ionad.

\n

Glacann sé trí argóint roghnach le haghaidh bailíochtú:

\n
\n
\nmax_valueLink to this definition#
\n
\n\n
\n
\nmin_valueLink to this definition#
\n

Rialaíonn siad seo an raon luachanna a cheadaítear sa réimse.

\n
\n\n
\n
\nstep_sizeLink to this definition#
\n

Cuir ionchuir bailí a theorannú go iolrach dhílis de step_size. Má chuirtear min_value ar fáil freisin, cuirtear é leis mar fhritháireamh chun a fháil amach an bhfuil méid an chéim ag teacht leis.

\n
\n\n
\n\n
\n
\n

JsonfieldLink to this heading#

\n
\n
\nclass JSONField(encoder=None, decoder=None, **kwargs)Link to this definition#
\n

Réimse a ghlacann le sonraí ionchódaithe JSON do a:class: ~django.db.models.jsonField.

\n
    \n

  • Giuirléid réamhshocraithe: :class: Textarea

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Léiriú Python ar an luach JSON (de ghnáth mar dict, liost`, nó None), ag brath ar:attr: JSONfield.decoder.

    • \n

  • Bailíonn sé gur JSON bailí é an luach a thugtar.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Glacann sé dhá argóint roghnach:

\n
\n
\nencoderLink to this definition#
\n

A json.JSONEncoder subclass to serialize data types not\nsupported by the standard JSON serializer (e.g. datetime.datetime\nor UUID). For example, you can use the\nDjangoJSONEncoder class.

\n

Réamhshocraithe go JSON.JSONEncoder.

\n
\n\n
\n
\ndecoderLink to this definition#
\n

A json.JSONDecoder subclass to deserialize the input. Your\ndeserialization may need to account for the fact that you can't be\ncertain of the input type. For example, you run the risk of returning a\ndatetime that was actually a string that just happened to be in the\nsame format chosen for datetimes.

\n

The decoder can be used to validate the input. If\njson.JSONDecodeError is raised during the deserialization,\na ValidationError will be raised.

\n

Réamhshocraithe go JSON.JSONDecoder.

\n
\n\n\n\n
\n\n
\n
\n

MultiplechoiceFieldLink to this heading#

\n
\n
\nclass MultipleChoiceField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: SelectMultiple

    • \n

  • Luach folamh: [] (liosta folamh)

    • \n

  • Normalaítear go: Liosta de na teaghráin.

    • \n

  • Bailíonn sé go bhfuil gach luach sa liosta luachanna ar leith i liosta na roghanna.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, invalid_choice`, invalid_list`

    • \n
\n

D'fhéadfadh go mbeadh % (value) s sa teachtaireacht earráide invalid_choice, agus cuirfear an rogha roghnaithe in ionad.

\n

Glacann sé argóint breise riachtanach amháin, roghna, mar atá le haghaidh: class: roghnaíon.

\n
\n\n
\n
\n

NullbooleanfieldLink to this heading#

\n
\n
\nclass NullBooleanField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: NullBooleanSelect

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Luach Python True, False` nó None.

    • \n

  • Ní bhailíonn sé rud ar bith (ie, ní ardaíonn sé ValidationError riamh).

    • \n
\n

Is féidir NullBooleanField a úsáid le giuirléidí amsúil:class: ~django.forms.select nó:class: ~django.forms.radioSelect tríd an giuirléid roghnaithe a sholáthar:

\n
Code
NullBooleanField(\n    widget=Select(\n        choices=[\n            ("", "Unknown"),\n            (True, "Yes"),\n            (False, "No"),\n        ]\n    )\n)\n
\n
\n\n
\n
\n

RegexfieldLink to this heading#

\n
\n
\nclass RegexField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: textInput

    • \n

  • Luach folamh: Cibé rud a thug tú mar empty_value`.

    • \n

  • Normalaítear go dtí: Sreang.

    • \n

  • Úsáid:Class: ~django.core.validators.regexValidator chun a bhailíochtú go bhfuil an luach tugtha comhoiriúnach le léiriú rialta áirithe.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Tógann sé argóint riachtanach amháin:

\n
\n
\nregexLink to this definition#
\n

Léiriú rialta a shonraítear mar shreang nó mar réad abairt rialta tiomsaithe.

\n
\n\n

Glacann sé freisin max_length ``, `min_length, strip`, agus empty_value a oibríonn díreach mar a dhéanann siad do:class: charfield.

\n
\n
\nstripLink to this definition#
\n

Réamhshocraithe go False. Má tá sé cumasaithe, cuirfear stialladh i bhfeidhm roimh an bhailíochtú regex.

\n
\n\n
\n\n
\n
\n

SlugfieldLink to this heading#

\n
\n
\nclass SlugField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: textInput

    • \n

  • Luach folamh: Cibé rud a thug tú mar: attr: empty_value.

    • \n

  • Normalaítear go dtí: Sreang.

    • \n

  • Úsáid:aicme: ~django.core.validators.validate_slug nó:class: ~django.core.validators.validate_unicode_slug chun a bhailíochtú nach bhfuil ach litreacha, uimhreacha, béim agus braithíní sa luach tugtha.

    • \n

  • Teachtaireachtaí earráide: riachtan, neamhbhailí`

    • \n
\n

Tá an réimse seo beartaithe le húsáid chun samhail:class: ~django.db.models.slugfield a léiriú i bhfoirmeacha.

\n

Glacann sé dhá pharaiméadar roghnach

\n
\n
\nallow_unicodeLink to this definition#
\n

Boolean a thugann treoir don réimse glacadh le litreacha Unicode i dteannta le litreacha ASCII. Réamhshocraithe go False.

\n
\n\n
\n
\nempty_valueLink to this definition#
\n

An luach le húsáid chun “folamh” a léiriú. Réamhshocraithe chuig teaghrán folamh.

\n
\n\n
\n\n
\n
\n

``Réimse ama ``Link to this heading#

\n
\n
\nclass TimeField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: TimeInput

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Rud Python datetime.time.

    • \n

  • Bailíonn sé gur datetime.time` nó teaghrán formáidithe i bhformáid ama áirithe an luach a thugtar.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Tógann sé argóint roghnach amháin:

\n
\n
\ninput_formatsLink to this definition#
\n

Athraitheach formáidí a úsáidtear chun iarracht a dhéanamh teaghrán a thiontú go réad bailí datetime.time.

\n
\n\n

Mura gcuirtear argóint input_formats ar fáil, tógtar na formáidí ionchuir réamhshocraithe ón bhformáid áitiúil gníomhach TIME_INPUT_FORMATS eochair, nó ó:setting: TIME_INPUT_FORMATS má tá logánú díchumasaithe. Féach freis:doc: `formáid logánaithe' </topics/i18n/formatting>.

\n
\n\n
\n
\n

TypedChoiceFieldLink to this heading#

\n
\n
\nclass TypedChoiceField(**kwargs)Link to this definition#
\n

Díreach cosúil le a:class: choicefield, except:class: TypedChoiceField glacann dhá argóint breise, :attr: coerce agus:attr: empty_value.

\n
    \n

  • Giuirléid réamhshocraithe: :class: `Roghnaigh `

    • \n

  • Luach folamh: Cibé rud a thug tú mar: attr: empty_value.

    • \n

  • Déanann sé normalú go: Luach den chineál a sholáthraíonn an argóint:attr: coerce.

    • \n

  • Bailíonn sé go bhfuil an luach a thugtar ar liosta na roghanna agus gur féidir é a chur iallach.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, invalid_choice`

    • \n
\n

Tógann sé argóintí breise:

\n
\n
\ncoerceLink to this definition#
\n

Feidhm a thógann argóint amháin agus a thugann luach éigeantach ar ais. I measc na samplaí tá na int, float`, bool` agus cineálacha eile ionsuite. Réamhshocraithe ar fheidhm aitheantais. Tabhair faoi deara go dtarlaíonn comhéigean tar éis bailíochtú ionchuir, mar sin is féidir luach nach bhfuil i láthair i “roghanna” a chur i bhfeidhm.

\n
\n\n
\n
\nempty_valueLink to this definition#
\n

An luach le húsáid chun “folamh” a léiriú. Réamhshocraithe don teaghrán folamh; Is rogha coitianta eile é None ``anseo. Tabhair faoi deara nach gcuirfear an luach seo a iallach leis an bhfeidhm a thugtar san argóint ``force, mar sin roghnaigh é dá réir.

\n
\n\n
\n\n
\n
\n

TypedMultiplechoiceFieldLink to this heading#

\n
\n
\nclass TypedMultipleChoiceField(**kwargs)Link to this definition#
\n

Díreach cosúil le a:class: MultipleChoiceField, seachas: class: TypedMultipleChoiceField thógann dhá argóint breise, coerce agus empty_value.

\n
    \n

  • Giuirléid réamhshocraithe: :class: SelectMultiple

    • \n

  • Luach folamh: Cibé rud a thug tú mar empty_value

    • \n

  • Normalaítear go dtí: Liosta luachanna den chineál a sholáthraíonn an argóint ``forbairt ``.

    • \n

  • Bailíonn sé go bhfuil na luachanna a thugtar ar liosta na roghanna agus gur féidir iad a chur iallach.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, invalid_choice`

    • \n
\n

D'fhéadfadh go mbeadh % (value) s sa teachtaireacht earráide invalid_choice, agus cuirfear an rogha roghnaithe in ionad.

\n

Glacann sé dhá argóint bhreise, coerce agus empty_value`, mar atá le haghaidh: class: TypedChoiceField.

\n
\n\n
\n
\n

UrlfieldLink to this heading#

\n
\n
\nclass URLField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: Urlinput

    • \n

  • Luach folamh: Cibé rud a thug tú mar empty_value`.

    • \n

  • Normalaítear go dtí: Sreang.

    • \n

  • Úsáid:Class: ~django.core.validators.urlValidator chun a bhailíochtú gur URL bailí é an luach a thugtar.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Tá na hargóintí roghnacha max_length ``, `min_length, empty_value` a oibríonn díreach mar a dhéanann siad do:class: charfield, agus argóint amháin eile:

\n
\n
\nassume_schemeLink to this definition#
\n

The scheme assumed for URLs provided without one. Defaults to\n"https". For example, if assume_scheme is "https" and the\nprovided value is "example.com", the normalized value will be\n"https://example.com".

\n
\n\n
\n\n
\n
\n

UuidfieldLink to this heading#

\n
\n
\nclass UUIDField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: textInput

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Déanann sé normalú go réad: A: Class: ~Python: UUID.uuid.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Glacfaidh an réimse seo le haon fhormáid teaghrán a nglactar leis mar argóint hex don tógálaí: class: ~python:uuid.uuid.

\n
\n\n
\n
\n
\n

Ranganna Páirce tógtha beagán castaLink to this heading#

\n
\n

CombofieldLink to this heading#

\n
\n
\nclass ComboField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: textInput

    • \n

  • Luach folamh: ``"``(teaghrán folamh)

    • \n

  • Normalaítear go dtí: Sreang.

    • \n

  • Bailíonn sé an luach a thugtar i gcoinne gach ceann de na réimsí a shonraítear mar argóint don Combofield.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `

    • \n
\n

Tógann sé argóint riachtanach breise amháin:

\n
\n
\nfieldsLink to this definition#
\n

Liosta na réimsí ba chóir a úsáid chun luach an réimse a bhailíochtú (san ord ina gcuirtear ar fáil iad).

\n
Python console
>>> from django.forms import ComboField\n>>> f = ComboField(fields=[CharField(max_length=20), EmailField()])\n>>> f.clean("test@example.com")\n'test@example.com'\n>>> f.clean("longemailaddress@example.com")\nTraceback (most recent call last):\n...\nValidationError: ['Ensure this value has at most 20 characters (it has 28).']\n
\n
\n\n
\n\n
\n
\n

Réimse IlluachaLink to this heading#

\n
\n
\nclass MultiValueField(fields=(), **kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: textInput

    • \n

  • Luach folamh: ``"``(teaghrán folamh)

    • \n

  • Normalaítear go dtí: an cineál a chuirtear ar ais trí mhodh ``comhbhrúiteach` sa fho-aicme.

    • \n

  • Bailíonn sé an luach a thugtar i gcoinne gach ceann de na réimsí a shonraítear mar argóint don ``MultivalueField`.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí `, neamhiomlán`

    • \n
\n

Comhiomlánann sé loighic réimsí iolracha a tháirgeann luach amháin le chéile.

\n

Tá an réimse seo teibí agus ní mór é a fho-aicmiú. I gcodarsnacht leis na réimsí aonluacha, ní mór fo-aicmí de:class: MultivalueField a chur i bhfeidhme:meth: ~django.forms.field.clean ach ina ionad sin - cur i bhfeidhm: meth: ~MultivalueField.compress.

\n

Tógann sé argóint riachtanach breise amháin:

\n
\n
\nfieldsLink to this definition#
\n

A tuple of fields whose values are cleaned and subsequently combined\ninto a single value. Each value of the field is cleaned by the\ncorresponding field in fields -- the first value is cleaned by the\nfirst field, the second value is cleaned by the second field, etc.\nOnce all fields are cleaned, the list of clean values is combined into\na single value by compress().

\n
\n\n

Glacann sé roinnt argóintí roghnach freisin:

\n
\n
\nrequire_all_fieldsLink to this definition#
\n

Réamhshocraithe go True, agus sa chás sin ardófar earráid bailíochtaithe riachtanaithe mura soláthraítear aon luach d'aon réimse.

\n

Nuair a shocraítear é go False`, is féidir an tréith: attr: Field.required a shocrú go False le haghaidh réimsí aonair chun iad a dhéanamh roghnach. Mura gcuirtear aon luach ar fáil do réimse riachtanach, ardófar earráid bailíochtaithe neamhiomlán.

\n

Is féidir teachtaireacht earráide réamhshocraithe neamhchomhlán a shainiú ar an bhfo-aicme:class: MultivalueField, nó is féidir teachtaireachtaí éagsúla a shainiú ar gach réimse aonair. Mar shampla:

\n
Code
from django.core.validators import RegexValidator\n\n\nclass PhoneField(MultiValueField):\n    def __init__(self, **kwargs):\n        # Define one message for all fields.\n        error_messages = {\n            "incomplete": "Enter a country calling code and a phone number.",\n        }\n        # Or define a different message for each field.\n        fields = (\n            CharField(\n                error_messages={"incomplete": "Enter a country calling code."},\n                validators=[\n                    RegexValidator(r"^[0-9]+$", "Enter a valid country calling code."),\n                ],\n            ),\n            CharField(\n                error_messages={"incomplete": "Enter a phone number."},\n                validators=[RegexValidator(r"^[0-9]+$", "Enter a valid phone number.")],\n            ),\n            CharField(\n                validators=[RegexValidator(r"^[0-9]+$", "Enter a valid extension.")],\n                required=False,\n            ),\n        )\n        super().__init__(\n            error_messages=error_messages,\n            fields=fields,\n            require_all_fields=False,\n            **kwargs\n        )\n
\n
\n\n
\n
\nwidgetLink to this definition#
\n

Caithfidh sé a bheith ina fho-aicme de:class: Django.Forms.MultiWidget. Is é an luach réamhshocraithe:class: ~django.forms.textInput, rud nach bhfuil an-úsáideach sa chás seo is dócha.

\n
\n\n
\n
\ncompress(data_list)Link to this definition#
\n

Tógann sé liosta de luachanna bailí agus cuireann sé leagan “comhbhrúite” de na luachanna sin ar ais - i luach amháin. Mar shampla, :class: Is fo-aicme é splitDateTimeField a chomhcheanglaíonn réimse ama agus réimse dáta i réad datetime.

\n

Caithfear an modh seo a chur i bhfeidhm sna fo-aicmí.

\n
\n\n
\n\n
\n
\n

SplitDateTimeFieldLink to this heading#

\n
\n
\nclass SplitDateTimeField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: SplitDateTimeWidget

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Rud Python datetime.datetime.

    • \n

  • Bailíonn sé gur datetime.datetime` nó sreang formáidithe i bhformáid dáta-ama áirithe an luach a thugtar.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, neamhbhailí`, dáta_invalid`, invalid_time`

    • \n
\n

Glacann sé dhá argóint roghnach:

\n
\n
\ninput_date_formatsLink to this definition#
\n

Liosta de na formáidí a úsáidtear chun iarracht a dhéanamh teaghrán a thiontú go réad bailí datetime.date.

\n
\n\n

Mura gcuirtear argóint input_date_formats ar fáil, úsáidtear na formáidí ionchuir réamhshocraithe le haghaidh: class: DateField.

\n
\n
\ninput_time_formatsLink to this definition#
\n

Liosta de na formáidí a úsáidtear chun iarracht a dhéanamh teaghrán a thiontú go réad bailí datetime.time.

\n
\n\n

Mura gcuirtear argóint input_time_formats ar fáil, úsáidtear na formáidí ionchuir réamhshocraithe le haghaidh: class: Timefield.

\n
\n\n
\n
\n
\n

Réimsí a bhaineann le caidrimhLink to this heading#

\n

Two fields are available for representing relationships between\nmodels: ModelChoiceField and\nModelMultipleChoiceField. Both of these fields require a\nsingle queryset parameter that is used to create the choices for\nthe field. Upon form validation, these fields will place either one\nmodel object (in the case of ModelChoiceField) or multiple model\nobjects (in the case of ModelMultipleChoiceField) into the\ncleaned_data dictionary of the form.

\n

Le haghaidh úsáidí níos casta, is féidir leat querySet = None a shonrú agus an réimse foirme á dhearbhú agus ansin an queryset a líonadh i modh ``__init__ () ``sa fhoirm:

\n
Code
class FooMultipleChoiceForm(forms.Form):\n    foo_select = forms.ModelMultipleChoiceField(queryset=None)\n\n    def __init__(self, *args, **kwargs):\n        super().__init__(*args, **kwargs)\n        self.fields["foo_select"].queryset = ...\n
\n

Tá tréith literator ag ModelChoiceField` agus ModelMultipleChoiceField araon a shonraíonn an rang a úsáidtear chun athrú thar an tacar fiosrúcháin agus roghanna á ghiniúint. Féach:ref: `roghanna litearálach-caidrim' le haghaidh sonraí.

\n
\n

ModelChoiceFieldLink to this heading#

\n
\n
\nclass ModelChoiceField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: `Roghnaigh `

    • \n

  • Luach folamh: ``Níl ``

    • \n

  • Normalaítear go dtí: Sampla samhail.

    • \n

  • Bailíonn sé go bhfuil an id a thugtar sa tacar ceisteanna.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, invalid_choice`

    • \n
\n

D'fhéadfadh go mbeadh % (value) s sa teachtaireacht earráide invalid_choice, agus cuirfear an rogha roghnaithe in ionad.

\n

Ligeann sé réad samhail amháin a roghnú, atá oiriúnach chun eochair eachtrach a léiriú. Tabhair faoi deara go mbíonn an giuirléid réamhshocraithe do `ModelChoiceField ``neamhphraiticiúil nuair a mhéadaíonn líon na n-iontrálacha. Ba chóir duit é a úsáid le haghaidh níos mó ná 100 mír a sheachaint.

\n

Teastaíonn argóint amháin:

\n
\n
\nquerysetLink to this definition#
\n

“QuerySet” de rudaí samhail as a dhíorthaítear na roghanna don réimse agus a úsáidtear chun rogha an úsáideora a bhailíochtú. Déantar é a mheas nuair a dhéantar an fhoirm a rinneadh.

\n
\n\n

Glacann ModelChoicefield roinnt argóintí roghnacha freisin:

\n
\n
\nempty_labelLink to this definition#
\n

By default the <select> widget used by ModelChoiceField will\nhave an empty choice at the top of the list. You can change the text of\nthis label (which is "- Select an option -" by default) with the\nempty_label attribute, or you can disable the empty label entirely\nby setting empty_label to None:

\n
Code
# A custom empty label\nfield1 = forms.ModelChoiceField(queryset=..., empty_label="(Nothing)")\n\n# No empty label\nfield2 = forms.ModelChoiceField(queryset=..., empty_label=None)\n
\n

Tabhair faoi deara nach gcruthaítear aon rogha folamh (beag beann ar luach empty_label) má theastaíonn ModelChoiceField agus má tá luach tosaigh réamhshocraithe aige, nó go socraítear argóint widget go:class: ~django.forms.RadioSelect agus is é: attr: ~ModeliceChofield.blank `False.

\n
\n\n\n
\n
\nto_field_nameLink to this definition#
\n

Úsáidtear an argóint roghnach seo chun an réimse atá le húsáid mar luach na roghanna i ngiuirléid an réimse a shonrú. Bí cinnte gur réimse uathúil é don tsamhail, ar shlí eile d'fhéadfadh an luach roghnaithe níos mó ná réad amháin a mheaitseáil. De réir réamhshocraithe tá sé socraithe go None, sa chás sin úsáidfear príomh-eochair gach réad. Mar shampla:

\n
Code
# No custom to_field_name\nfield1 = forms.ModelChoiceField(queryset=...)\n
\n

bheadh toradh air:

\n
Html
<select id="id_field1" name="field1">\n<option value="obj1.pk">Object1</option>\n<option value="obj2.pk">Object2</option>\n...\n</select>\n
\n

agus:

\n
Code
# to_field_name provided\nfield2 = forms.ModelChoiceField(queryset=..., to_field_name="name")\n
\n

bheadh toradh air:

\n
Html
<select id="id_field2" name="field2">\n<option value="obj1.name">Object1</option>\n<option value="obj2.name">Object2</option>\n...\n</select>\n
\n
\n\n
\n
\nblankLink to this definition#
\n

Agus an giuirléid: class: ~django.forms.RadioSelect á úsáid agat, cinneann an argóint boolean roghnach seo an gcruthaítear rogha folamh. De réir réamhshocraithe, is é blank False`, agus sa chás sin ní chruthaítear aon rogha folamh.

\n
\n\n

Tá an tréith ag ModelChoiceField freisin:

\n
\n
\niteratorLink to this definition#
\n

An rang iterator a úsáidtear chun roghanna réimse a ghiniúint ó queryset. De réir réamhshocraithe, :class: ModelChoiceIterator.

\n
\n\n

Glaofar ar an modh __str__ () ``den mhúnla chun léiriúcháin teaghrán a ghiniúint ar na rudaí le húsáid i roghanna an réimse. Chun ionadaíochtaí saincheaptha a sholáthar, déan fo-aicme ``ModelChoicefield agus label_from_instance` a shárú. Gheobhaidh an modh seo réad samhail agus ba cheart go gcuirfeadh sreang atá oiriúnach chun é a léiriú ar ais. Mar shampla:

\n
Code
from django.forms import ModelChoiceField\n\n\nclass MyModelChoiceField(ModelChoiceField):\n    def label_from_instance(self, obj):\n        return "My Object #%i" % obj.id\n
\n
\n\n
\n
\n

ModelMultipleChoiceFieldLink to this heading#

\n
\n
\nclass ModelMultipleChoiceField(**kwargs)Link to this definition#
\n
    \n

  • Giuirléid réamhshocraithe: :class: SelectMultiple

    • \n

  • Luach folamh: An folamh QuerySet (``self.queryset.none () ``)

    • \n

  • Normalaítear go dtí: A QuerySet de chásanna samhail.

    • \n

  • Bailíonn sé go bhfuil gach id sa liosta luachanna tugtha sa tacar fiosrúcháin.

    • \n

  • Eochracha teachtaireachta earráide: riachtan, invalid_list, invalid_choice`, invalid_pk_value`

    • \n
\n

D'fhéadfadh go mbeadh % (value) s` sa teachtaireacht invalid_choice agus d'fhéadfadh go mbeadh % (pk) s` sa teachtaireacht invalid_pk_value, agus cuirfear na luachanna cuí in ionad.

\n

Ligeann sé réad samhail amháin nó níos mó a roghnú, atá oiriúnach chun caidreamh go leor le go leor a léiriú. Mar atá le: class: ModelChoiceField, is féidir leat label_from_instance a úsáid chun na léirithe réad a shaincheapadh.

\n

Teastaíonn argóint amháin:

\n
\n
\nquerysetLink to this definition#
\n

Mar an gcéanna len:class: ModelChoiceField.QuerySet.

\n
\n\n

Tógann sé argóint roghnach amháin:

\n
\n
\nto_field_nameLink to this definition#
\n

Mar an gcéanna len:class: ModelChoiceField.to_Field_Nam.

\n
\n\n

Tá an tréith ag ModelMultipleChoiceField freisin:

\n
\n
\niteratorLink to this definition#
\n

Mar an gcéanna len:class: ModelChoiceField.iterator.

\n
\n\n
\n\n
\n
\n

Roghanna caidrimh athraitheachaLink to this heading#

\n

De réir réamhshocraithe, :class: ModelChoiceField agus:class: ModelMultipleChoiceField úsáid:class: ModelChoiceIterator chun a réimse roghnaithe a ghiniúint.

\n

Nuair a dhéantar athrá, tugann ModelChoiceIterator` roghanna 2-thúpla ina bhfuil: class: ModelChoiceIteratorValue cásanna mar an chéad eilimint luach i ngach rogha. <option>Fillteann ModelChoiceIteratorValue an luach rogha agus tagairt á choinneáil don shampla samhail foinse is féidir a úsáid i bhfeidhmiú giuirléid saincheaptha, mar shampla, chun sonraí-* tréithe `_ a chur le ``` eilimintí.

\n

Mar shampla, smaoinigh ar na samhlacha seo a leanas:

\n
Code
from django.db import models\n\n\nclass Topping(models.Model):\n    name = models.CharField(max_length=100)\n    price = models.DecimalField(decimal_places=2, max_digits=6)\n\n    def __str__(self):\n        return self.name\n\n\nclass Pizza(models.Model):\n    topping = models.ForeignKey(Topping, on_delete=models.CASCADE)\n
\n

<option>Is féidir leat fo-aicme giuirléid a:class: ~django.forms.select a úsáid chun luach Topping.price a áireamh mar an tréith HTML sonraí-praghas do gach eilimint ```:

\n
Code
from django import forms\n\n\nclass ToppingSelect(forms.Select):\n    def create_option(\n        self, name, value, label, selected, index, subindex=None, attrs=None\n    ):\n        option = super().create_option(\n            name, value, label, selected, index, subindex, attrs\n        )\n        if value:\n            option["attrs"]["data-price"] = value.instance.price\n        return option\n\n\nclass PizzaForm(forms.ModelForm):\n    class Meta:\n        model = Pizza\n        fields = ["topping"]\n        widgets = {"topping": ToppingSelect}\n
\n

Tabharfaidh sé seo an roghnú Pizza.Topping mar:

\n
Html
<select id="id_topping" name="topping" required>\n<option value="" selected>---------</option>\n<option value="1" data-price="1.50">mushrooms</option>\n<option value="2" data-price="1.25">onions</option>\n<option value="3" data-price="1.75">peppers</option>\n<option value="4" data-price="2.00">pineapple</option>\n</select>\n
\n

Le haghaidh úsáide níos airde, féadfaidh tú fo-aicme ModelChoiceIterator d'fhonn na roghanna 2-tuple a fhaightear a shaincheapadh.

\n
\n

ModelChoiceLiteratorLink to this heading#

\n
\n
\nclass ModelChoiceIterator(field)Link to this definition#
\n

An rang réamhshocraithe a shanntar don tréith iterator de:class: ModelChoiceField agus:class: ModelMultipleChoiceField. Inathraitheach a thugann roghanna 2-tuple ón tacar fiosrúcháin.

\n

Teastaíonn argóint amháin:

\n
\n
\nfieldLink to this definition#
\n

An sampla de ModelChoiceField nó ModelMultipleChoiceField chun roghanna a athrú agus a tháirgeadh.

\n
\n\n

Tá an modh seo a leanas ag ModelChoiceIterator`:

\n
\n
\n__iter__()Link to this definition#
\n

Tugann sé roghanna dhá thiúpla, san fhormáid (luach, lipéad) a úsáideann: attr: ChoiceField.Choices. Is é a: class: ModelChoiceIteratorValue an chéad eilimint luach sampla.

\n
\n\n
\n\n
\n
\n

ModelChoiceLiteratorValueLink to this heading#

\n
\n
\nclass ModelChoiceIteratorValue(value, instance)Link to this definition#
\n

Teastaíonn dhá argóint:

\n
\n
\nvalueLink to this definition#
\n

Luach an rogha. <option>Úsáidtear an luach seo chun tréith luach eilimint HTML ```a léiriú.

\n
\n\n
\n
\ninstanceLink to this definition#
\n

An tsamhail samhail ón tacar ceisteanna. Is féidir rochtain a fháil ar an gcás i bhfeidhmiú saincheaptha ``choicewidget.create_option () ``chun an HTML rindreáilte a choigeartú.

\n
\n\n

Tá an modh seo a leanas ag ModelChoiceIteratorValue`:

\n
\n
\n__str__()Link to this definition#
\n

Tabhair ar ais luach mar shreang le léiriú i HTML.

\n
\n\n
\n\n
\n
\n
\n
\n

Réimsí saincheaptha a chur arLink to this heading#

\n

Mura gcomhlíonann na ranganna “Réimse” ionsuite do riachtanais, is féidir leat ranganna saincheaptha Réimse ``a chruthú. Chun seo a dhéanamh, cruthaigh fo-aicme de ``Django.Forms.Field. Is é an t-aon cheanglais atá aige ná go gcuirfidh sé modh glan () `i bhfeidhm agus go nglacfaidh a modh ``__init__ () ``leis na croí-argóintí a luaitear thuas (``riachtan, lip`, lip, tionsc`, widget`, help_text`).

\n

You can also customize how a field will be accessed by overriding\nbound_field_class or override\nField.get_bound_field() if you need more flexibility when creating\nthe BoundField:

\n
\n
\nField.get_bound_field(form, field_name)Link to this definition#
\n

Takes an instance of Form and the name of the field.\nThe returned BoundField instance will be used when accessing the\nfield in a template.

\n
\n\n

See Saincheapadh Boundfield for examples of overriding a BoundField.

\n
","rootId":"module-django.forms.fields","toc":[{"title":"Argóintí lárnach réimse","anchor":"core-field-arguments","children":[{"title":"`riachtanai","anchor":"required","children":[]},{"title":"lipéad","anchor":"label","children":[]},{"title":"iarmhair_lipéad","anchor":"label-suffix","children":[]},{"title":"tosaithe","anchor":"initial","children":[]},{"title":"giuirléid","anchor":"widget","children":[]},{"title":"téacs_cabhrach","anchor":"help-text","children":[]},{"title":"teachtaireachtaí earráid","anchor":"error-messages","children":[]},{"title":"``bailíochtóirí ``","anchor":"validators","children":[]},{"title":"logánaithe","anchor":"localize","children":[]},{"title":"díchumasa","anchor":"disabled","children":[]},{"title":"ainmne_teimpléad","anchor":"template-name","children":[]},{"title":"bound_field_class","anchor":"bound-field-class","children":[]}]},{"title":"Seiceáil an bhfuil athrú tagtha ar na sonraí réimse","anchor":"checking-if-the-field-data-has-changed","children":[{"title":"``aigh_athraigh () ``","anchor":"has-changed","children":[]}]},{"title":"Ranganna ``Réimse ``tógtha","anchor":"built-in-field-classes","children":[{"title":"Booleanfield","anchor":"booleanfield","children":[]},{"title":"Charfield","anchor":"charfield","children":[]},{"title":"Réimse roghnaí","anchor":"choicefield","children":[]},{"title":"Dáta réimse","anchor":"datefield","children":[]},{"title":"DataTimeField","anchor":"datetimefield","children":[]},{"title":"Decimalfield","anchor":"decimalfield","children":[]},{"title":"Réimse tréimhseach","anchor":"durationfield","children":[]},{"title":"Réimse ríomhphost","anchor":"emailfield","children":[]},{"title":"FileField","anchor":"filefield","children":[]},{"title":"FilePathfield","anchor":"filepathfield","children":[]},{"title":"``Floatfield ``","anchor":"floatfield","children":[]},{"title":"GenericipAddressField","anchor":"genericipaddressfield","children":[]},{"title":"ImageField","anchor":"imagefield","children":[]},{"title":"Réimse iomlána","anchor":"integerfield","children":[]},{"title":"Jsonfield","anchor":"jsonfield","children":[]},{"title":"MultiplechoiceField","anchor":"multiplechoicefield","children":[]},{"title":"Nullbooleanfield","anchor":"nullbooleanfield","children":[]},{"title":"Regexfield","anchor":"regexfield","children":[]},{"title":"Slugfield","anchor":"slugfield","children":[]},{"title":"``Réimse ama ``","anchor":"timefield","children":[]},{"title":"TypedChoiceField","anchor":"typedchoicefield","children":[]},{"title":"TypedMultiplechoiceField","anchor":"typedmultiplechoicefield","children":[]},{"title":"Urlfield","anchor":"urlfield","children":[]},{"title":"Uuidfield","anchor":"uuidfield","children":[]}]},{"title":"Ranganna Páirce tógtha beagán casta","anchor":"slightly-complex-built-in-field-classes","children":[{"title":"Combofield","anchor":"combofield","children":[]},{"title":"Réimse Illuacha","anchor":"multivaluefield","children":[]},{"title":"SplitDateTimeField","anchor":"splitdatetimefield","children":[]}]},{"title":"Réimsí a bhaineann le caidrimh","anchor":"fields-which-handle-relationships","children":[{"title":"ModelChoiceField","anchor":"modelchoicefield","children":[]},{"title":"ModelMultipleChoiceField","anchor":"modelmultiplechoicefield","children":[]},{"title":"Roghanna caidrimh athraitheacha","anchor":"iterating-relationship-choices","children":[{"title":"ModelChoiceLiterator","anchor":"modelchoiceiterator","children":[]},{"title":"ModelChoiceLiteratorValue","anchor":"modelchoiceiteratorvalue","children":[]}]}]},{"title":"Réimsí saincheaptha a chur ar","anchor":"creating-custom-fields","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/6.1/ref/"},{"docname":"ref/forms/index","title":"Foirmeacha","url":"/ga/6.1/ref/forms/"}],"prev":{"docname":"ref/forms/api","title":"Na Foirmeacha API","url":"/ga/6.1/ref/forms/api/"},"next":{"docname":"ref/forms/models","title":"Foirmeacha múnla","url":"/ga/6.1/ref/forms/models/"},"formats":{"html":"/ga/6.1/ref/forms/fields/","markdown":"/ga/6.1/ref/forms/fields.md","json":"/ga/6.1/ref/forms/fields.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/ref/forms/fields.txt","official":"https://docs.djangoproject.com/ga/6.1/ref/forms/fields/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}