{"title":"Réimsí foirm","version":"5.2","locale":"ga","docname":"ref/forms/fields","url":"/ga/5.2/ref/forms/fields/","canonical":"https://djangodocs.dev/ga/5.2/ref/forms/fields/","summary":"class Field Link to this definition # Nuair a chruthaíonn tú rang Foirme , is é an chuid is tábhachtaí ná réimsí na foirme a shainiú. Tá loighic bailíochtaithe…","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

Mar a mhínítear in Foirmeacha a chur amach mar HTML, gintear an lipéad réamhshocraithe le haghaidh Réimse ó ainm na páirce trí gach foscór a thiontú go spásanna agus cás uachtair na chéad litir a chur isteach. Sonraigh lipéad mura mbíonn lipéad imleor mar thoradh ar an iompar réamhshocraithe sin.

\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...     sender = forms.EmailField(help_text="A valid email address, please.")\n...     cc_myself = forms.BooleanField(required=False)\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>Sender:<div class="helptext">A valid email address, please.</div><input type="email" name="sender" required></div>\n<div>Cc myself:<input type="checkbox" name="cc_myself"></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
\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\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

Féach an doiciméadach:class: `Form.has_Changed () `le haghaidh tuilleadh faisnéise.

\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

Roghnach. Ceachtar Fíor nó Bréag. Is é réamhshocraithe True. Sonraíonn sé an gcaithfear comhaid sa suíomh sonraithe a áireamh. Caithfidh ceachtar seo nó: attr: allow_folders a bheith True.

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

Roghnach. Ceachtar Fíor nó Bréag. Is é “False” réamhshocraithe. Sonraíonn sé an gcaithfear fillteáin sa suíomh sonraithe a áireamh. Caithfidh ceachtar seo nó: attr: allow_files a bheith True.

\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
\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: py:class: fo-aicme JSON.JSONEncoder chun cineálacha sonraí nach dtacaíonn an serializer caighdeánach JSON a shraitheadh (m.sh. datetime.datetime` nó:class: ~python: UUID.uuid). Mar shampla, is féidir leat an rang:class: ~django.core.serializers.json.djangojsonEncoder a úsáid.

\n

Réamhshocraithe go JSON.JSONEncoder.

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

A: Py: aicme: fo-aicme JSON.JSONDecoder chun an t-ionchur a dhíshealú. B'fhéidir go gcaithfidh do dhístiriú cuntas a thabhairt ar an bhfíric nach féidir leat a bheith cinnte faoin gcineál ionchuir. Mar shampla, tá an baol agat go bhfaighidh tú datetime a thabhairt ar ais a bhí i ndáiríre ina teaghrán a bhí díreach sa fhormáid chéanna a roghnaíodh do datetime`s.

\n

Is féidir an díchódóir a úsáid chun an t-ionchur a bhailíochtú. Má ardaítear: PY:Class: JSON.JSONDecodeError le linn an díshealaithe, ardófar ValidationError.

\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

Ghlac an scéim le haghaidh URLanna a chuirtear ar fáil gan ceann amháin. Réamhshocraithe go "http". Mar shampla, más é assume_scheme https" agus gurb é "example.com"` an luach a chuirtear ar fáil, is é” https://example.com “``an luach normalaithe.

\n
\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

Tiúpla réimsí a ghlanadh a luachanna agus a gcomhcheanglaítear ina luach amháin ina dhiaidh sin. Glanann gach luach den réimse ag an réimse comhfhreagrach i réimsí `- glanann an chéad luach ag an gcéad réimse, glanann an dara luach ag an dara réimse, srl Nuair a ghlantar gach réimse, déantar liosta na luachanna glan le chéile i luach amháin le: meth: ~ Multivaluefield.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

Tá dhá réimse ar fáil chun caidrimh idir samhlacha a léiriú: :class: ModelChoiceField agus:class: ModelMultipleChoiceField. Teastaíonn paraiméadar queryset amháin ag teastáil ón dá réimse seo a úsáidtear chun na roghanna don réimse a chruthú. Ar bhailíochtú foirme, cuirfidh na réimsí seo réad samhail amháin (i gcás ModelChoiceField`) nó rudaí samhlacha iolracha (i gcás ``ModelMultipleChoiceField) isteach i bhfoclóir cleaned_data na foirme.

\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

De réir réamhshocraithe beidh rogha fol <select>amh ag an ngiuirléid ```` a úsáideann ModelChoiceField ag barr an liosta. Is féidir leat téacs an lipéad seo a athrú (arb é ---------- “ de réir réamhshocraithe) leis an tréith empty_label, nó is féidir leat an lipéad folamh a dhíchumasú go hiomlán trí empty_label a shocrú go ``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
\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/5.2/ref/"},{"docname":"ref/forms/index","title":"Foirmeacha","url":"/ga/5.2/ref/forms/"}],"prev":{"docname":"ref/forms/api","title":"Na Foirmeacha API","url":"/ga/5.2/ref/forms/api/"},"next":{"docname":"ref/forms/models","title":"Foirmeacha múnla","url":"/ga/5.2/ref/forms/models/"},"formats":{"html":"/ga/5.2/ref/forms/fields/","markdown":"/ga/5.2/ref/forms/fields.md","json":"/ga/5.2/ref/forms/fields.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/forms/fields.txt","official":"https://docs.djangoproject.com/ga/5.2/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"]}