Django forms zinafanyaje kazi?

Question

Accepted Answer

**Forms** za Django zinashughulikia mzunguko kamili wa input ya mtumiaji: kurender fields za HTML za form, **kuthibitisha (validating)** data iliyowasilishwa, na kuibadilisha kuwa thamani safi za Python. Zinaondoa kazi ya kuchosha na yenye makosa ya kushughulikia input na validation kwa mkono — kipengele kikubwa cha tija na usalama. ## Form ya msingi ```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) ``` Kila form field inatamka aina yake na kanuni za validation. Form inaweza kujirender yenyewe kama HTML na kuthibitisha input dhidi ya kanuni hizo. ## Kushughulikia form katika view (mfumo wa kawaida) ```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}) ``` Methods muhimu: `is_valid()` inaendesha validation, na ikifanikiwa `cleaned_data` inakupa thamani salama, zilizothibitishwa, zilizobadilishwa aina. Ikishindwa, form inahifadhi input na inakusanya ujumbe wa makosa. ## ModelForms — forms kutoka models (DRY) ```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! ``` **ModelForms** zinazalisha form kiotomatiki kutoka kwa fields za model na zinaweza kuhifadhi moja kwa moja kwenye database — zikionyesha DRY (model inaendesha form), zikiondoa boilerplate kwa forms za CRUD. ## Custom validation ```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") ``` ## Kurender na usalama ```html ``` Forms zinaunganishwa na **ulinzi wa CSRF** wa Django (`{% csrf_token %}`) na zinarender fields kiotomatiki pamoja na makosa yao ya validation. ## Kwa nini ni muhimu Forms za Django ni kipengele cha msingi cha kushughulikia input ya mtumiaji kwa usalama na tija — na kushughulikia input kwa usahihi ni jambo lililoenea (karibu kila programu ina forms) na muhimu kwa usalama. Kuelewa forms ni muhimu kwa sababu zinaondoa kazi ya kuchosha na yenye makosa ya kushughulikia input: kurender fields za HTML, **kuthibitisha** data dhidi ya kanuni, kuibadilisha kuwa thamani safi za Python zenye aina (`cleaned_data`), kuhifadhi input na kuonyesha makosa ikishindwa, na kulinda dhidi ya mashambulizi. Kipengele cha validation ni muhimu hasa kwa **usalama na uthabiti** — forms zinahakikisha hauamini kamwe input ghafi ya mtumiaji, zikinasa data isiyofaa au yenye nia mbaya kabla ya kufikia mantiki yako ya biashara. **ModelForms** ni ushindi mkubwa wa tija, zikionyesha DRY kwa kuzalisha forms moja kwa moja kutoka models na kuhifadhi kwenye database kwa code kidogo — zikiondoa boilerplate kwa hali ya kawaida sana ya forms za CRUD. Kujua mfumo wa kawaida wa view (`is_valid()` + `cleaned_data`), jinsi ya kuongeza custom validation ya kiwango cha field na ya cross-field, ModelForms kwa forms zinazoungwa na model, na uunganishaji na **ulinzi wa CSRF** ni jambo la msingi kwa kujenga programu yoyote ya Django inayopokea input ya mtumiaji. Forms zinaunganisha pamoja kushughulikia input, validation, usalama, na tabaka la model, zikifanya kuwa sehemu muhimu na inayotumika mara kwa mara ya framework na sababu kuu ya Django kuwa na tija sana kwa programu zenye kuingiza data nyingi.