Conas a oibríonn foirmeacha Django?

Question

Accepted Answer

Láimhseálann foirmeacha **Django** saolré iomlán ionchur úsáideora: réimsí foirm HTML a ghealadh, sonraí a chuirtear faoi bhráistint a **bhailíochtú**, agus é a thiontú go fíorluachanna Python glan. Baineanns siad úsáid fhada, socarantas earráide-bhocht an láimhdhála ionchur agus an bhailíochtaithe dhíobhála — gné dhúbhaile a dhéileálann le táirgiúlacht agus slándáil. ## Foirm bhunúsach ```python from django import forms class ContactForm(forms.Form): name = forms.CharField(max_length=100) email = forms.EmailField() # validates email format age = forms.IntegerField(min_value=0, required=False) message = forms.CharField(widget=forms.Textarea) ``` Dearbhaíonn gach réimse foirm a chineál agus a rialacha bailíochtaithe. Is féidir leis an bhfoirm a thabhairt ó féin mar HTML agus ionchur a bhailíochtú i gcoinne na rialacha sin. ## Foirm a láimhseáil i bhfíseán (an patrún caighdeánach) ```python def contact(request): if request.method == "POST": form = ContactForm(request.POST) # bind submitted data if form.is_valid(): # run validation # cleaned_data = validated, type-converted Python values name = form.cleaned_data["name"] send_email(form.cleaned_data) return redirect("success") else: form = ContactForm() # empty form for GET return render(request, "contact.html", {"form": form}) ``` Na príomhphróisis: rithíonn `is_valid()` an bhailíochtú, agus ar rath `cleaned_data` tugann sé sláindáinte, bailíochtaithe, luachanna a bhogadh go cineál duit. Ar fhailliú, coinníonn an fhoirm an t-ionchur agus baileann sé teachtaireachtaí earráide. ## ModelForms — foirmeacha ó mhúnlaí (TIRIM) ```python from django.forms import ModelForm class ArticleForm(ModelForm): class Meta: model = Article # build the form FROM a model fields = ["title", "body", "published"] # which fields to include # ModelForm can SAVE directly to the database def create(request): form = ArticleForm(request.POST) if form.is_valid(): form.save() # creates/updates the model instance! ``` **Ghabhann ModelForms** foirm go huathoibríoch ó réimsí an mhúnlain agus is féidir léi a shábháil go díreach i ndiail — ag cur i bhfeidhm TIRIM (an múnla a thiomáineann an fhoirm), ag foluain bhoipleite do fhoirmeacha CRUD. ## Bailíochtú saincheaptha ```python class SignupForm(forms.Form): password = forms.CharField() confirm = forms.CharField() def clean_password(self): # field-level validation pw = self.cleaned_data["password"] if len(pw) < 8: raise forms.ValidationError("Too short") return pw def clean(self): # form-level (cross-field) validation data = super().clean() if data.get("password") != data.get("confirm"): raise forms.ValidationError("Passwords don't match") ``` ## Soláthar agus slándáil ```html ``` Ghabhann foirmeacha isteach le **cosaint CSRF** Django (`{% csrf_token %}`) agus eolaítear réimsí go huathoibríoch le hearráidí bailíochtaithe. ## Cén fáth a bhfuil sé tábhachtach Is gné bhunúsach de Django iad foirmeacha chun ionchur úsáideora a láimhseáil go sábháilte agus go táirgiúil — agus tá láimhseáil ionchur i gceart an dá rud: forleathan (beagnach gach aip a bhfuil foirmeacha aici) agus gábh-bharúil slándála. Is gá tuiscint ar fhoirmeacha a bheith ann toisc go bhfuil siad ag dul i bhfeidhm ar an obair socarantas, earráide-bhocht ionchur láimhdhála: réimsí foirm HTML a thabhairt, sonraí a **bhailíochtú** i gcoinne rialacha, tiontú go fíorluachanna Python glan a bhailíochtú (`cleaned_data`), ionchur a chaomhnú agus earráidí a chuir ar fáil ar fhailliú, agus cosaint i gcoinne ionsaithe. Tá an ghné bhailíochtaithe i gceist go háirithe ann don **tslándáil agus don chruas** — cinntíonn foirmeacha go bhfuil tú i gcónaí ag géilleadh ionchur úsáideora raw, ag gabháil le sonraí míchumtha nó olc a smaoineamh sular sroicheanns sé d'loighic gnó. **Is ModelForms** an bhuaidh táirgiúlachta mór, ag cur i bhfeidhm TIRIM a ghabhann foirmeacha go díreach ó mhúnlaí agus a shábhálann i ndiail le cód íosta — ag foluain bhoipleite do an chás an-coitianta de fhoirmeacha CRUD. An patrún físeáin caighdeánach a bheith ar eolas (is_valid()` + `cleaned_data`), conas bailíochtú saincheaptha réimse-leibhéal agus trasréimse a chur leis, ModelForms le haghaidh foirmeacha múnla-dhroim, agus an t-idirghníomhú le **cosaint CSRF** tá bunúsach do thógáil aon iarratas Django a nglacann ionchur úsáideora. Bhí foirmeacha ag ceangal le chéile ionchur-láimhseáil, bailíochtú, slándáil, agus an ciseal múnla, agus iad a dhéanamh ina chuid thábhachtach, minic-úsáide den chreat agus príomhchúis ar a laghad Django atá chomh táirgiúil do iarratasanna a bhfuil iontráil sonraí-dhubhach acu.