Is sraith teastartha é foirmshraith chun oibriú le foirmeacha iolracha ar an leathanach céanna. Is féidir é a bheith is fearr i gcomparáid le greille sonraí. Abair go bhfuil an fhoirm seo a leanas agat:
\n>>> from django import forms\n>>> class ArticleForm(forms.Form):\n... title = forms.CharField()\n... pub_date = forms.DateField()\n...\nB'fhéidir gur mhaith leat ligean don úsáideoir roinnt alt a chruthú ag an am céanna. Chun foirm a chruthú as Airteagal Form déanfaí an méid seo a leanas:
>>> from django.forms import formset_factory\n>>> ArticleFormSet = formset_factory(ArticleForm)\nTá rang formset cruthaithe agat anois darb ainm ArticleFormSet. Tugann an tacar foirmeacha a thaispeáint tugtar an cumas duit athrá a dhéanamh thar na foirmeacha sa tacar foirme agus iad a thaispeáint mar a dhéanfá le foirm rialta:
>>> formset = ArticleFormSet()\n>>> for form in formset:\n... print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></div>\nMar a fheiceann tú ní thaispeánann sé ach foirm folamh amháin. Tá líon na bhfoirmeacha folamh a thaispeántar á rialú ag an bparaiméadar breise. De réir réamhshocraithe, :func: ~django.forms.formsets.formsets.formset_factory sainmhíníonn foirm bhreise amháin; cruthóidh an sampla seo a leanas rang formset chun dhá fhoirm bán a thaispeáint:
>>> ArticleFormSet = formset_factory(ArticleForm, extra=2)\nFormsets can be iterated and indexed, accessing forms in the order they were\ncreated. You can reorder the forms by overriding the default\n__iter__() and __getitem__() methods if needed.\n(For more information on implementing these methods, see the\nPython documentation on sequences.)
Is iad na sonraí tosaigh an rud a spreagann príomh-inúsáidteacht foirmshraith. Mar a thaispeántar thuas is féidir leat líon na bhfoirmeacha breise a shainiú. Is é an rud a chiallaíonn sé seo ná go bhfuil tú ag insint don fhoirm cé mhéad foirm bhreise atá le taispeáint i dteannta leis an líon foirmeacha a ghineann sé ó na sonraí tosaigh. Breathnaímid ar shampla:
\n>>> import datetime\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, extra=2)\n>>> formset = ArticleFormSet(\n... initial=[\n... {\n... "title": "Django is now open source",\n... "pub_date": datetime.date.today(),\n... }\n... ]\n... )\n\n>>> for form in formset:\n... print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" value="Django is now open source" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" value="2023-02-11" id="id_form-0-pub_date"></div>\n<div><label for="id_form-1-title">Title:</label><input type="text" name="form-1-title" id="id_form-1-title"></div>\n<div><label for="id_form-1-pub_date">Pub date:</label><input type="text" name="form-1-pub_date" id="id_form-1-pub_date"></div>\n<div><label for="id_form-2-title">Title:</label><input type="text" name="form-2-title" id="id_form-2-title"></div>\n<div><label for="id_form-2-pub_date">Pub date:</label><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></div>\nTá trí fhoirm san iomlán anois ag taispeáint thuas. Ceann amháin do na sonraí tosaigh a cuireadh isteach agus dhá fhoirm bhreise. Tabhair faoi deara freisin go bhfuilimid ag dul isteach i liosta foclóirí mar na sonraí tosaigh.
\nMá úsáideann tú tosaithe chun tacar foirme a thaispeáint, ba cheart duit an tosaitheach céanna a rith agus tú ag próiseáil aighneacht foirmeacha sin ionas gur féidir leis an tacar foirme a bhrath cé na foirmeacha a d'athraigh an t-úsáideoir. Mar shampla, b'fhéidir go mbeadh rud éigin cosúil le: ArticleFormSet (request.post, initial= [...]).
Tugann an paraiméadar max_num to:func: ~django.forms.formsets.formset_factory an cumas duit líon na bhfoirmeacha a thaispeánfaidh an formset a theorannú:
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, extra=2, max_num=1)\n>>> formset = ArticleFormSet()\n>>> for form in formset:\n... print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></div>\nMá tá luach max_num níos mó ná líon na míreanna atá ann cheana sna sonraí tosaigh, cuirfear foirmeacha bán breise suas le extra leis an tacar foirmeacha, fad nach mbeidh líon iomlán na bhfoirmeacha níos mó ná max_num. Mar shampla, má tá extra=2 agus max_num=2 agus má thosaítear an foirmshraith le mír initial amháin, taispeánfar foirm don mhír tosaigh agus foirm bán amháin.
Má sháraíonn líon na míreanna sna sonraí tosaigh max_num, taispeánfar gach foirm sonraí tosaigh beag beann ar luach max_num agus ní thaispeánfar aon fhoirmeacha breise. Mar shampla, má tá extra=3 agus max_num=1 agus má dhá mhír tosaigh an foirmeach a thosú, taispeánfar dhá fhoirm leis na sonraí tosaigh.
Cuireann luach max_num de None (an réamhshocrú) teorainn ard ar líon na bhfoirmeacha a thaispeántar (1000). Go praiticiúil tá sé seo coibhéiseach le haon teorainn.
By default, max_num only affects how many forms are displayed and does not\naffect validation. If validate_max=True is passed to the\nformset_factory(), then max_num will affect\nvalidation. See bailite_max.
Ceadaíonn an paraiméadar absolute_max to:func: .formset_factory líon na bhfoirmeacha is féidir a dhéanamh a theorannú nuair a sholáthraítear sonraí POST `. Cosnaíonn sé seo i gcoinne ionsaithe ídithe cuimhne ag úsáid iarratais brionnaithe ``POST ``
>>> from django.forms.formsets import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, absolute_max=1500)\n>>> data = {\n... "form-TOTAL_FORMS": "1501",\n... "form-INITIAL_FORMS": "0",\n... }\n>>> formset = ArticleFormSet(data)\n>>> len(formset.forms)\n1500\n>>> formset.is_valid()\nFalse\n>>> formset.non_form_errors()\n['Please submit at most 1000 forms.']\nNuair is é absolute_max None ``, réamhshocraithe é go ``max_num + 1000. (Má tá `max_num None ``, réamhshocraithe é go ``2000).
Má tá absolute_max níos lú ná max_num, ardófar Error lua.
Tá bailíochtú le tacar foirme beagnach comhionann le Foirm ``rialta. Tá modh ``is_valid ar an tacar foirmeacha chun bealach áisiúil a sholáthar chun gach foirm sa tacar foirme a bhailíochtú:
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm)\n>>> data = {\n... "form-TOTAL_FORMS": "1",\n... "form-INITIAL_FORMS": "0",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nTrue\nNíor chuireamar aon sonraí isteach chuig an tacar foirme a bhfuil foirm bhailí mar thoradh air. Tá an tacar foirmeacha cliste go leor chun neamhaird a dhéanamh ar fhoirmeacha breise nár athraíodh. Má sholáthraímid alt neamhbhailí:
\n>>> data = {\n... "form-TOTAL_FORMS": "2",\n... "form-INITIAL_FORMS": "0",\n... "form-0-title": "Test",\n... "form-0-pub_date": "1904-06-16",\n... "form-1-title": "Test",\n... "form-1-pub_date": "", # <-- this date is missing but required\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n>>> formset.errors\n[{}, {'pub_date': ['This field is required.']}]\nMar a fheicimid, is liosta é formset.errors a fhreagraíonn a n-iontrálacha do na foirmeacha sa tacar foirmeacha. Rinneadh bailíochtú do gach ceann den dá fhoirm, agus tá an teachtaireacht earráide ag súil leis le feiceáil don dara mír.
Díreach cosúil le gnáth-Foirm ``á n-úsáid, d'fhéadfadh tréithe HTML mar ``maxlength` a bheith san áireamh i ngach réimse i bhfoirmeacha foirmeacha le haghaidh bailíochtaithe brabhsálaí. Mar sin féin, ní chuimsíonn réimsí foirmeacha foirmeacha an tréith riachtan mar d'fhéadfadh an bailíochtú sin a bheith mícheart agus foirmeacha á gcur leis agus á scriosadh.
Chun a sheiceáil cé mhéad earráid atá sa fhoirmset, is féidir linn an modh total_error_count` a úsáid:
\n>>> # Using the previous example\n>>> formset.errors\n[{}, {'pub_date': ['This field is required.']}]\n>>> len(formset.errors)\n2\n>>> formset.total_error_count()\n1\nIs féidir linn a sheiceáil freisin an bhfuil sonraí foirme difriúil ó na sonraí tosaigh (ie seoladh an fhoirm gan aon sonraí):
\n>>> data = {\n... "form-TOTAL_FORMS": "1",\n... "form-INITIAL_FORMS": "0",\n... "form-0-title": "",\n... "form-0-pub_date": "",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.has_changed()\nFalse\nB'fhéidir gur thug tú faoi deara na sonraí breise (Form-Total_Forms, Form-Initial_Forms`) a bhí ag teastáil i sonraí an fhoirmscair thuas. Tá na sonraí seo ag teastáil don ``Foirm Bainistíochta ``. Úsáideann an tacar foirmeacha seo chun bailiúchán na bhfoirmeacha atá sa tacar foirme a bhainistiú. Mura gcuireann tú na sonraí bainistíochta seo ar fáil, beidh an tacar foirme neamhbhailí:
>>> data = {\n... "form-0-title": "Test",\n... "form-0-pub_date": "",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\nÚsáidtear é chun súil a choinneáil ar cé mhéad cásanna foirme atá á thaispeáint. Má tá foirmeacha nua á chur agat trí JavaScript, ba cheart duit na réimsí comhaireamh san fhoirm seo a mhéadú freisin. Ar an láimh eile, má tá JavaScript á úsáid agat chun rudaí atá ann cheana a scriosadh, ansin ní mór duit a chinntiú go ndéantar na cinn atá á mbaintear marcáilte i gceart lena scriosadh trí Form-#-delete a chur san áireamh sna sonraí POST `. Táthar ag súil go mbeidh gach foirm i láthair sna sonraí `POST ``beag beann.
Tá an fhoirm bhainistíochta ar fáil mar thréith den tacar foirme féin. Agus tacar foirme á rindreáil i dteimpléad, is féidir leat na sonraí bainistíochta go léir a chur san áireamh trí ``{{my_formset.management_form}} `a rindreáil (ainm do thacar foirme a chur in ionad mar is cuí).
\n\ncomhaireann_foirme_iomlán agus comhaireann_foirme_tosaitheLink to this heading#Tá cúpla modh ag BaseFormSet a bhfuil dlúthbhaint acu leis an ManagementForm, total_form_count` agus initial_form_count.
Tugann total_form_count líon iomlán na bhfoirmeacha sa tacar foirme seo ar ais. Tugann initial_form_count líon na bhfoirmeacha sa tacar foirme a rinneadh réamh-líonadh, agus úsáidtear é freisin chun a chinneadh cé mhéad foirm atá ag teastáil. Is dócha nach mbeidh ort riamh ceachtar de na modhanna seo a shárú, mar sin bí cinnte le do thoil go dtuigeann tú cad a dhéanann siad sula ndéanann siad é sin.
foirme_folamLink to this heading#Soláthraíonn BaseFormSet tréith bhreise empty_form a thugann sampla foirme le réimír __prefix__ le húsáid níos éasca i bhfoirmeacha dinimiciúla le JavaScript.
teachtaireachtaí earráidLink to this heading#Ligeann an argóint error_messages duit na teachtaireachtaí réamhshocraithe a ardóidh an foirmset a shárú. Pas isteach i bhfoclóir le heochracha a mheaitseálann leis na teachtaireachtaí earráide is mian leat a shárú. I measc na heochracha teachtaireachta earráide tá `too_few_forms', too_many_forms', agus `missing_management_form'. D'fhéadfadh go mbeadh % (num) d sna teachtaireachtaí earráide `too_few_forms' agus `too_many_forms', agus max_num, ina gcuirfear min_num` agus max_num in ionad min_num faoi seach.
Mar shampla, seo an teachtaireacht earráide réamhshocraithe nuair a bhíonn an fhoirm bhainistíochta in easnamh:
\n>>> formset = ArticleFormSet({})\n>>> formset.is_valid()\nFalse\n>>> formset.non_form_errors()\n['ManagementForm data is missing or has been tampered with. Missing fields: form-TOTAL_FORMS, form-INITIAL_FORMS. You may need to file a bug report if the issue persists.']\nAgus seo teachtaireacht earráide saincheaptha:
\n>>> formset = ArticleFormSet(\n... {}, error_messages={"missing_management_form": "Sorry, something went wrong."}\n... )\n>>> formset.is_valid()\nFalse\n>>> formset.non_form_errors()\n['Sorry, something went wrong.']\nTá modh glan ``ag tacar foirme cosúil leis an gceann ar rang ``Foirme. Seo an áit a shainmhíníonn tú do bhailíochtú féin a oibríonn ag an leibhéal foirmset:
>>> from django.core.exceptions import ValidationError\n>>> from django.forms import BaseFormSet\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n\n>>> class BaseArticleFormSet(BaseFormSet):\n... def clean(self):\n... """Checks that no two articles have the same title."""\n... if any(self.errors):\n... # Don't bother validating the formset unless each form is valid on its own\n... return\n... titles = set()\n... for form in self.forms:\n... if self.can_delete and self._should_delete_form(form):\n... continue\n... title = form.cleaned_data.get("title")\n... if title in titles:\n... raise ValidationError("Articles in a set must have distinct titles.")\n... titles.add(title)\n...\n\n>>> ArticleFormSet = formset_factory(ArticleForm, formset=BaseArticleFormSet)\n>>> data = {\n... "form-TOTAL_FORMS": "2",\n... "form-INITIAL_FORMS": "0",\n... "form-0-title": "Test",\n... "form-0-pub_date": "1904-06-16",\n... "form-1-title": "Test",\n... "form-1-pub_date": "1912-06-23",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n>>> formset.errors\n[{}, {}]\n>>> formset.non_form_errors()\n['Articles in a set must have distinct titles.']\nTugtar ar an modh clean ``foirmeacha tar éis na modhanna ``Form.clean go léir a ghlaoch. Faighfear na hearráidí ag baint úsáide as an modh ``non_form_errors () ``ar an tacar foirme.
Déanfar earráidí neamh-fhoirme a thabhairt le aicme breise de neamhfhoirme chun cabhrú leo a idirdhealú ó earráidí foirm-shonracha. Mar shampla, bheadh cuma ``{{formset.non_form_errors}} `:
<ul class="errorlist nonform">\n <li>Articles in a set must have distinct titles.</li>\n</ul>\nSoláthraíonn Django cúpla bealach chun líon íosta nó uasta na bhfoirmeacha curtha isteach a bhailíochtú. Ba cheart d'iarratais a dteastaíonn bailíochtú níos inúsáidte uathu ar líon na bhfoirmeacha bailíochtú saincheaptha
\nbailite_maxLink to this heading#Má chuirtear validate_max=True chuig: :func: ~django.forms.formsets.formset_factory, seiceálfaidh bailíochtú freisin go bhfuil líon na bhfoirmeacha sa tacar sonraí, lúide iad siúd atá marcáilte le scriosadh, níos lú ná ``max_`num` nó cothrom le max_`num.
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, max_num=1, validate_max=True)\n>>> data = {\n... "form-TOTAL_FORMS": "2",\n... "form-INITIAL_FORMS": "0",\n... "form-0-title": "Test",\n... "form-0-pub_date": "1904-06-16",\n... "form-1-title": "Test 2",\n... "form-1-pub_date": "1912-06-23",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n>>> formset.errors\n[{}, {}]\n>>> formset.non_form_errors()\n['Please submit at most 1 form.']\nvalidate_max=Bailíonn True i gcoinne max_num go docht fiú má sháraíodh max_num toisc go raibh méid na sonraí tosaigh a sholáthraíodh iomarcach.
Is féidir an teachtaireacht earráide a shaincheapadh tríd an teachtaireacht ``too_many_forms' a chur chuig an argóint:ref: formsets-error-messages.
\n\nbailate_minLink to this heading#Má chuirtear validate_min=True chuig: :func: ~django.forms.formsets.formset_factory, seiceálfaidh bailíochtú freisin go bhfuil líon na bhfoirmeacha sa tacar sonraí, lúide iad siúd atá marcáilte le scriosadh, níos mó ná ``min_`num` nó cothrom le min_`num.
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, min_num=3, validate_min=True)\n>>> data = {\n... "form-TOTAL_FORMS": "2",\n... "form-INITIAL_FORMS": "0",\n... "form-0-title": "Test",\n... "form-0-pub_date": "1904-06-16",\n... "form-1-title": "Test 2",\n... "form-1-pub_date": "1912-06-23",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n>>> formset.errors\n[{}, {}]\n>>> formset.non_form_errors()\n['Please submit at least 3 forms.']\nIs féidir an teachtaireacht earráide a shaincheapadh tríd an teachtaireacht ``too_few_forms' a chur chuig argóint:ref: formsets-error-messages.
\n\nSoláthraíonn an: Func: ~django.forms.formsets.formset_factory dhá pharaiméadar roghnach can_order agus can_delete chun cabhrú le foirmeacha a ordú i bhfoirmeacha agus foirmeacha a scriosadh ó fhoirmshraith.
Réamhshocraithe: Fréag
Ligeann duit tacar foirme a chruthú leis an gcumas a ordú:
\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, can_order=True)\n>>> formset = ArticleFormSet(\n... initial=[\n... {"title": "Article #1", "pub_date": datetime.date(2008, 5, 10)},\n... {"title": "Article #2", "pub_date": datetime.date(2008, 5, 11)},\n... ]\n... )\n>>> for form in formset:\n... print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" value="Article #1" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" value="2008-05-10" id="id_form-0-pub_date"></div>\n<div><label for="id_form-0-ORDER">Order:</label><input type="number" name="form-0-ORDER" value="1" id="id_form-0-ORDER"></div>\n<div><label for="id_form-1-title">Title:</label><input type="text" name="form-1-title" value="Article #2" id="id_form-1-title"></div>\n<div><label for="id_form-1-pub_date">Pub date:</label><input type="text" name="form-1-pub_date" value="2008-05-11" id="id_form-1-pub_date"></div>\n<div><label for="id_form-1-ORDER">Order:</label><input type="number" name="form-1-ORDER" value="2" id="id_form-1-ORDER"></div>\n<div><label for="id_form-2-title">Title:</label><input type="text" name="form-2-title" id="id_form-2-title"></div>\n<div><label for="id_form-2-pub_date">Pub date:</label><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></div>\n<div><label for="id_form-2-ORDER">Order:</label><input type="number" name="form-2-ORDER" id="id_form-2-ORDER"></div>\nCuireann sé seo réimse breise le gach foirm. Ainmnítear ORDER ar an réimse nua seo agus is Forms.IntegerField é. Maidir leis na foirmeacha a tháinig ó na sonraí tosaigh sé luach uimhriúil dóibh go huathoibríoch. Breathnaímid ar cad a tharlóidh nuair a athraíonn an t-úsáideoir na luachanna seo:
>>> data = {\n... "form-TOTAL_FORMS": "3",\n... "form-INITIAL_FORMS": "2",\n... "form-0-title": "Article #1",\n... "form-0-pub_date": "2008-05-10",\n... "form-0-ORDER": "2",\n... "form-1-title": "Article #2",\n... "form-1-pub_date": "2008-05-11",\n... "form-1-ORDER": "1",\n... "form-2-title": "Article #3",\n... "form-2-pub_date": "2008-05-01",\n... "form-2-ORDER": "0",\n... }\n\n>>> formset = ArticleFormSet(\n... data,\n... initial=[\n... {"title": "Article #1", "pub_date": datetime.date(2008, 5, 10)},\n... {"title": "Article #2", "pub_date": datetime.date(2008, 5, 11)},\n... ],\n... )\n>>> for form in formset.ordered_forms:\n... print(form.cleaned_data)\n...\n{'title': 'Article #3', 'pub_date': datetime.date(2008, 5, 1), 'ORDER': 0}\n{'title': 'Article #2', 'pub_date': datetime.date(2008, 5, 11), 'ORDER': 1}\n{'title': 'Article #1', 'pub_date': datetime.date(2008, 5, 10), 'ORDER': 2}\nBaseFormSet also provides an\nordering_widget attribute and\nget_ordering_widget() method that\ncontrol the widget used with\ncan_order.
ording_widgetLink to this heading#Réamhshocraithe: :class: ~django.forms.numberInput
\nSocraigh ordering_widget chun an rang giuirléid atá le húsáid le can_order a shonrú:
>>> from django.forms import BaseFormSet, formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n... ordering_widget = HiddenInput\n...\n\n>>> ArticleFormSet = formset_factory(\n... ArticleForm, formset=BaseArticleFormSet, can_order=True\n... )\nfaigh_ording_widgetLink to this heading#Athraigh get_ordering_widget () ``más gá duit sampla giuirléid a sholáthar le húsáid le ``can_order:
>>> from django.forms import BaseFormSet, formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n... def get_ordering_widget(self):\n... return HiddenInput(attrs={"class": "ordering"})\n...\n\n>>> ArticleFormSet = formset_factory(\n... ArticleForm, formset=BaseArticleFormSet, can_order=True\n... )\n`is féidir _scriosaLink to this heading#Réamhshocraithe: Fréag
Ligeann duit tacar foirme a chruthú leis an gcumas foirmeacha a roghnú le scriosadh:
\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, can_delete=True)\n>>> formset = ArticleFormSet(\n... initial=[\n... {"title": "Article #1", "pub_date": datetime.date(2008, 5, 10)},\n... {"title": "Article #2", "pub_date": datetime.date(2008, 5, 11)},\n... ]\n... )\n>>> for form in formset:\n... print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" value="Article #1" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" value="2008-05-10" id="id_form-0-pub_date"></div>\n<div><label for="id_form-0-DELETE">Delete:</label><input type="checkbox" name="form-0-DELETE" id="id_form-0-DELETE"></div>\n<div><label for="id_form-1-title">Title:</label><input type="text" name="form-1-title" value="Article #2" id="id_form-1-title"></div>\n<div><label for="id_form-1-pub_date">Pub date:</label><input type="text" name="form-1-pub_date" value="2008-05-11" id="id_form-1-pub_date"></div>\n<div><label for="id_form-1-DELETE">Delete:</label><input type="checkbox" name="form-1-DELETE" id="id_form-1-DELETE"></div>\n<div><label for="id_form-2-title">Title:</label><input type="text" name="form-2-title" id="id_form-2-title"></div>\n<div><label for="id_form-2-pub_date">Pub date:</label><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></div>\n<div><label for="id_form-2-DELETE">Delete:</label><input type="checkbox" name="form-2-DELETE" id="id_form-2-DELETE"></div>\nCosúil le can_order cuireann sé seo réimse nua le gach foirm darb ainm DELETE agus is Forms.BooleanField é. Nuair a thagann sonraí trí aon cheann de na réimsí scriosta a mharcáil is féidir leat rochtain a fháil orthu le deleted_forms`:
>>> data = {\n... "form-TOTAL_FORMS": "3",\n... "form-INITIAL_FORMS": "2",\n... "form-0-title": "Article #1",\n... "form-0-pub_date": "2008-05-10",\n... "form-0-DELETE": "on",\n... "form-1-title": "Article #2",\n... "form-1-pub_date": "2008-05-11",\n... "form-1-DELETE": "",\n... "form-2-title": "",\n... "form-2-pub_date": "",\n... "form-2-DELETE": "",\n... }\n\n>>> formset = ArticleFormSet(\n... data,\n... initial=[\n... {"title": "Article #1", "pub_date": datetime.date(2008, 5, 10)},\n... {"title": "Article #2", "pub_date": datetime.date(2008, 5, 11)},\n... ],\n... )\n>>> [form.cleaned_data for form in formset.deleted_forms]\n[{'title': 'Article #1', 'pub_date': datetime.date(2008, 5, 10), 'DELETE': True}]\nMá tá a: class: ModelFormSet <django.forms.models.BaseModelFormSet>`á úsáid agat, scriosfar cásanna samhail d'fhoirmeacha scriosta nuair a ghlaonn tú ar ``formset.save () `.
\nIf you call formset.save(commit=False), objects will not be deleted\nautomatically. You'll need to call delete() on each of the\nformset.deleted_objects to actually delete\nthem:
>>> instances = formset.save(commit=False)\n>>> for obj in formset.deleted_objects:\n... obj.delete()\n...\nAr an láimh eile, má tá simplí formSet ``á úsáid agat, is fútsa atá sé `formset.deleted_forms a láimhseáil, b'fhéidir i modh save ()` do fhoirmset, mar níl aon smaoineamh ginearálta ann faoi cad a chiallaíonn sé foirm a scriosadh.
BaseFormSet also provides a\ndeletion_widget attribute and\nget_deletion_widget() method that\ncontrol the widget used with\ncan_delete.
scrios_widgetLink to this heading#Réamhshocraithe: :class: ~django.forms.checkboxInput
\nSocraigh deletion_widget chun an rang giuirléid atá le húsáid le can_delete a shonrú:
>>> from django.forms import BaseFormSet, formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n... deletion_widget = HiddenInput\n...\n\n>>> ArticleFormSet = formset_factory(\n... ArticleForm, formset=BaseArticleFormSet, can_delete=True\n... )\nfaigh_scrios_widgetLink to this heading#Athraigh get_deletion_widget () ``más gá duit sampla giuirléid a sholáthar le húsáid le ``can_delete:
>>> from django.forms import BaseFormSet, formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n... def get_deletion_widget(self):\n... return HiddenInput(attrs={"class": "deletion"})\n...\n\n>>> ArticleFormSet = formset_factory(\n... ArticleForm, formset=BaseArticleFormSet, can_delete=True\n... )\n`is féidir _scrios_breiseLink to this heading#Réamhshocraithe: ``Fíor`
\nAgus tú ag socrú can_delete=True, bainfear an rogha chun foirmeacha breise a scriosadh can_delete_extra=false a shonrú.
Más gá duit réimsí breise a chur leis an tacar foirme is féidir é seo a chur i gcrích go héasca. Soláthraíonn an bunaicme foirmset modh add_fields. Is féidir leat an modh seo a shárú chun do réimsí féin a chur leis nó fiú réimsí réamhshocraithe/tréithe na réimsí ordaithe agus scriostha a athshainiú:
>>> from django.forms import BaseFormSet\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n... def add_fields(self, form, index):\n... super().add_fields(form, index)\n... form.fields["my_field"] = forms.CharField()\n...\n\n>>> ArticleFormSet = formset_factory(ArticleForm, formset=BaseArticleFormSet)\n>>> formset = ArticleFormSet()\n>>> for form in formset:\n... print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></div>\n<div><label for="id_form-0-my_field">My field:</label><input type="text" name="form-0-my_field" id="id_form-0-my_field"></div>\nUaireanta glacann do rang foirme paraiméadair saincheaptha, cosúil le ``MyArticleForm ``. Is féidir leat an paraiméadar seo a rith agus an tacar foirmeacha á gcur isteach agat:
\n>>> from django.forms import BaseFormSet\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n\n>>> class MyArticleForm(ArticleForm):\n... def __init__(self, *args, user, **kwargs):\n... self.user = user\n... super().__init__(*args, **kwargs)\n...\n\n>>> ArticleFormSet = formset_factory(MyArticleForm)\n>>> formset = ArticleFormSet(form_kwargs={"user": request.user})\nFéadfaidh an form_kwargs ag brath ar an gcás foirme shonrach freisin. Soláthraíonn an bunaicme formset modh get_form_kwargs. Tógann an modh argóint amháin - innéacs na foirme sa tacar foirme. Is é None an t-innéacs fao:ref: empty_form:
>>> from django.forms import BaseFormSet\n>>> from django.forms import formset_factory\n\n>>> class BaseArticleFormSet(BaseFormSet):\n... def get_form_kwargs(self, index):\n... kwargs = super().get_form_kwargs(index)\n... kwargs["custom_kwarg"] = index\n... return kwargs\n...\n\n>>> ArticleFormSet = formset_factory(MyArticleForm, formset=BaseArticleFormSet)\n>>> formset = ArticleFormSet()\nSa HTML rindreáilte, cuimsíonn foirmeacha réimír ar ainm gach réimse. De réir réamhshocraithe, is é foirm an réimír, ach is féidir é a shaincheapadh ag baint úsáide as argóint prefix an fhoirmshraith.
Mar shampla, sa chás réamhshocraithe, b'fhéidir go bhfeicfidh tú:
\n<label for="id_form-0-title">Title:</label>\n<input type="text" name="form-0-title" id="id_form-0-title">\nAch le ``ArticleFormSet (prefix='article') ``éiríonn sé sin:
\n<label for="id_article-0-title">Title:</label>\n<input type="text" name="article-0-title" id="id_article-0-title">\n<multiple-formsets-in-view>Tá sé seo úsáideach más mian leat: ref: `úsáid níos mó ná tacar foirme amháin i radharc `.
\nTá na tréithe agus na modhanna seo a leanas ag foirmeacha a bhaineann le rindreáil:
\nSonraíonn sé an: doc: renderer </ref/forms/renderers> le húsáid don fhoirmshraith. Réamhshocraithe don rindeoir a shonraítear leis an socrú: setting: FORM_RENDER.
\nAinm an teimpléid a rinneadh má theilgtear an tacar foirme isteach i sreang, m.sh. trí print (formset) ``nó i dteimpléad trí {{formset}} ``.
De réir réamhshocraithe, maoin ag filleadh luach an renderer's:attr: ~django.forms.renderers.baserenderer.formset_template_name. Féadfaidh tú é a shocrú mar ainm teimpléad teaghrán d'fhonn é sin a shárú d'aicme foirmeacha áirithe.
\nÚsáidfear an teimpléad seo chun foirm bhainistíochta an fhoirmeacha a léiriú, agus ansin gach foirm sa tacar foirme de réir an teimpléid atá sainmhínithe ag an bhfoirm 's:attr: ~django.forms.form.template_name.
\nAinm an teimpléid a úsáidtear agus tú ag glaoch: meth: .as_div. De réir réamhshocraithe is é seo ” django/forms/formsets/div.html “. Déanann an teimpléad seo foirm bhainistíochta an fhoirm agus ansin gach foirm sa tacar foirme de réir an mhodh foirme's:meth: ~django.forms.form.as_div.
Ainm an teimpléid a úsáidtear agus tú ag glaoch: meth: .as_p. De réir réamhshocraithe is é seo ” django/forms/formsets/p.html “. Déanann an teimpléad seo foirm bhainistíochta an fhoirm agus ansin gach foirm sa tacar foirme de réir an mhodh foirme's:meth: ~django.forms.form.as_p.
Ainm an teimpléid a úsáidtear agus tú ag glaoch: meth: .as_table. De réir réamhshocraithe is é seo ” django/forms/formsets/table.html “. Déanann an teimpléad seo foirm bhainistíochta an fhoirm agus ansin gach foirm sa tacar foirme de réir an mhodh foirme's:meth: ~django.forms.form.as_table.
Ainm an teimpléid a úsáidtear agus tú ag glaoch: meth: .as_ul. De réir réamhshocraithe is é seo ” django/forms/formsets/ul.html “. Déanann an teimpléad seo foirm bhainistíochta an fhoirm agus ansin gach foirm sa tacar foirme de réir an mhodh foirme's:meth: ~django.forms.form.as_ul.
Tugann sé an comhthéacs ar ais chun tacar foirme a rindreáil i dteimpléad.
\nIs é an comhthéacs atá ar fáil:
\nformset: An sampla den fhoirmset.
Tugtar __str__ ar an modh rindreála chomh maith leis na modhanna: meth: .as_div, :meth: .as_p, :meth: .as_ul, agus:meth: .as_table. Tá na hargóintí go léir roghnach agus beidh siad réamhshocraithe:
ainmne_teimpléad: :attr: .template_ainm
context: Luach ar ais ag: meth: .get_context
renderer: Luach ar ais ar:attr: .renderer
Déanann sé an tacar foirme leis an teimpléad:attr: `.template_name_div.
\nDéanann sé an tacar foirme leis an teimpléad:attr: .template_name_p.
\nDéanann sé an tacar foirme leis an teimpléad:attr: .template_name_table.
\nDéanann sé an tacar foirme leis an teimpléad:attr: .template_name_ul.
\nNíl sé an-difriúil le tacar foirme a úsáid taobh istigh de radharc ó rang rialta Foirme a úsáid. Is é an t-aon rud a theastaíonn uait a bheith ar an eolas faoi ná a chinntiú go n-úsáidtear an fhoirm bhainistíochta taobh istigh den teimpléad. Breathnaímid ar radharc samplach:
from django.forms import formset_factory\nfrom django.shortcuts import render\nfrom myapp.forms import ArticleForm\n\n\ndef manage_articles(request):\n ArticleFormSet = formset_factory(ArticleForm)\n if request.method == "POST":\n formset = ArticleFormSet(request.POST, request.FILES)\n if formset.is_valid():\n # do something with the formset.cleaned_data\n pass\n else:\n formset = ArticleFormSet()\n return render(request, "manage_articles.html", {"formset": formset})\nD'fhéadfadh cuma seo a bheith ar an teimpléad manage_articles.html`:
\n<form method="post">\n {{ formset.management_form }}\n <table>\n {% for form in formset %}\n {{ form }}\n {% endfor %}\n </table>\n</form>\nMar sin féin tá aicearra beag ann don méid thuas trí ligean don fhoirmscar féin déileáil leis an bhfoirm bhainistíochta:
\n<form method="post">\n <table>\n {{ formset }}\n </table>\n</form>\nCríochnaíonn an méid thuas ag glaoch ar an modh: meth: BaseFormSet.render ar an rang formset. Déanann sé seo an tacar foirme ag baint úsáide as an teimpléad a shonraítear leis an tréith: attr: ~BaseFormSet.Template_Name. Cosúil le foirmeacha, de réir réamhshocraithe déanfar an tacar foirme as_div, agus modhanna cúntóra eile as_p, as_ul`, agus as_table ar fáil. <overriding-built-in-formset-templates>Is féidir rindreáil an fhoirmshraith a shaincheapadh tríd an tréith template_name a shonrú, nó níos ginearálta trí:ref: `an teimpléad réamhshocraithe a shárú `.
can_delete agus can_orderLink to this heading#Má rindeann tú réimsí de láimh sa teimpléad, is féidir leat paraiméadar can_delete a rinneadh le {{form.Delete}}:
<form method="post">\n {{ formset.management_form }}\n {% for form in formset %}\n <ul>\n <li>{{ form.title }}</li>\n <li>{{ form.pub_date }}</li>\n {% if formset.can_delete %}\n <li>{{ form.DELETE }}</li>\n {% endif %}\n </ul>\n {% endfor %}\n</form>\nAr an gcaoi chéanna, má tá sé de chumas ag an bhfoirm ordú (can_order=true), is féidir é a rinneadh le {{form.order}}.
Tá tú in ann níos mó ná tacar foirme amháin a úsáid i radharc más mian leat. Tá foirmeacha ar iasacht cuid mhaith dá iompar ó fhoirmeacha. Agus é sin ráite tá tú in ann prefix a úsáid chun ainmneacha réimse foirmeacha foirmeacha a bhfuil luach ar leith acu chun ligean níos mó ná tacar foirme amháin a sheoladh chuig amharc gan ainmneacha a chomhrac. Breathnaímid ar an gcaoi a bhféadfaí é seo a chur i gcrích:
from django.forms import formset_factory\nfrom django.shortcuts import render\nfrom myapp.forms import ArticleForm, BookForm\n\n\ndef manage_articles(request):\n ArticleFormSet = formset_factory(ArticleForm)\n BookFormSet = formset_factory(BookForm)\n if request.method == "POST":\n article_formset = ArticleFormSet(request.POST, request.FILES, prefix="articles")\n book_formset = BookFormSet(request.POST, request.FILES, prefix="books")\n if article_formset.is_valid() and book_formset.is_valid():\n # do something with the cleaned_data on the formsets.\n pass\n else:\n article_formset = ArticleFormSet(prefix="articles")\n book_formset = BookFormSet(prefix="books")\n return render(\n request,\n "manage_articles.html",\n {\n "article_formset": article_formset,\n "book_formset": book_formset,\n },\n )\nAnsin déanfá na foirmeacha a rinneadh mar is gnách. Tá sé tábhachtach a chur in iúl gur gá duit ``prefix` a rith ar na cásanna POST agus neamh-POST araon ionas go ndéanfar é a léiriú agus a phróiseáil i gceart.
\nCuireann gach formset's:ref: réimír `in ionad an réimír réamh <formset-prefix>shocraithe ``foirm ``a chuirtear le tréithe HTML ``ainm` agus id` gach réimse.
\n